OpenClaw 是一类偏命令行的 AI 助手平台,安装时不仅要装程序,还要准备模型密钥、聊天渠道和网关配置。也就是说,真正的安装不只是把软件拉下来,而是把整套运行环境串起来。
如果你用的是 Windows,优先建议走 WSL2。原生 Windows 环境虽然也能尝试,但兼容性通常更容易出问题。为了少走弯路,最好先把环境准备好,再开始正式安装。
安装前先准备什么
- Node.js 22 或更高版本。
- 一个可用的 AI 模型 API 密钥。
- 飞书、企业微信或钉钉中的一个账号。
注意事项
- Windows 用户优先用 WSL2,不要一上来就直接在原生环境里硬装。
- 如果电脑里已有旧版本,先卸载旧版并清理残留,再继续安装。
- 安装路径尽量保持简单,别把环境和旧数据混在一起。
1. 安装 OpenClaw 命令行工具
不同系统的安装命令不一样,先选对环境再执行。
macOS / Linux / WSL2
- 打开终端。
- 执行
curl -fsSL https://openclaw.ai/install.sh | bash。 - 安装完成后用
openclaw --version检查是否成功。
Windows PowerShell
- 打开 PowerShell。
- 执行
iwr -useb https://openclaw.ai/install.ps1 | iex。 - 再用
openclaw --version验证安装结果。
如果你的 Windows 环境不稳定,先装好 WSL2 再继续,会更省时间。
2. 跑配置向导
安装完成后,下一步不是直接使用,而是先把模型、渠道和网关关系配置好。
配置顺序
- 先选择 AI 模型和对应密钥。
- 再选择飞书、企业微信或钉钉等沟通渠道。
- 然后设置网关运行方式。
- 最后把后台服务安装好,让它能自动运行。
这样配置完,后续使用会更稳定,也更容易排错。
3. 启动网关并接入飞书或企业微信
网关是 OpenClaw 真正运行起来的关键环节。安装成功不代表能用,能正常启动网关、接通聊天渠道,才算完成部署。
验证步骤
- 执行
openclaw gateway status查看状态。 - 如果需要手动启动,再执行对应的网关命令。
- 完成配对后,按提示审批渠道连接。
- 最后用健康检查命令确认服务正常。
如果你能顺利看到状态正常,基本就说明安装链路已经跑通了。
常见问题
Windows 报错怎么办
优先切到 WSL2。很多原生 Windows 的报错,在 WSL2 下会直接消失。
怎么判断安装成功
最简单的判断方式,就是能执行版本检查、网关状态检查和健康检查。
可以部署到公司服务器吗
可以。只要模型密钥、渠道配置和网关环境都正常,OpenClaw 可以放到服务器上集中使用。
总结
OpenClaw 安装的核心,不是单独装一个命令,而是把环境、密钥、渠道和网关一起配好。先准备好依赖,再按命令安装,最后跑配置向导和状态检查,流程会清晰很多。
如果你是 Windows 用户,直接上 WSL2 往往比在原生环境里反复试错更省事。


提示