一、OpenClaw 是什么
OpenClaw 是一个开源的本地 AI Agent 框架，可以在自己的电脑或服务器上运行，并连接飞书、钉钉、QQ、 Telegram、Discord、Slack、WhatsApp 等聊天应用，把大模型变成一个可执行任务的 AI 助手。
与普通 AI 工具不同，OpenClaw 可以访问文件、执行命令、调用 API，并通过消息平台与用户交互，因此适合构建个人 AI 助理、自动化工具或 AI 工作流系统。
OpenClaw 的一个重要特点是 本地运行（local-first）：
用户可以把数据、API Key 和运行逻辑保存在自己的设备中，避免依赖云端服务。
二、安装 OpenClaw 前的准备
在开始安装之前，需要确认系统环境满足要求。
系统要求
- macOS / Linux / Windows（建议使用 WSL2）
- Node.js 22 或更高版本
- 可以访问 GitHub / npm
- 终端环境（Terminal / PowerShell）
OpenClaw 基于 Node.js 构建，因此需要 Node 22+ 环境。
可以在终端运行下面命令行，先检查 Node 版本：
node --version
如果版本低于 22，建议先升级 Node。
Node官网地址：https://nodejs.org/
三、OpenClaw 最简单安装方法（官方推荐）
OpenClaw 官方提供了一条 一键安装脚本，这是最推荐的方式。
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash
Windows（PowerShell）
iwr -useb https://openclaw.ai/install.ps1 | iex
该脚本会自动完成：
- Node 环境检测
- CLI 安装
- 依赖安装
- 启动初始化向导
这是官方推荐的安装方式。
如果只想安装，不想自动进入初始化流程，可以使用：
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
四、使用 npm 手动安装 OpenClaw
如果你已经安装好 Node 22+，也可以手动安装 CLI。
npm install -g openclaw@latest
安装完成后运行初始化：
openclaw onboard --install-daemon
这个命令会启动 OpenClaw onboarding 向导，并自动安装 Gateway 服务。
完成后 OpenClaw 会以后台服务形式运行。
五、OpenClaw 初始化配置（Onboarding）
首次运行 OpenClaw 时，需要进行初始化配置：
openclaw onboard --install-daemon
初始化流程通常包括：
- 设置 OpenClaw Gateway
- 创建 workspace
- 配置安全认证
- 选择聊天平台
- 绑定模型 API
整个流程是一个 交互式向导。
配置完成后，Gateway 会作为后台服务运行。
六、验证 OpenClaw 是否安装成功
安装完成后，可以通过以下命令检查：
查看服务状态
openclaw gateway status
查看系统状态
openclaw status
如果 Gateway 正常运行，就说明 OpenClaw 安装成功。
七、打开 OpenClaw 控制台
OpenClaw 提供了 Web Dashboard，可以直接在浏览器里与 AI 聊天。
运行：
openclaw dashboard
或者直接访问：
http://127.0.0.1:18789
Dashboard 打开后，就可以开始和 AI 对话。
官方文档也建议先使用 Dashboard 测试，再配置聊天通道。
八、连接聊天应用（可选）
OpenClaw 可以接入多个聊天平台：
- 飞书
- 钉钉
- Telegram
- Discord
- Slack
- Signal
- iMessage
通过这些平台，你可以在聊天软件中直接控制 AI Agent。
但对于第一次部署 OpenClaw 的用户来说，建议先确认本地 Dashboard 能正常运行，再接入聊天应用。
九、Docker 部署（进阶）
如果你希望把 OpenClaw 运行在容器环境，可以使用 Docker。
常见步骤：
docker compose run --rm openclaw-cli onboard
docker compose up -d openclaw-gateway
这种方式适合：
- VPS服务器
- 云端部署
- 隔离运行环境
不太适合完全新手。
十、常见问题与排错
1 安装完成后 openclaw 命令找不到
可能原因：
- Node PATH 未正确配置
- npm 全局路径未加入 PATH
可以尝试重新安装：
npm install -g openclaw@latest
2 Dashboard 打不开
先检查 Gateway：
openclaw gateway status
再查看日志：
openclaw logs --follow
3 初始化失败
可以重新运行：
openclaw onboard
十一、安全注意事项
OpenClaw 是一个可以执行系统操作的 AI Agent，因此需要注意安全。
建议：
- 不要在主工作机直接运行
- 最好在虚拟机或 VPS 运行
- 不要给 AI 过高权限
- 不要安装不可信插件
近期研究人员还发现 OpenClaw Gateway 的认证机制曾存在漏洞，因此建议及时升级到最新版本。
十二、总结
OpenClaw 是目前非常受欢迎的本地 AI Agent 框架，可以让大模型直接连接到聊天应用并执行任务。
整个部署流程大致为：
1 安装 OpenClaw
2 运行 onboarding 初始化
3 启动 Gateway
4 打开 Dashboard
5 接入聊天平台
只要按照上面的步骤操作，大多数用户都可以在几分钟内完成 OpenClaw 的本地部署。
