夜雨聆风
OpenClaw 是一个在您自己设备上运行的个人 AI 助手，可以连接到各种消息平台，支持通过 GLM Coding Plan 等渠道配置使用智谱的 GLM 模型。以下是基于最新官方文档的完整安装指南。
一、部署前准备
1.1 系统与硬件要求
操作系统：Windows 10/11（64位）、macOS 12+、Linux（Ubuntu 22.04+/Debian 11+） 最低配置：2核CPU、4GB内存、10GB可用磁盘空间 推荐配置：4核CPU、8GB内存、40GB+ NVMe存储
1.2 核心依赖安装
**Node.js 22+**：必须安装22.x LTS或更高版本
Windows：使用nvm-windows管理 macOS/Linux：使用nvm或brew安装 验证命令： node --version升级方法： Git：用于代码克隆和版本控制
API密钥：准备大模型服务商的API Key（如MiniMax、Kimi、OpenAI、Claude等）
二、Windows系统部署（两种方案）
2.1 方案A：原生PowerShell一键安装（新手首选）
以管理员身份打开PowerShell 解锁脚本执行权限： Set-ExecutionPolicy RemoteSigned -Scope CurrentUser执行一键安装命令（自动安装Node.js和依赖）： iwr -useb https://openclaw.ai/install.ps1 | iex验证安装： openclaw --version
2.2 方案B：WSL2 + Ubuntu（官方推荐，更稳定）
安装WSL2： wsl --install重启电脑后，安装Ubuntu： wsl --install -d Ubuntu在Ubuntu终端中执行： curl -fsSL https://openclaw.ai/install.sh | bash验证安装： openclaw --version
三、macOS系统部署
安装Homebrew（包管理器）： /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装依赖： brew install node@22 git安装OpenClaw： npm install -g openclaw@latest --registry=https://registry.npmmirror.com验证安装： openclaw --version
四、Linux/云服务器部署
4.1 基础环境配置
# Ubuntu/Debian系统更新sudo apt update && sudo apt upgrade -y# 安装核心依赖sudo apt install curl git npm python3-pip docker.io -y# 升级Node.js至22.0.0sudo npm install -g n && sudo n 22.0.0# 配置npm国内镜像npm config set registry https://registry.npmmirror.com4.2 一键安装OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git4.3 设置开机自启
sudo systemctl enable openclawsudo systemctl start openclaw五、Docker部署（服务器/隔离环境首选）
安装Docker并启动服务 创建配置文件夹： mkdir -p ~/openclaw && cd ~/openclaw拉取最新镜像并运行： docker run -d --name openclaw-core -p 18789:18789 -v $(pwd):/data openclaw/openclaw验证容器状态： docker ps
六、手机端部署（安卓/鸿蒙）
6.1 APK直装（零基础首选）
下载正版APK：访问OpenClaw官方GitHub仓库，在"Releases"栏目下载"Android v2026.3.8"安装包 授权安装：选择"仅本次允许"未知来源应用 初始化配置：打开龙虾AI，选择"本地运行模式"，关闭"公网访问"开关 权限设置：仅开启"悬浮窗、后台运行、通知"三大基础权限
6.2 Termux进阶部署（功能更全）
适合6GB内存以上手机，可自定义复杂任务、安装官方插件。
七、初始化配置向导
安装完成后，执行配置向导：
openclaw onboard --install-daemon7.1 配置流程详解
7.2 启动服务
# 启动网关服务openclaw gateway start# 打开Web控制台openclaw dashboard# 或直接访问http://localhost:18789八、接入飞书（国内用户推荐）
8.1 创建飞书应用
访问飞书开放平台，创建新应用 记录App ID和App Secret备用
8.2 安装飞书插件
# 安装飞书插件按照插件说明文档执行安装命令# 修改配置文件 ~/.openclaw/openclaw.json"channels": {"feishu": {"enabled": true,"appId": "你的App ID","appSecret": "你的App Secret","domain": "feishu","connectionMode": "websocket" }}8.3 配置飞书应用权限
开启机器人能力 开通相关消息权限 订阅事件：选择"长连接"方式 创建版本并发布
九、必备技能（Skills）安装
技能是OpenClaw的能力插件，安装命令：
npx clawhub@latest install <技能名>9.1 2026年新手必备技能
Agent Browser：核心必装，赋予浏览器操作能力 Tavily Web Search：联网搜索大脑，避免AI信息滞后 skill-vetter：安全守门员，审计第三方技能安全性 self-improving-agent：内置记忆与优化机制 summarize：网页、文档快速总结工具
十、常见问题解决
10.1 Windows环境问题
配置向导按回车无反应：用方向键选中选项，按空格打勾，再按回车 Gateway服务启动失败：放弃系统服务方式，手动启动： openclaw gateway run # 保持窗口打开openclaw dashboard # 新开窗口启动仪表盘
10.2 端口冲突
# 检查端口占用sudo netstat -tuln | grep 18789# 终止占用进程sudo kill -9 <进程ID># 或修改OpenClaw配置文件更换端口10.3 对接本地Ollama模型
修改配置文件 ~/.openclaw/openclaw.json：
"model": {"provider": "openai","name": "llama3","apiBase": "http://localhost:11434/v1","apiKey": "ollama-local"}十一、维护与升级
11.1 常用命令
# 检查服务状态openclaw gateway status# 查看运行日志openclaw logs follow# 运行诊断检查openclaw doctor# 升级到最新版本npm install -g openclaw@latest11.2 安全建议
仅开启必要权限，敏感权限一律关闭 关闭"公网访问"开关，避免远程控制风险 定期更新系统和应用安全补丁 重要数据保留3份备份
十二、云服务部署方案
12.1 阿里云部署（五种方案）
轻量云服务器部署：购买轻量应用服务器并安装OpenClaw镜像 无影云电脑企业版：内置OpenClaw便捷配置页及Skill平台 无影云电脑个人版：一键部署镜像，预装Linux环境 无影AgentBay部署：通过SDK快速集成 云服务器ECS部署：通过计算巢社区版部署
12.2 腾讯云轻量应用服务器
提供预装环境，支持一键部署OpenClaw，5分钟上线，性价比高。
OpenClaw部署相对简单，主要分为环境准备、平台安装、初始化配置三个步骤。对于新手，推荐使用Windows WSL2方案或macOS一键安装；对于生产环境，建议使用Docker或云服务器部署。部署完成后，可通过Web控制台或飞书等即时通讯工具与AI助手交互，实现自动化任务处理。
注意事项：OpenClaw运行时操作权限极大，建议在隔离环境中运行，并仔细阅读官方安全文档。
来源：我我我123，综合整理自网络。版权归原作者或平台所有，本号尊重原创，转载旨在分享，如有版权问题请联系删除。
