配置 OpenClaw 使用 DeerAPI

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

本文档已适配当前 OpenClaw onboarding 流程（2026.3.8+）。

前提条件

Node.js >= 22

DeerAPI API Key

1. 安装或更新 OpenClaw

推荐使用官方安装脚本：

如果你已经习惯全局 npm 安装，也可以：

2. 先跑一次 Onboarding

执行当前推荐的初始化向导：

向导里建议这样选：

Model/Auth 先选 Skip，先把基础环境跑起来。

Workspace 沿用默认值，除非你已经有自己的工作目录。

让向导完成 daemon 安装和 health check。

完成后先确认 Gateway 正常：

这一步会在 ~/.openclaw 下创建当前 OpenClaw 的状态目录，包括 openclaw.json、默认 workspace，以及 ~/.openclaw/agents/ 下的按 agent 分离目录。

3. 保存 DeerAPI Key

对于 daemon 模式，最稳妥的方式是把 Key 放进 ~/.openclaw/.env：

如果你已经通过 shell、服务管理器或其他密钥系统注入 DEERAPI_KEY，也可以继续沿用。下面的配置示例使用 ${DEERAPI_KEY}，不需要把真实 Key 直接写进 openclaw.json。

4. 把 DeerAPI Provider 写进配置

编辑 ~/.openclaw/openclaw.json，把下面这些字段合并进去：

Provider	API 格式	Base URL
`deerapi-openai`	`openai-completions`	`https://api.deerapi.com/v1`
`deerapi-claude`	`anthropic-messages`	`https://api.deerapi.com`
`deerapi-google`	`google-generative-ai`	`https://api.deerapi.com/v1beta`

这三个 provider 要分开写，是因为 OpenClaw 按 API 兼容层路由，而不是只按厂商品牌路由。你可以只保留其中一个，也可以三种都配上，然后通过标准的 provider/model 引用在 OpenAI-compatible、Anthropic-compatible、Google-compatible 这三类接口之间切换。

{
  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-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" }],
      },
    },
  },
}

说明：

你实际编辑的配置源仍然是 ~/.openclaw/openclaw.json。

OpenClaw 会把自定义 provider 物化到每个 agent 自己的 models.json。

这个基础接入流程里，不需要再手工创建 auth-profiles.json。鉴权直接来自 models.providers.*.apiKey 里的 ${DEERAPI_KEY}。

只有在你需要多 profile、多 key 轮换或按 agent 存储独立密钥时，才需要进一步用 auth-profiles.json。

本文档当前使用的示例模型 ID 是 gpt-5.4、claude-sonnet-4-6、gemini-3.1-pro-preview。

切换模型时统一使用完整的 provider/model，避免歧义。

完整模型列表见 DeerAPI 模型页面。

5. 重启并验证

新增 ~/.openclaw/.env 或修改 provider 配置后，先重启一次 Gateway：

然后执行当前推荐的检查命令：

成功标准：

openclaw models status 能解析出 deerapi-claude/claude-sonnet-4-6，且不再提示 DeerAPI provider 缺少鉴权。

openclaw models list --provider deerapi-claude 能列出你配置的 DeerAPI 模型。

openclaw doctor 不再报告 DeerAPI 相关的配置 schema 错误或缺少鉴权。若存在权限、旧服务残留、embedding provider 缺失等本机问题，仍可能出现与 DeerAPI 无关的 warning。

6. 切换模型

7. 从零重装（可选）

如果你是在修复旧版本遗留状态，想彻底从零再验证一遍，可以先停掉 Gateway，再删除 ~/.openclaw，然后重新执行 onboarding，再把 DeerAPI 配置加回来。注意这会删除本地配置、会话、日志、鉴权状态和默认 workspace。

OpenClaw

配置 OpenClaw 使用 DeerAPI#

前提条件#

1. 安装或更新 OpenClaw#

2. 先跑一次 Onboarding#

3. 保存 DeerAPI Key#

4. 把 DeerAPI Provider 写进配置#

5. 重启并验证#

6. 切换模型#

7. 从零重装（可选）#