Skip to content

OpenClaw 一键配置安装教程

0. 前置:先安装 Node.js

OpenClaw 对 Node.js 版本比较敏感,建议直接使用 Node.js 22+

先装 Node.js:

验证安装:分别执行下面两个命令

bash
node -v
bash
npm -v

如果看到版本号,说明 Node.js 安装成功了。

1. 先安装 OpenClaw

如果你是在 Linux 服务器、云主机,或者 macOS 终端里操作,先执行:

bash
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 安装完成后,再执行下面这条命令:

bash
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 选择模型类型

脚本会让你先选模型大类:

  • GPT
  • Claude

这一步很重要,因为 OpenClaw 对这两类模型的配置写法不一样。

5.3 选择具体模型

脚本会实时请求模型列表,再让你从返回结果里选。

6. 配置完成后怎么验证

脚本写完后,如果 OpenClaw 还在运行,建议先重启相关进程或网关。

然后你可以执行:

bash
openclaw doctor
bash
openclaw status

如果你的环境支持 dashboard,也可以再执行:

bash
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 模板就够了,可以看:

词元AI | CI-Yuan AI - 让全球顶级AI模型触手可达