一键探测 + 配置 + 诊断，让你的 OpenClaw 吃满全网免费 AI 模型。
3000+ 行交互式 bash 脚本，把 OpenClaw 模型配置从"手工编辑 JSON + 祈祷不出错"变成"跑一行命令 + 全自动"。
bash api-model-tester.sh跑一次三五分钟，出来的结果：8 个 Provider、1273 个模型全部写入 OpenClaw 配置，Gateway 自动重启生效。
手工配置 OpenClaw 模型，你大概率会踩这些坑：
| 痛点 | 详细描述 | 脚本方案 |
|---|---|---|
| 手编 JSON 一个逗号全崩 | openclaw.json 少一个逗号整个文件解析失败，Gateway 启动直接报错。排查一个逗号花了 40 分钟的事我干过。 |
--setup 自动生成正确 JSON，直接写入，零手工编辑 |
| 环境变量读不到 | macOS LaunchAgent 不读 .zshrc，终端里 echo $KEY 有值，Gateway 那边 MissingEnvVarError。这个坑我踩了两次。 |
API Key 直接写入 JSON 配置，不依赖环境变量。同时备份到 .zshrc 供终端使用 |
| 僵尸进程杀不死 | 单独 install --force 不杀旧进程，旧进程抢端口，新进程起不来，但 PID 被覆盖，看起来 running 实际不干活。 |
严格 stop → sleep 2 → install --force 重启序列，启动后验证 RPC probe |
| Key 过期发现不了 | 8 个平台哪个 Key 什么时候失效？等 Agent 返回 401 才发现，手动一个个 curl 测试又是半小时。 | --checkup 10 秒检测所有 Provider，绿✓红✗一目了然 |
| 100+ 模型逐个手添？ | 每个平台上百个模型，手工添加到 JSON 配置？一个平台就要半小时。 | 自动拉取模型列表，逐个测试可达性，批量写入 |
| Fallback 链不会排 | 1273 个模型，哪个排前面哪个排后面？排错了 failover 先打到最烂的模型上。 | --default 交互式设置默认模型 + Fallback 优先级 |
| 配置改坏没法恢复 | 手工改 JSON 改坏了，Gateway 起不来，原始配置忘了备份。 | 每次修改前自动备份，--rollback 一键恢复 |
| 平台 | 免费额度 | 模型数 | 注册链接 |
|---|---|---|---|
| 白山智算 EdgeFN | 注册送 150 元 + 首调 300 元 + 邀请 200 元/人 | 26+ | 注册（推荐码） |
| 硅基流动 SiliconFlow | 9B 以下永久免费 + 注册送 2000 万 Token | 100+ | 注册（推荐码） |
| 阿里百炼 DashScope | 每模型 100 万 Token + 推广期 7000 万 | 207+ | 控制台 |
| 火山方舟（字节） | 每天 200 万 Token 循环刷新 | 102+ | 控制台 |
| AIGCBest | 注册即用 GPT 系列 | GPT-4.1-mini | 注册（推荐码） |
| 平台 | 免费额度 | 模型数 | 注册链接 |
|---|---|---|---|
| Groq | 永久免费 30-60 RPM，推理极快 | 15+ | 控制台 |
| NVIDIA NIM | 免费 Key，无需充值 | 185+ | API Keys |
| Cerebras | 每天 100 万 Token | 4 | 控制台 |
| OpenRouter | free 标记模型完全免费 | 235+ | Keys |
推荐组合：白山（主力大额度）+ 硅基/Groq（日常）+ NVIDIA（备用）。OpenClaw 自动 failover，一个挂了用下一个。
- OpenClaw >= 2026.3.0
- python3
- bash 3.2+（macOS / Linux）
bash api-model-tester.sh全程中文引导，6 步走完：
Step 1 → 选择平台（显示免费额度 + 注册链接）
Step 2 → 输入 API Key
Step 3 → 测试连通性（网络 + Key 有效性）
Step 4 → 拉取模型列表（自动分类：chat/embedding/audio）
Step 5 → 可达性测试（逐个模型真实调用）
Step 6 → 写入 OpenClaw 配置 + 安全重启 Gateway
# 探测模型（不修改配置）
bash api-model-tester.sh https://api.edgefn.net/v1 sk-your-key
# 探测 + 测试可达性
bash api-model-tester.sh https://api.siliconflow.cn/v1 sk-xxx --test
# 探测 + 测试 + 自动写入配置
bash api-model-tester.sh https://api.groq.com/openai/v1 gsk-xxx --setupbash api-model-tester.sh https://api.edgefn.net/v1 sk-edgefn-key --setup
bash api-model-tester.sh https://api.siliconflow.cn/v1 sk-silicon-key --setup
bash api-model-tester.sh https://api.groq.com/openai/v1 gsk-groq-key --setup
bash api-model-tester.sh https://dashscope.aliyuncs.com/compatible-mode/v1 sk-dash-key --setup
# ... 每个平台一行| 命令 | 说明 |
|---|---|
--checkup [--json] |
全面体检：对每个 Provider 发真实 API 请求，检测认证 + 环境变量同步 + 额度告警 |
--selftest [--json] |
网络自检：检测 9 大平台的连通性（不需要 Key） |
--status [--json] |
查看当前配置：默认模型、Fallback 链、Provider 统计 |
--diagnose |
深度诊断：扫描过期 OAuth Token、僵尸 profile、401/403 认证，可一键清理 |
--test-api |
进入 API 测试菜单（选平台 → 输 Key → 测试） |
| 命令 | 说明 |
|---|---|
--wizard |
完整配置向导（同无参数直接运行） |
--default |
交互式设置默认模型 + Fallback 优先级 |
--manage-keys |
添加/编辑/删除 API Key |
--backup |
全量备份 5 个关键文件到 ~/.openclaw/backups/ |
--rollback [--yes] |
恢复到上一个备份 |
--factory-reset |
删除所有自定义 Provider 和 Fallback（保留其他配置） |
| 选项 | 说明 |
|---|---|
--json |
JSON 输出（供 AI Agent 读取） |
--yes |
跳过所有确认提示 |
-h, --help |
显示帮助 |
bash api-model-tester.sh --checkup10 秒检测所有已配置 Provider：
✓ edgefn 853ms (GLM-4.6)
✓ siliconflow 82ms (Qwen/2.5-7B-Instruct)
✓ dashscope 506ms (qwen-max)
~ volcengine 370ms 平台可用（限流中）
✓ groq 723ms (llama-3.3-70b-versatile)
✓ nvidia 3511ms (deepseek-v3.1)
✓ cerebras 623ms (gpt-oss-120b)
✗ anthropic 401 认证失败
正常 7/8 认证失败 1 其他错误 0
健康度: 88%
⚠ 发现 2 个潜在问题:
• [env_mismatch] EDGEFN_API_KEY Shell 和 plist 值不同步
• [quota_low] OpenRouter 额度即将耗尽: 剩余 $0.12
检测项目：
| 检查 | 说明 |
|---|---|
| API 认证 | 发真实 chat completion 请求，不是只 ping 端点 |
| 环境变量同步 | 对比 Shell .zshrc 和 Gateway plist 的 Key |
| OpenRouter 额度 | 查余额 API，低于 10% 告警 |
| URL 格式 | 检测尾部斜杠（会导致 /v1//models 404） |
| 措施 | 实现 |
|---|---|
| API Key 不在命令行暴露 | curl 通过 --config 临时文件传递 Key，用完即删，ps aux 看不到 |
| 并发写入保护 | mkdir 原子锁（跨平台，macOS 无 flock） |
| 配置自动备份 | 每次修改前自动备份 openclaw.json，支持 --rollback |
| 输入消毒 | 过滤 \n/\r/shell 特殊字符 |
| Gateway 安全重启 | stop → sleep 2 → install --force，启动后验证 RPC |
| 精确 factory-reset | 仅删除 providers/fallbacks，保留 mode/allowed 等配置 |
| 跨平台兼容 | 不用 sed -i ''（macOS only），用 grep -v + mv |
连通性测试 → 拉取模型列表 → 按类型分类 → 逐个可达性测试
↓
获取文件锁（mkdir 原子锁）
↓
读取 openclaw.json → 合并新 Provider → 写回
• apiKey 直接写入 JSON（不依赖环境变量）
• api: "openai-completions"
• mode: "merge"（与内置模型合并）
↓
备份 Key 到 .zshrc（终端备用）
↓
释放文件锁
↓
Gateway 安全重启（stop → sleep 2 → install --force）
↓
验证 RPC probe → 完成
# 全量备份（5 个关键文件）
bash api-model-tester.sh --backup
# 查看可用备份并恢复
bash api-model-tester.sh --rollback
# 还原出厂（仅删 Provider + Fallback）
bash api-model-tester.sh --factory-reset备份内容：openclaw.json / auth-profiles.json / team-hierarchy.json / .zshrc / Gateway plist
保留最近 10 个备份，超出自动清理。
Mac mini，2026-03-08，8 个 Provider 全配置：
edgefn: 26 groq: 15
aigcbest: 1 nvidia: 185
dashscope: 207 cerebras: 4
volcengine: 102 openrouter: 235
────────────────────────────────────
自定义 provider: 775 models
全部（含内置）: 1,273 models
# 1. 安装 OpenClaw
brew install openclaw/tap/openclaw
# 2. 启动 Gateway
openclaw gateway install
# 3. 注册一个免费平台（推荐硅基流动）
# https://cloud.siliconflow.cn/i/ljXTcot9
# 4. 运行配置脚本
bash api-model-tester.sh
# 5. 验证
bash api-model-tester.sh --checkup
# 看到绿色 ✓ = 成功
# 6. 想要更多模型？重复步骤 3-4，选不同平台Q：需要 OpenClaw 才能用吗？
A：需要。脚本依赖 openclaw CLI 读写配置。但 --selftest 可以在没有 OpenClaw 的机器上检测平台连通性。
Q：API Key 存哪？
A：直接写入 ~/.openclaw/openclaw.json 的 models.providers.*.apiKey。不依赖环境变量，不怕 Gateway 重启丢失。
Q：支持自定义平台吗？
A：支持。任何 OpenAI 兼容格式的 API（需要 /v1/chat/completions + /v1/models 端点）。
Q：配错了怎么办？
A：--rollback 恢复上一个备份。脚本每次写入前都自动备份。
Q：Gateway 挂了怎么办？
A：openclaw gateway stop && sleep 2 && openclaw gateway install --force
v1.0.1 (2026-03-08)
- 修复
--checkup --json静默退出（set -u+source ~/.zshrc冲突） - Gateway 重启顺序修正：stop → inject plist → install
- curl 全部改用
--config临时文件传递 API Key - 添加
mkdir原子文件锁防并发写入 sed -i替换为跨平台grep -v+mvfactory_reset精确清理，保留mode/allowed- 输入消毒增加
\n/\r过滤
v1.0.0 (2026-03-08)
- 支持 9 大平台（5 国内 + 4 全球）
- 完整向导 + 诊断 + 自检模式
- macOS LaunchAgent plist 自动注入
- JSON 输出供 AI Agent 使用
- 备份 + 回退机制
MIT