OpenClaw配置教程：一键接入AI大模型API中转站

为什么 OpenClaw 需要搭配 API中转站？

OpenClaw 本身是一个"躯壳"，它的智慧来自于背后的大模型（如 OpenAI、Claude、Deepseek 等）。直接调用官方 API 往往面临**网络受限、充值困难、多模型管理繁琐**等问题。

使用 简易API (jeniya.cn) 这样的专业 AI大模型API中转站，您可以获得以下优势：

• ✅ 网络畅通： 国内服务器直连，无需科学上网，完美适配轻量应用服务器。
• ✅ 一站式管理： 一个 API Key 即可调用全网几十种主流大模型。
• ✅ 性价比高： 按量计费，无最低消费，注册即送免费测试额度。

通用配置模板 (核心必看)

在轻量应用服务器控制台的应用管理中，填写自定义模型相关字段后点击保存即可完成配置。如果下方没有你想要的特定模型，可以使用以下通用模板接入任何兼容 OpenAI/Anthropic 协议的模型：

{
  "provider": "自定义名称(如: jeniya)",
  "base_url": "https://api.jeniya.cn/v1",  // 填入API中转站的接口地址
  "api": "openai-completions",             // 协议类型
  "api_key": "sk-在简易API获取的密钥",        // 你的API Key
  "model": {
    "id": "gpt-4o",                        // 填入你想要调用的模型ID
    "name": "GPT-4o"
  }
}

参数说明：

• api: openai-completions 用于兼容 OpenAI 协议的模型；anthropic-messages 用于兼容 Claude 协议的模型。
• base_url: 强烈建议替换为 简易API 的请求地址，以确保国内服务器稳定调用。

主流 AI大模型API 配置示例大全

1. OpenAI (ChatGPT系列)

使用 OpenAI 官方或中转 API，以 gpt-4o 模型为例：

{
  "provider": "openai",
  "base_url": "https://api.jeniya.cn/v1",
  "api": "openai-completions",
  "api_key": "your-api-key-here",
  "model": {
    "id": "gpt-4o",
    "name": "GPT-4o"
  }
}

2. Anthropic Claude 系列

使用 Claude API，以 claude-3-5-sonnet-20240620 模型为例：

{
  "provider": "anthropic",
  "base_url": "https://api.jeniya.cn",
  "api": "anthropic-messages",
  "api_key": "your-api-key-here",
  "model": {
    "id": "claude-3-5-sonnet-20240620",
    "name": "Claude 3.5 Sonnet"
  }
}

3. 硅基流动 / DeepSeek

以硅基流动使用 "OpenAI" 协议，使用 DeepSeek-V3 模型为例：

{
  "provider": "siliconflow",
  "base_url": "https://api.siliconflow.cn/v1",
  "api": "openai-completions",
  "api_key": "your-api-key-here",
  "model": {
    "id": "deepseek-ai/DeepSeek-V3",
    "name": "DeepSeek-V3"
  }
}

注：您同样可以在简易API中转站直接调用 Deepseek 模型，只需将 base_url 改为中转站地址，id 改为 deepseek-chat 即可。

更多第三方大模型配置详解

MiniMax

以 MiniMax 使用 "Anthropic" 协议，使用 MiniMax-M2.5 模型为例：

{
  "provider": "minimax",
  "base_url": "https://api.minimaxi.com/anthropic", // 国际版为 minimax.io
  "api": "anthropic-messages",
  "api_key": "your-api-key-here",
  "model": { "id": "MiniMax-M2.5", "name": "MiniMax M2.5" }
}

Kimi Code

{
  "provider": "kimicode",
  "base_url": "https://api.kimi.com/coding",
  "api": "anthropic-messages",
  "api_key": "your-api-key-here",
  "model": { "id": "kimi-k2.5", "name": "Kimi K2.5" }
}

Google Gemini & xAI Grok

// Gemini 3 Flash 示例
{
  "provider": "google",
  "base_url": "https://generativelanguage.googleapis.com/v1beta/openai",
  "api": "openai-completions",
  "api_key": "your-api-key-here",
  "model": { "id": "gemini-3-flash-preview", "name": "Gemini 3 Flash" }
}

// xAI Grok 示例
{
  "provider": "xai",
  "base_url": "https://api.x.ai/v1",
  "api": "openai-completions",
  "api_key": "your-api-key-here",
  "model": { "id": "grok-4.1", "name": "Grok 4.1" }
}

常见问题与错误排查 (FAQ)

99% 的错误码都可以通过长按翻译了解原因。以下是常见错误及解决方案：

错误码	原因分析	解决方案
401 not authorized	API Key 不正确	前往 简易API控制台 检查并重新复制 API Key。
429 / 500	余额不足或并发过高	检查账户余额是否充足；或检查 API Key 状态。
rate_limit	速率限制	更换提供商，或联系提供商获取更大配额。
404	base_url 不对	确保 URL 结尾包含正确的路径，如 /v1。
403	地域不支持	若轻量服务器在境外，可能会被国内模型拦截。建议统一使用 API中转站 解决地域网络问题。

💡 进阶提示：

• 模型回复慢： 若您选择深度思考模型（如 o1, Deepseek-R1），可能因上下文过多导致思考时间长，推荐选择快思考模型（如 gpt-4o-mini）替代日常对话。
• Token 消耗过快： OpenClaw 在调用模型时会携带较多上下文信息以保证连贯性。建议在 简易API 后台实时关注 Token 用量明细。