OpenClaw 怎么安装？Windows、WSL2 和网关配置完整教程

一、先看整体关系

安装成功的判断标准不是命令存在，而是模型、渠道和 Gateway 都能跑通。先把依赖和密钥准备好，后续排错会简单很多。

安装前先准备什么

• Node.js 22 或更高版本。
• 一个可用的 AI 模型 API 密钥。
• 飞书、企业微信或钉钉中的一个账号。

注意事项

• Windows 用户优先用 WSL2，不要一上来就直接在原生环境里硬装。
• 如果电脑里已有旧版本，先卸载旧版并清理残留，再继续安装。
• 安装路径尽量保持简单，别把环境和旧数据混在一起。

1. 安装 OpenClaw 命令行工具

不同系统的安装命令不一样，先选对环境再执行。

macOS / Linux / WSL2

1. 打开终端。
2. 执行 curl -fsSL https://openclaw.ai/install.sh | bash。
3. 安装完成后用 openclaw --version 检查是否成功。

Windows PowerShell

1. 打开 PowerShell。
2. 执行 iwr -useb https://openclaw.ai/install.ps1 | iex。
3. 再用 openclaw --version 验证安装结果。

如果你的 Windows 环境不稳定，先装好 WSL2 再继续，会更省时间。

2. 跑配置向导

安装完成后，下一步不是直接使用，而是先把模型、渠道和网关关系配置好。

配置顺序

1. 先选择 AI 模型和对应密钥。
2. 再选择飞书、企业微信或钉钉等沟通渠道。
3. 然后设置网关运行方式。
4. 最后把后台服务安装好，让它能自动运行。

这样配置完，后续使用会更稳定，也更容易排错。

3. 启动网关并接入飞书或企业微信

网关是 OpenClaw 真正运行起来的关键环节。安装成功不代表能用，能正常启动网关、接通聊天渠道，才算完成部署。

验证步骤

1. 执行 openclaw gateway status 查看状态。
2. 如果需要手动启动，再执行对应的网关命令。
3. 完成配对后，按提示审批渠道连接。
4. 最后用健康检查命令确认服务正常。

如果你能顺利看到状态正常，基本就说明安装链路已经跑通了。

常见误区

只检查版本号

版本号正常只说明命令存在，不代表网关和渠道已经接通。

Windows 原生环境硬装

依赖链不稳定时，WSL2 往往比反复修原生环境更可控。

密钥和渠道后补

先装后补配置容易把问题混在一起，建议按顺序完成。

方法对比

用「Claw龙虾部署大师」减少前置配置成本

一键本地部署 用来处理 OpenClaw 安装、基础环境和本地运行入口，适合不想先花大量时间排查依赖的人。

模型接入 用来把豆包、通义千问、DeepSeek 等模型配置进工作流，适合需要先跑通 AI 助手底座，再继续配置渠道和任务的人。

本地安全部署 适合把数据、账号和运行环境留在本机或指定设备上，再按文章里的步骤继续收紧权限、接入渠道或验证任务。