⚠️ 使用前必看

1️⃣ 只在 Linux 测试过

✅ Linux：已测试

⚠️ Mac：未验证

⚠️ Windows：未验证（英文界面）

下载地址： https://pan.quark.cn/s/cd83038f48a4 提取码：nUEn

2️⃣ 一定先备份配置文件

默认路径（每个人的路径不一样，自己核实下）：

备份（每个人的路径不一样，自己核实下）：

⚠️ 脚本会直接修改这个文件（脚本里也会自动备份，但建议手动再备一份）

📦 脚本说明

系统	脚本
Linux	add-model-advanced.sh
Mac	add-model-advanced-mac.sh
Windows	add-model-advanced-win.ps1

🐧 一、Linux 使用

▶️ 运行脚本

将脚本上传到服务器然后在脚本目录执行以下命令：

🧭 第一步：选择功能

启动后会看到：

请选择功能：
1) 只切换已有模型
2) 添加/更新自定义 OpenAI 兼容 provider

👉 两种模式说明

1️⃣ 只切换已有模型

你会被要求输入：

请输入 provider 名
请输入模型名，例如 gpt-5.4

👉 实际执行的是：

openclaw models set provider/model

2️⃣ 添加 / 更新 provider（常用）

👉 新部署AiXor模型选这个

🧩 第二步：填写信息

脚本会依次问：

① provider 名

请输入 provider 名 [aixor]:

👉 可以直接回车（默认 aixor）

② Base URL

请输入中转站地址 [https://aixor.org/v1]:

👉 必须是（可直接回车默认https://aixor.org/v1）：

https://xxx/v1

⚠️ 少 /v1 会报 404

③ API Key 输入方式

API Key 输入方式：
1) 显示输入
2) 隐藏输入

👉 输入1选择显示输入，方便看到输入的key

④ 输入 API Key

请输入 API Key:

👉 在 https://aixor.org/console/token 创建好对应分组的令牌复制到这里，注意对应分组！

⑤ API 类型

接口类型：
1) openai-completions
2) openai-responses

👉 一般选：

🧠 第三步：如果 provider 已存在

会出现：

provider 已存在
请选择处理方式：
1) 覆盖 provider（旧模型会被替换）
2) 保留旧模型并追加新模型
3) 只更新 URL / Key / API，不改模型
4) 取消

各选项说明：

1 覆盖 → 清空旧模型，只保留新选的

2 合并（推荐） → 保留旧的 + 加新模型

3 只改 key/url → 不动模型

4 取消

🌐 第四步：获取模型列表

脚本会自动请求：

GET /models

如果成功，会显示：

检测到以下模型：
[1] xxx
[2] xxx

📌 第五步：选择导入方式

请选择导入方式：
1) 全部添加
2) 只添加一个
3) 添加多个
4) 手动输入模型名

👉 推荐：

如果选 3（多个）

支持：

1,3,5
1-3,5

（脚本内部用 Python 解析）

如果自动获取失败

脚本会提示：

自动获取模型列表失败，改为手动输入（但是一般代表接口有问题）

你需要输入：

gpt-5,gpt-5.2

💾 第六步：自动备份配置

脚本会执行：

备份配置到：openclaw.json.bak.xxxx

⭐ 第七步：是否设置默认模型

是否设置默认模型？输入 yes 或 no

如果选 yes，会让你选编号（这一步一般都选yes，这样会切换主模型为你设置的模型）：

请选择默认模型：
[1] xxx
[2] xxx

🚀 第八步：写入配置 + 切换模型

脚本会自动：

写入 openclaw.json

更新 provider

注册模型

设置默认模型（如果选了）

执行：openclaw models set provider/model

✅ 完成后会显示

models status

以及：

写入完成
provider: xxx
baseUrl : xxx
api     : xxx
config  : xxx

最后可以在聊天窗口输入/status发送过去查看模型是否切换成功

🍎 二、Mac 使用（说明）

▶️ 运行

将脚本上传到服务器然后在脚本目录执行以下命令：

📌 和 Linux 的区别

只有一点：

👉 为了兼容 Mac 自带 Bash 3.2

脚本做了特殊处理：

不用 mapfile

用 while read 读取数组

🧭 使用流程

👉 完全和 Linux 一样

三、Windows 使用说明

⚠️ 状态

未测试

界面是英文

▶️ 运行

.\add-model-advanced-win.ps1

🧭 英文界面对照

英文	中文
Select mode	选择模式
Switch model	切换模型
Add/update provider	添加/更新 provider
provider name	provider 名
base url	接口地址
API key	密钥
API type	接口类型
import mode	导入方式
set default model	设置默认模型

📌 使用逻辑

👉 和 Linux 完全一致，只是语言不同，因为windows对中文兼容性问题

⚠️ 常见错误（脚本内置）

❌ 401

认证失败

👉 API Key 错了

❌ 404

接口不存在

👉 baseUrl 写错（通常少 /v1）

❌ 429

请求过多 / 配额不足

👉 限流 / 没余额

❌ 000

网络连接失败

👉 接口访问不了

OpenClaw一键脚本接入教程

⚠️ 使用前必看#

1️⃣ 只在 Linux 测试过#

2️⃣ 一定先备份配置文件#

📦 脚本说明#

🐧 一、Linux 使用#

▶️ 运行脚本#

🧭 第一步：选择功能#

👉 两种模式说明#

1️⃣ 只切换已有模型#

2️⃣ 添加 / 更新 provider（常用）#

🧩 第二步：填写信息#

① provider 名#

② Base URL#

③ API Key 输入方式#

④ 输入 API Key#

⑤ API 类型#

🧠 第三步：如果 provider 已存在#

各选项说明：#

🌐 第四步：获取模型列表#

📌 第五步：选择导入方式#

👉 推荐：#

如果选 3（多个）#

如果自动获取失败#

💾 第六步：自动备份配置#

⭐ 第七步：是否设置默认模型#

🚀 第八步：写入配置 + 切换模型#

✅ 完成后会显示#

🍎 二、Mac 使用（说明）#

▶️ 运行#

📌 和 Linux 的区别#

🧭 使用流程#

三、Windows 使用说明#

⚠️ 状态#

▶️ 运行#

🧭 英文界面对照#

📌 使用逻辑#

⚠️ 常见错误（脚本内置）#

❌ 401#

❌ 404#

❌ 429#

❌ 000#

⚠️ 使用前必看

1️⃣ 只在 Linux 测试过

2️⃣ 一定先备份配置文件

📦 脚本说明

🐧 一、Linux 使用

▶️ 运行脚本

🧭 第一步：选择功能

👉 两种模式说明

1️⃣ 只切换已有模型

2️⃣ 添加 / 更新 provider（常用）

🧩 第二步：填写信息

① provider 名

② Base URL

③ API Key 输入方式

④ 输入 API Key

⑤ API 类型

🧠 第三步：如果 provider 已存在

各选项说明：

🌐 第四步：获取模型列表

📌 第五步：选择导入方式

👉 推荐：

如果选 3（多个）

如果自动获取失败

💾 第六步：自动备份配置

⭐ 第七步：是否设置默认模型

🚀 第八步：写入配置 + 切换模型

✅ 完成后会显示

🍎 二、Mac 使用（说明）

▶️ 运行

📌 和 Linux 的区别

🧭 使用流程

三、Windows 使用说明

⚠️ 状态

▶️ 运行

🧭 英文界面对照

📌 使用逻辑

⚠️ 常见错误（脚本内置）

❌ 401

❌ 404

❌ 429

❌ 000