openclaw-manager

一个给 OpenClaw 用的供应商管理脚本，支持：

中文交互菜单
供应商增删改查
多模型管理
默认模型设置
代理开关
配置备份恢复
单个 provider 导入导出
健康检查

一键下载并运行

直接执行（安装后会自动进入菜单）：

bash <(curl -fsSL https://raw.githubusercontent.com/tumgle/openclaw-manager/main/install.sh)

如果你只想手动下载脚本：

curl -fsSL -o provider-manager.sh https://raw.githubusercontent.com/tumgle/openclaw-manager/main/provider-manager.sh
chmod +x provider-manager.sh
./provider-manager.sh

Provider Manager 使用说明

这是一个给 OpenClaw 用的供应商管理脚本，脚本文件位置：

/root/.openclaw/workspace/provider-manager.sh

另外已经创建了全局命令软链接：

/usr/local/bin/provider-manager

它的目标很简单：别再手改 ~/.openclaw/openclaw.json。

你可以用它来：

管理模型供应商（provider）
给供应商增加/删除模型
设置默认模型
设置/清除代理
备份和恢复 OpenClaw 配置
导入/导出单个供应商
查看健康状态和日志
用中文交互菜单操作

一、最快上手

1）打开交互菜单

最推荐，任何路径都能直接执行：

provider-manager

或者：

provider-manager menu

如果你就在工作区里，也仍然可以这样跑：

provider-manager

现在脚本默认无参数就进入中文交互菜单，适合日常使用。

2）查看帮助

provider-manager help

二、常用命令

1. 列出所有供应商

provider-manager list

会显示：

供应商名称
接口地址
模型列表

2. 查看某个供应商详情

provider-manager show --name HDD

3. 查看当前默认模型

provider-manager show-default

4. 新增供应商

provider-manager add \
  --name DDD \
  --base-url https://www.codexapis.com/v1 \
  --api-key sk-xxx \
  --model gpt-5.4

可选参数：

--display-name 显示名称
--context-window 上下文窗口，默认 1048576
--max-tokens 最大输出，默认 128000
--reasoning 是否开启 reasoning，默认 false

同名供应商会被覆盖。

脚本会自动把新增的 provider/model 注册进 agents.defaults.models，避免只写入 provider 但 /models 不显示。

5. 给已有供应商追加模型

provider-manager add-model \
  --name HDD \
  --model gemini-2.5-pro \
  --display-name "HDD / gemini-2.5-pro"

这个不会新建 provider，而是把模型追加到已有 provider 下面。

如果同名模型已存在，会覆盖该模型配置。

脚本现在会自动把新增模型同步注册到：

agents.defaults.models["provider/model"]

这样 /models 里也能正常看到。

6. 删除某个供应商下的单个模型

provider-manager remove-model --name HDD --model gemini-2.5-pro

7. 删除整个供应商

provider-manager remove --name DDD

8. 重命名供应商

provider-manager rename-provider --old-name HDD --new-name CPA

这个操作会顺手处理：

.models.providers
agents.defaults.models
默认模型 primary
fallback 中对应的 provider 前缀

9. 设置默认模型

provider-manager set-default --provider HDD --model gpt-5.4

最终会写成类似：

hdd/gpt-5.4

注意：脚本会自动把 provider 名称转成小写后再组合成默认模型路径。

三、接口测试

1. 直接测试接口

./provider-manager.sh test \
  --base-url https://www.codexapis.com/v1 \
  --api-key sk-xxx \
  --model gpt-5.4

如果你想加代理测试：

./provider-manager.sh test \
  --base-url https://www.codexapis.com/v1 \
  --api-key sk-xxx \
  --model gpt-5.4 \
  --proxy http://127.0.0.1:3128

2. 按已有供应商配置测试

provider-manager test-provider --name HDD --model gpt-5.4

如果不写 --model，会默认取这个 provider 的第一个模型。

四、代理管理

1. 设置 OpenClaw 代理

provider-manager toggle-proxy --set http://127.0.0.1:3128

这个会写入：

~/.config/systemd/user/openclaw-gateway.service.d/proxy.conf

并自动重启：

openclaw-gateway

2. 清除 OpenClaw 代理

provider-manager toggle-proxy --unset

五、备份与恢复

脚本每次修改配置前，都会自动备份：

~/.openclaw/backups/

1）查看备份列表

provider-manager backups

2）恢复最近一次备份

provider-manager restore-last

3）恢复指定备份

provider-manager restore --file ~/.openclaw/backups/openclaw.json.20260408-233000.bak

恢复会覆盖当前配置，并自动重启 OpenClaw。

六、导入与导出供应商

1. 导出单个供应商

provider-manager export-provider --name HDD --file /root/hdd-provider.json

导出格式示例：

{
  "name": "HDD",
  "provider": {
    "baseUrl": "https://example.com/v1",
    "apiKey": "sk-xxx",
    "api": "openai-completions",
    "models": []
  }
}

2. 导入单个供应商

provider-manager import-provider --file /root/hdd-provider.json

同名供应商会被覆盖。

七、健康检查与日志

1. 健康检查

provider-manager health-check

会检查：

配置文件是否存在
当前供应商数量
当前默认模型
是否存在代理配置
openclaw-gateway 是否运行
当前供应商列表

八、交互菜单功能概览

运行：

provider-manager

菜单里目前包括：

列出所有供应商
查看供应商详情
查看当前默认模型
新增供应商
给已有供应商追加模型
重命名供应商
删除单个模型
删除整个供应商
直接测试接口
按供应商测试接口
设置默认模型
设置代理
清除代理
查看配置备份
恢复最近一次备份
从备份列表中选择恢复
导出供应商到 JSON
从 JSON 导入供应商
执行健康检查
退出

危险操作都加了二次确认。

九、注意事项

1. 修改配置会自动重启 OpenClaw

脚本默认会执行：

systemctl --user restart openclaw-gateway

2. 这是给当前环境定制的

默认假设：

OpenClaw 配置文件在：
```
~/.openclaw/openclaw.json
```
OpenClaw 服务名是：
```
openclaw-gateway
```

3. API Key 会写入配置文件

如果你导出 provider，文件里也会带上 key。注意保管导出文件。

4. 导入会覆盖同名 provider

所以导入前最好先：

provider-manager backups

或者先手动导出原 provider。

十、推荐日常操作流

场景 1：新增一个 provider

provider-manager add --name XXX --base-url ... --api-key ... --model ...
provider-manager test-provider --name XXX
provider-manager set-default --provider XXX --model ...

场景 2：先试再加

provider-manager test --base-url ... --api-key ... --model ...

如果通，再正式 add。

场景 3：改坏了想回滚

provider-manager backups
provider-manager restore-last

场景 4：以后最省心的方式

provider-manager

十一、文件位置

脚本

/root/.openclaw/workspace/provider-manager.sh

全局命令

/usr/local/bin/provider-manager

本说明文件

/root/.openclaw/workspace/PROVIDER_MANAGER_README.md

OpenClaw 配置

~/.openclaw/openclaw.json

自动备份目录

~/.openclaw/backups/

代理配置文件（若设置过）

~/.config/systemd/user/openclaw-gateway.service.d/proxy.conf

如果你后面继续扩展脚本，建议优先保持两件事：

每次改配置前先备份
危险操作必须确认

这样才不容易翻车。

Name		Name	Last commit message	Last commit date
README.md		README.md
install.sh		install.sh
provider-manager.sh		provider-manager.sh

Latest commit

History

Folders and files

Repository files navigation