- 官方文档： https://docs.openclaw.ai/zh-CN/install
- 官网：https://openclaw.ai/
- GitHub：https://github.com/openclaw/openclaw
1 系统要求
- Node 24（推荐） （出于兼容性考虑，仍支持 Node 22 LTS，目前为
22.16+；如果缺失，安装脚本 会安装 Node 24） - macOS、Linux 或 Windows
- 仅当你从源码构建时需要
pnpm
1.1 OpenClaw安装
官方文档： https://docs.openclaw.ai/zh-CN/install
1.2 验证安装：
openclaw --version看到版本号即安装成功。
2 运行初始化向导
openclaw onboard向导会交互式引导你完成所有配置 ，包括：AI 模型、聊天渠道、技能、Hooks、Gateway 服务安装等。
2.1 安全提示
首先会显示安全警告，阅读后选择 Yes 继续。
2.2 选择 Onboarding 模式
◇ Onboarding mode
│ QuickStart选择 QuickStart（推荐），会自动配置网关端口（18789）、绑定地址（127.0.0.1）等默认设置。
2.3 配置 AI 模型
选择 AI 模型提供商并输入 API Key：
| 提供商 | 获取 API Key | 备注 |
|---|---|---|
| Anthropic Claude（推荐） | https://console.anthropic.com → 创建账号 → API Keys → Create Key | 需国际信用卡 |
| OpenAI GPT | https://platform.openai.com → API Keys → Create new secret key | 需国际信用卡 |
| OpenRouter（中国大陆推荐） | https://openrouter.ai → 注册 → Keys → Create Key | 支持多种支付方式，聚合多家模型 |
| DeepSeek（中国大陆推荐） | https://platform.deepseek.com → 注册 → API Keys → 创建 | 中国大陆服务商，支持支付宝充值 |
| Moonshot / Kimi | https://platform.moonshot.cn → 注册 → API Key 管理 → 新建 | 中国大陆服务商，支持国内支付 |
| 本地模型 | 支持 Ollama 等，无需 API Key | 免费，需本地算力中国大陆用户指南 |