核心概念

One-API 是一个开源接口管理系统，作为统一代理层连接OpenClaw和各种LLM提供商（NVIDIA、Anthropic、Google等），实现多API密钥的负载均衡和故障转移。

主要优势

• 突破免费限制：捆绑多个NVIDIA免费密钥（40 RPM），自动轮询避免速率限制
• 统一接入：OpenRouter、Groq、NVIDIA等所有模型通过单一端点访问
• 成本控制：配额系统限制OpenRouter付费使用，优先使用免费密钥
• 冗余保障：某个账户受限时自动切换到下一个工作密钥

配置步骤

1. 部署One-API（Docker）

docker run -d --restart always --name one-api -p 3000:3000 -v /home/user/one-api:/data justsong/one-api

访问面板：http://your-server-ip:3000（默认登录：root / 123456）

2. 添加渠道

• NVIDIA渠道：添加多个NVIDIA密钥（Type: NVIDIA）
• OpenRouter渠道：Type: OpenRouter，粘贴OpenRouter密钥
• Groq渠道：Type: Groq，使用gsk_…密钥

3. 创建统一令牌

在Tokens菜单生成新令牌（如”OpenClaw-Access”），这是OpenClaw唯一需要的密钥

4. 配置OpenClaw（openclaw.json）

json5

{
  "models": {
    "providers": {
      "my-proxy": {
        "baseUrl": "http://localhost:3000/v1",
        "apiKey": "sk-YOUR_ONE_API_TOKEN",
        "api": "openai-completions",
        "models": [
          { "id": "z-ai/glm-5", "name": "NVIDIA GLM-5" },
          { "id": "llama-3.3-70b-versatile", "name": "Groq Llama 3.3" },
          { "id": "anthropic/claude-3.5-sonnet", "name": "Claude 3.5 Sonnet" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "my-proxy/z-ai/glm-5",
        "fallbacks": [
          "my-proxy/llama-3.3-70b-versatile",
          "my-proxy/anthropic/claude-3.5-sonnet"
        ]
      }
    }
  }
}

故障转移策略

在One-API中设置渠道优先级：

• Priority 10：NVIDIA渠道（免费密钥优先）
• Priority 5：Groq渠道（次优先）
• Priority 1：OpenRouter渠道（最后付费保障）

成本节省技巧

1. 模型映射：在One-API中使用{“fast”: “z-ai/glm-5”}简化OpenClaw配置
2. 上下文限制：为付费模型设置contextWindow和maxTokens
3. OpenRouter免费模型：添加google/gemma-2-9b-it:free作为三层保障
4. OpenRouter月度限额：设置$5-$10封顶防止超额

推荐10大模型组合

模型ID	提供商	用途
z-ai/glm-5	NVIDIA	主代理大脑
deepseek-ai/deepseek-v3.2	NVIDIA	深度编码推理
llama-3.3-70b-versatile	Groq	即时响应速度
anthropic/claude-3.5-sonnet	OpenRouter	终极编码保障
moonshotai/kimi-k2.5	NVIDIA	大项目长上下文
mixtral-8x7b-32768	Groq	快速探索
minimaxai/minimax-m2.5	NVIDIA	自主循环任务
qwen/qwen2.5-72b-instruct	NVIDIA	多语言编程
meta-llama/llama-3.1-8b-instant	Groq	小型修复
google/gemma-2-9b-it:free	OpenRouter	紧急备用

快速测试故障转移

临时修改my-proxy的baseUrl为虚假地址（如http://localhost:9999），请求将自动跳转到fallbacks列表中的模型，实现无缝切换。

这样配置后，OpenClaw将拥有双重保护：One-API内部密钥轮询 + OpenClaw层级故障转移，确保永不中断服务！