选择可外接通道
在密钥管理创建专用密钥。Claude 可选 Claude Plus(精品)、Claude Max(外接版) 或合适的官方直连组;Codex 可选 Codex Pro(外接版) 或支持外接的 Lite。Claude Max(仅限CC) 和 Codex Pro(仅限Codex) 都不能用于 OpenClaw。Lite 没有免费 Fast 档位。查看价格后再发请求。
| 通道 | base | 模型示例 | 协议要求 |
|---|---|---|---|
| Claude | https://monkeytheme.com | claude-opus-4-8 | Anthropic Messages |
| Codex | https://monkeytheme.com/v1 | gpt-6.1-sol | OpenAI Responses |
以上模型已出现在当前模型列表的对应组中,但不代表所有 OpenClaw 版本均已完成兼容测试。
安装
先准备 Node.js。官方要求 Node 24.x 至少 24.16,或 26.1+;安全版本建议 24.22.1+ 或 26.12.1+。使用 npm 12 或 11.16+ 执行以下命令;较旧 npm 需省略 --allow-scripts=openclaw。详见 官方安装说明。Windows 原生与 WSL 均受支持,WSL 为可选方式。
Windows
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw --version
openclaw onboardmacOS
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw --version
openclaw onboardLinux
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw --version
openclaw onboard手动交互配置
先备份现有设置。运行 openclaw onboard,选择 Custom setup → More… / Custom Provider,明确选择自定义接入,不复用已有官方 OAuth。按上表输入 base、密钥、兼容协议与模型。Claude 选择 Anthropic Messages;Codex 仅在当前版本提供 Responses 时选择该协议,只有 Chat Completions 时不能靠更换模型名实现兼容。向导保存前会进行真实模型验证,可能按用量计费。详见 官方向导。文本模型可见不代表工具调用兼容。
启动与权限
完成后按该版本提示启动;可先查看 openclaw --help 确认。检查默认模型和提供商是否为新配置。先用空白工作目录验证,再按需要授予文件、工具与消息渠道权限,不要为了验证接入就开放全部能力。
检查、排错与恢复
用户自行发起简短请求可能计费。401 查密钥,403 查外接组,404 查协议与 base,model_not_found 查模型 ID。保留脱敏错误和版本号;不要读取或分享真实密钥配置。失败时用客户端支持的方式恢复先前提供商或备份。其他代理接入见 Hermes。