一、OpenClaw 是什么
OpenClaw 是一个开源的本地 AI Agent 框架，可以在自己的电脑或服务器上运行，并连接飞书、钉钉、QQ、 Telegram、Discord、Slack、WhatsApp 等聊天应用，把大模型变成一个可执行任务的 AI 助手。与普通 AI 工具不同，OpenClaw 可以访问文件、执行命令、调用 API，并通过消息平台与用户交互，因此适合构建个人 AI 助理、自动化工具或 AI 工作流系统。
OpenClaw 的一个重要特点是 本地运行（local-first）：用户可以把数据、API Key 和运行逻辑保存在自己的设备中，避免依赖云端服务。
- GitHub：
HTTPS://GitHub.com/openclaw/（以官方仓库为准） - 云端一键安装（阿里云 / 火山引擎 / MiniMax 等）
二、安装 OpenClaw 前的准备
在开始安装之前，需要确认系统环境满足要求。
1.系统要求
- macOS / Linux / Windows（建议使用 WSL2）
- 终端环境（Terminal / PowerShell）
OpenClaw 基于 Node.js 构建，因此需要 Node 22+ 环境。
可以在终端运行下面命令行，先检查 Node 版本：
如果版本低于 22，建议先升级 Node。
Node官网地址：https://nodejs.org/[https://nodejs.org/zh-cn/?utm_source=aihub.cn]
2.准备大模型API服务
🔥推荐讯飞星辰Maas平台：https://maas.xfyun.cn/[https://maas.xfyun.cn/modelSquare?ch=maas-lm-3N6p]，Coding Plan套餐首购低至3.9元/月，Qwen3-Coder-Next模型免费无门槛不限量使用
三、OpenClaw 最简单安装方法（官方推荐）
OpenClaw 官方提供了一条 一键安装脚本，这是最推荐的方式。
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash
Windows（PowerShell）
iwr-useb https://openclaw.ai/install.ps1 | iex// iwr-useb https://clawd.org.cn/install.ps1 | iex
该脚本会自动完成：
这是官方推荐的安装方式。
如果只想安装，不想自动进入初始化流程，可以使用：
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
四、使用 npm 手动安装 OpenClaw
如果你已经安装好 Node 22+，也可以手动安装 CLI。
# 安装Nodejs curl -fsSL https://deb.nodesource.com/setup\_22.x | sudo -E bash - sudo apt-get install -y nodejs node -v # 示例输出：v22.0.0 npm -v # 示例输出：10.5.0 # 国内用户先换源 npm config set registry https://registry.npmmirror.com # 安装OpenClaw npm install -g openclaw-cn # npm install -g openclaw@latest# 测试安装 openclaw --version # 启动向导并安装后台守护进程（开机自启） openclaw onboard --install-daemon
完成后 OpenClaw 会以后台服务形式运行。
注意：
- 如果可以使用上面的方式安装，就不要使用 npm 方式安装
- 在linux 中使用 npm 方式安装有权限问题，请注意
- 检查 Node 版本，如果不是大于 22.12.0 版本，请先升级
五、OpenClaw 初始化配置（Onboarding）
首次运行 OpenClaw 时，需要进行初始化配置：
openclaw onboard --install-daemon// openclaw-cn onboard // 在向导中选择 **YES** 继续。
这个命令会启动 OpenClaw onboarding 向导，并自动安装 Gateway 服务。
初始化流程通常包括：
整个流程是一个 交互式向导。
配置完成后，Gateway 会作为后台服务运行。
六、验证 OpenClaw 是否安装成功
安装完成后，可以通过以下命令检查：
查看服务状态
openclaw gateway status// openclaw-cn gateway status
查看系统状态
如果 Gateway 正常运行，就说明 OpenClaw 安装成功。
七、打开 OpenClaw 控制台
OpenClaw 提供了 Web Dashboard，可以直接在浏览器里与 AI 聊天。
或者直接访问：
Dashboard 打开后，就可以开始和 AI 对话。
官方文档也建议先使用 Dashboard 测试，再配置聊天通道。
八、连接聊天应用（可选）
OpenClaw 可以接入多个聊天平台：
通过这些平台，你可以在聊天软件中直接控制 AI Agent。
但对于第一次部署 OpenClaw 的用户来说，建议先确认本地 Dashboard 能正常运行，再接入聊天应用。
九、Docker 部署（进阶）
如果你希望把 OpenClaw 运行在容器环境，可以使用 Docker。
常见步骤：
docker compose run --rm openclaw-cli onboard docker compose up -d openclaw-gateway
这种方式适合：
不太适合完全新手。
十、卸载 OpenClaw（按系统）
1）通用卸载（npm 全局安装）
# 卸载全局 openclawnpm uninstall -g openclaw
校验是否卸载成功：
openclaw --version# 如果提示 command not found，说明卸载完成
2）清理 npm 缓存（可选）
npm cache verify# 如需强制清理：npm cache clean --force
3）清理本地配置与数据（可选，谨慎）
# 以下为示例路径，请按你的实际安装目录调整rm -rf ~/.openclawrm -rf ~/.config/openclaw
Windows PowerShell 示例：
# 按实际目录删除Remove-Item -Recurse -Force 「$env:USERPROFILE\.openclaw」Remove-Item -Recurse -Force 「$env:USERPROFILE\.config\openclaw」
注意：删除配置目录会清空本地配置与缓存，请先备份密钥和自定义配置。
十一、常见问题与排错
1 安装完成后 openclaw 命令找不到
可能原因：
可以尝试重新安装：
npm install -g openclaw@latest
2 Dashboard 打不开
先检查 Gateway：
再查看日志：
3 初始化失败
可以重新运行：
4 onboard卡住/报错
检查网络，重试
5 gateway启动失败
检查18789端口占用，可加 --port 参数更换端口
6 模型无响应
检查百炼API Key有效性及配额
7 关闭openclaw自带的【记忆搜索 / 向量检索】功能
openclaw config set agents.defaults.memorySearch.enabled false
十二、安全注意事项
OpenClaw 是一个可以执行系统操作的 AI Agent，因此需要注意安全。
建议：
近期研究人员还发现 OpenClaw Gateway 的认证机制曾存在漏洞，因此建议及时升级到最新版本。
十三、总结
OpenClaw 是目前非常受欢迎的本地 AI Agent 框架，可以让大模型直接连接到聊天应用并执行任务。
整个部署流程大致为：
1 安装 OpenClaw2 运行 onboarding 初始化3 启动 Gateway4 打开 Dashboard5 接入聊天平台
只要按照上面的步骤操作，大多数用户都可以在几分钟内完成 OpenClaw 的本地部署。
