Skip to main content
通过 DeerAPI 为 OpenClaw 接入 AI 大模型 — 一站式聚合 OpenAI、Claude、Gemini 及国产大模型，支持 Midjourney、Suno、Luma 等图像视频模型 API 调用。

​
前提条件

​
1. 安装或更新 OpenClaw

推荐使用官方安装脚本： 
curl -fsSL https://openclaw.ai/install.sh | bash
也可以使用 npm 全局安装： 
npm install -g openclaw@latest

​
2. 先跑一次 Onboarding

执行初始化向导： 
openclaw onboard --install-daemon
向导选项建议：
  • Model/Auth：选择 Skip，先把基础环境跑起来
  • Workspace：沿用默认值
向导完成后，确认 Gateway 正常： 
openclaw gateway status
openclaw dashboard
这一步会在 ~/.openclaw 下创建状态目录，包括 openclaw.json、默认 workspace 以及 ~/.openclaw/agents/ 下的 agent 分离目录。

​
3. 保存 DeerAPI Key

Daemon 模式下，推荐将 Key 写入 ~/.openclaw/.env： 
printf 'DEERAPI_KEY=%s\n' 'your_deerapi_key' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
如果你已通过 shell、服务管理器或其他密钥系统注入 DEERAPI_KEY，也可以继续沿用。下面的配置示例使用 ${DEERAPI_KEY}，不需要把真实 Key 直接写进 openclaw.json。

​
4. 把 DeerAPI Provider 写进配置

编辑 ~/.openclaw/openclaw.json，把以下内容合并进去：
ProviderAPI 格式实际调用端点Base URL
deerapi-openaiopenai-completionsPOST /v1/chat/completionshttps://api.deerapi.com/v1
deerapi-openai-responsesopenai-responsesPOST /v1/responseshttps://api.deerapi.com/v1
deerapi-claudeanthropic-messagesPOST /messageshttps://api.deerapi.com
deerapi-googlegoogle-generative-aiPOST /v1beta/...https://api.deerapi.com/v1beta
四种 Provider 可按需选择，也可同时配置，通过 provider/model 完整引用在不同接口格式间切换： 
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "deerapi-claude/claude-sonnet-4-6"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "deerapi-openai": {
        "baseUrl": "https://api.deerapi.com/v1",
        "apiKey": "${DEERAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "gpt-5.4", "name": "GPT-5.4" }]
      },
      "deerapi-openai-responses": {
        "baseUrl": "https://api.deerapi.com/v1",
        "apiKey": "${DEERAPI_KEY}",
        "api": "openai-responses",
        "models": [{ "id": "gpt-5.4-pro", "name": "GPT-5.4 Pro" }]
      },
      "deerapi-claude": {
        "baseUrl": "https://api.deerapi.com",
        "apiKey": "${DEERAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }]
      },
      "deerapi-google": {
        "baseUrl": "https://api.deerapi.com/v1beta",
        "apiKey": "${DEERAPI_KEY}",
        "api": "google-generative-ai",
        "models": [{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }]
      }
    }
  }
}
鉴权直接来自 models.providers.*.apiKey 中的 ${DEERAPI_KEY}，不需要手工创建 auth-profiles.json。使用 deerapi-openai-responses（api: "openai-responses"）可以调用 OpenAI Responses API（POST /v1/responses），适用于 gpt-5.4-pro 等仅支持 Responses 接口的模型。使用 deerapi-openai（api: "openai-completions"）走 Chat Completions 接口（POST /v1/chat/completions），两者 baseUrl 相同，区别仅在于 OpenClaw 实际调用的下游端点。完整模型列表见 DeerAPI 模型页面。

​
5. 重启并验证

修改配置或新增 .env 后，重启 Gateway： 
openclaw gateway restart
然后执行以下检查： 
openclaw models status
openclaw models list --provider deerapi-claude
openclaw doctor
成功标准：
  • openclaw models status 能解析出 deerapi-claude/claude-sonnet-4-6，且不再提示缺少鉴权
  • openclaw models list --provider deerapi-claude 能列出已配置的 DeerAPI 模型
  • openclaw doctor 不再报告 DeerAPI 相关的配置 schema 错误或缺少鉴权

​
6. 切换模型

# 把默认模型切到 DeerAPI Claude
openclaw models set deerapi-claude/claude-sonnet-4-6

# 在聊天中切换当前 session 模型
/model deerapi-openai/gpt-5.4
/model deerapi-openai-responses/gpt-5.4-pro
/model deerapi-claude/claude-sonnet-4-6
/model deerapi-google/gemini-3.1-pro-preview

​
7. 从零重装（可选）

如果需要彻底清除旧版本遗留状态，先停掉 Gateway，再删除 ~/.openclaw，然后重新执行 onboarding，最后把 DeerAPI 配置加回来。
此操作会删除本地配置、会话、日志、鉴权状态和默认 workspace，请谨慎执行。