OpenClaw 一键配置安装教程

本页介绍 OpenClaw 的一键接入流程：先用官方脚本安装 OpenClaw 本体，完成初始化（onboard）后再运行 AI通道 的配置脚本，自动写入模型与 API Key。

前置：先安装 Node.js

OpenClaw 要求 Node.js 22 或更高版本：

node --version

版本不够请先参考对应系统的 Node.js 安装指南。

先安装 OpenClaw

macOS / Linux：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows（PowerShell 管理员）：

iwr -useb https://openclaw.ai/install.ps1 | iex

安装完成后验证：

openclaw --version
openclaw doctor

安装过程中怎么选

首次运行 openclaw onboard --install-daemon 时会进入交互向导，大约会问 10 个问题。下面是推荐选法：

1. 确认安装：选 Yes 继续。
2. On boarding mode：选 Manual，后续我们自己写配置。
3. Model auth provider：选 Skip for now，一键脚本会负责写 provider 配置。
4. Filter Models by provider：默认即可。
5. Default Model：暂时留空或跳过，后续由一键脚本写入。
6. Select Channel：选 stable。
7. Skill Status：按需，默认 enabled 即可。
8. Enable Hooks：默认 enabled。
9. How do you want to hatch your bot：选 Local，监听默认端口 18789。
10. Install shell completion script：建议选 Yes，方便命令补全。

安装完成后，再运行一键配置脚本

初始化结束后执行 AI通道 的配置脚本：

curl -sSL https://sh.aitongdao.com/openclaw.sh | bash

一键脚本会做什么

脚本内部会依次完成这几步：

1. 检测 node 与 curl 是否可用。
2. 让你选择模型类型（GPT 或 Claude）。
3. 提示你输入 AI通道 的 API Key（输入时显示为星号）。
4. 用你的 Key 调用 AI通道 的模型列表接口，拉取可用模型。
5. 按协议类型筛选并列出候选模型，让你选择一个作为 primary 模型。
6. 写入 ~/.openclaw/openclaw.json，把旧文件备份为 .bak。
7. 清理 ~/.openclaw/agents/main/agent/auth-profiles.json 中对应 provider 的缓存记录，避免旧凭证冲突。

一键脚本里的选项是什么意思

选择模型类型（GPT vs Claude）

决定使用哪种协议访问 AI通道：

• GPT：走 OpenAI Responses 协议，baseUrl 自动设为 https://ai.aitongdao.com/v1，api 字段为 openai-responses。
• Claude：走 Anthropic Messages 协议，baseUrl 自动设为 https://aitongdao.com（不带 /v1），不设置 api 字段（或为空）。

选择具体模型

脚本会请求 /v1/models 接口，筛选出与所选类型匹配的模型 ID（GPT 会匹配 gpt-*/o1-*/codex 系列，Claude 会匹配包含 claude 的条目），以编号列表展示。输入序号即可。

配置完成后怎么验证

先让网关重启一次以加载新配置：

openclaw gateway restart
openclaw status
openclaw doctor

然后打开仪表盘查看当前模型与连通性：

openclaw dashboard

默认仪表盘地址为 http://localhost:18789，在其中发送一条测试消息即可验证。

常见问题

• onboard 时选了 Skip for now 怎么办：完全没问题，一键脚本会绕过交互直接写 provider 配置。
• 会覆盖我原有的配置吗：脚本在写入前会把 ~/.openclaw/openclaw.json 备份为 openclaw.json.bak，可以随时还原。
• GPT 和 Claude 的 baseUrl 为什么不一样：OpenAI 协议端点是 /v1/chat/completions 或 /v1/responses，所以必须带 /v1；Anthropic 协议端点直接挂在根路径的 /v1/messages，工具侧只写域名即可，库会自动拼接路径。
• 腾讯云面板用户如何配置：参考 腾讯云 JSON 配置模板，直接把模板粘贴到面板表单即可，不必执行脚本。
• 脚本执行后模型没有切换：执行 openclaw gateway restart 重启网关，或重新登录 shell。