OpenClaw 一键配置安装教程
0. 前置:先安装 Node.js
OpenClaw 对 Node.js 版本比较敏感,建议直接使用 Node.js 22+。
先装 Node.js:
- macOS:Nodejs macOS
- Linux:Nodejs Linux
- Windows:Nodejs Windows
验证安装:分别执行下面两个命令
node -vnpm -v如果看到版本号,说明 Node.js 安装成功了。
1. 先安装 OpenClaw
如果你是在 Linux 服务器、云主机,或者 macOS 终端里操作,先执行:
curl -fsSL https://openclaw.ai/install.sh | bash如果你是 Windows,本地更推荐用 WSL 或远程 SSH 到服务器上操作;纯 PowerShell 用户可以继续参考 OpenClaw Windows。
2. 安装过程中怎么选
当安装流程进入交互界面后,按下面这个顺序操作。
2.1 确认安装
当看到是否继续安装的提示时,选择:
yes
2.2 On boarding mode
这里选择:
QuickStart
2.3 Model auth provider
这里不要先配模型供应商,直接选择:
Skip for now
后面我们会直接用一键脚本帮你写配置,不需要在安装阶段手填。
2.4 Filter Models by provider
这里先选择:
anthropic
2.5 Default Model
这里先选择:
claude-opus-4-6
这里的选择主要是为了先把安装流程走完。后面你再跑一键配置脚本时,还可以重新切换成 GPT 或其他 Claude 模型。
2.6 Select Channel
这里按你自己的实际需求选择渠道。
如果你只是先测试,可以按你提供的方式走:
- 选择
Telegram - 输入你的 Bot Token
- 回车确认
2.7 Skill Status
这里先跳过:
configure skills now先不装
后续你可以再通过网页面板安装 Skills。
2.8 Enable Hooks
这里建议:
- 用空格键全选
- 然后回车确认
后续如果安装过程中有 Gateway 相关步骤,正常等待即可。
2.9 How do you want to hatch your bot
这里先选择:
Do this later
2.10 Install shell completion script
这里选择:
yes
到这里,OpenClaw 本体安装流程就算完成了。
3. 安装完成后,再运行一键配置脚本
OpenClaw 安装完成后,再执行下面这条命令:
curl -sSL https://sh.ci-yuan-ai.com/openclaw.sh | bash这个脚本会直接帮你写 ~/.openclaw/openclaw.json 配置。
4. 一键脚本会做什么
脚本会按顺序帮你完成下面几件事:
- 选择 API 线路
- 选择模型类型
- 输入 API Key
- 自动拉取模型列表
- 让你从真实模型列表里选择具体模型
- 自动写入 OpenClaw 配置文件
如果系统里已经存在原配置,脚本还会自动备份原文件:
~/.openclaw/openclaw.json.bak
5. 一键脚本里的选项是什么意思
5.1 选择线路
你会看到两条线路:
https://api.ci-yuan-ai.com:国内直连https://cdn.ci-yuan-ai.com:海外 CDN
中国大陆环境建议直接选 ai.ci-yuan-ai.com。
5.2 选择模型类型
脚本会让你先选模型大类:
GPTClaude
这一步很重要,因为 OpenClaw 对这两类模型的配置写法不一样。
5.3 选择具体模型
脚本会实时请求模型列表,再让你从返回结果里选。
6. 配置完成后怎么验证
脚本写完后,如果 OpenClaw 还在运行,建议先重启相关进程或网关。
然后你可以执行:
openclaw doctoropenclaw status如果你的环境支持 dashboard,也可以再执行:
openclaw dashboard常见问题
1. 为什么安装阶段要先 Skip for now?
因为闪电 API 的一键脚本会在安装完成后直接帮你写配置。
如果你在安装阶段已经手填了一轮,后面还要再改一次,反而更绕。
2. 一键脚本会不会覆盖我原来的配置?
会修改 ~/.openclaw/openclaw.json,但脚本也会先备份原文件:
~/.openclaw/openclaw.json.bak
3. GPT 和 Claude 的 Base URL 一样吗?
不一样。
- GPT /
openai-responses:要用带/v1的地址 - Claude / Anthropic:通常直接用不带
/v1的地址
4. 腾讯云面板用户也需要走这个安装流程吗?
如果你用的是腾讯云可视化界面,直接填 JSON 模板就够了,可以看: