OpenClaw 如何接入 OpenAI、Claude 和 DeepSeek 模型 API

在主机选技术博客的日常运维交流中，不少朋友问同一个问题：OpenClaw 怎么同时接 OpenAI、Claude 和 DeepSeek 的 API？今天直接给配置方法，实测可跑，适合 AI Agent、Claude Code、Codex 等场景。

OpenClaw 本身是一个轻量级 AI Agent 框架，支持通过配置文件或环境变量绑定多个模型端点。下面分模型讲清楚，避免你配完发现 Key 不对、端口不通、模型列表刷不出来。

OpenClaw 接入 OpenAI API

OpenAI 的 API 兼容性最好，OpenClaw 默认就支持。你需要准备三样东西：API Key、Base URL（可选）、模型名称。

1. 获取 API Key：去 OpenAI 后台创建，注意别泄露到公开仓库。
2. 配置环境变量（推荐）：

export OPENAI_API_KEY="sk-xxxx"
export OPENAI_BASE_URL="https://api.openai.com/v1" # 默认值，非官方代理可不改
export OPENAI_MODEL="gpt-4o" # 按需改

3. 如果 OpenClaw 用 YAML 配置文件，在 `config.yaml` 里写：
yaml
llm:
provider: openai
api_key: ${OPENAI_API_KEY}
base_url: ${OPENAI_BASE_URL}
model: ${OPENAI_MODEL}

启动 OpenClaw 后，它会自动加载。测试命令：

openclaw chat "Hello"

如果返回正常，说明接入成功。常见坑：Key 带空格、Base URL 末尾缺斜杠、模型名写错（比如 gpt-4o 写成 gpt4o）。

OpenClaw 接入 Claude API

Claude 的 API 结构跟 OpenAI 不同，需要单独配置 provider 为 anthropic。OpenClaw 的 0.3.x 以上版本内置了 Anthropic 适配器。

1. 获取 Anthropic API Key：从 console.anthropic.ai 生成。
2. 环境变量方式：

export ANTHROPIC_API_KEY="sk-ant-xxxx"
export CLAUDE_MODEL="claude-sonnet-4-20250514" # 以官方最新版本为准

3. 配置文件：
yaml
llm:
provider: anthropic
api_key: ${ANTHROPIC_API_KEY}
model: ${CLAUDE_MODEL}

4. 启动后验证：

openclaw chat "Write a poem"

如果报错 401，检查 Key 前缀是否正确（Anthropic Key 以 sk-ant- 开头）。如果报 400，可能是模型名过期，去官方文档查当前可用模型列表。

OpenClaw 接入 DeepSeek API

DeepSeek 的 API 兼容 OpenAI 格式，所以直接用 OpenAI 配置改个 base_url 就行，不用换 provider。

1. 获取 DeepSeek API Key：在 platform.deepseek.com 创建。
2. 配置：

export OPENAI_API_KEY="sk-deepseek-xxx" # 注意：用 DeepSeek 的 Key 覆盖
export OPENAI_BASE_URL="https://api.deepseek.com/v1"
export OPENAI_MODEL="deepseek-chat"

3. 配置文件同上，provider 仍为 openai。因为 DeepSeek 接口与 OpenAI 兼容，OpenClaw 不需要额外适配器。
4. 测试：

openclaw chat "解释一下 Docker 网络"

注意：DeepSeek 的免费额度有限，建议先查余额。如果返回空结果，检查 Key 是否过期或 base_url 是否写成了 `https://api.deepseek.com`（少了`/v1`）。

多模型切换与配置管理

生产环境经常需要按任务切换模型。OpenClaw 支持在配置文件中定义多个 LLM 配置，通过运行时参数选择。

yaml
llm:
default: openai
providers:
openai:
api_key: ${OPENAI_API_KEY}
base_url: ${OPENAI_BASE_URL}
model: gpt-4o
anthropic:
api_key: ${ANTHROPIC_API_KEY}
model: claude-sonnet-4-20250514
deepseek:
api_key: ${DEEPSEEK_API_KEY}
base_url: https://api.deepseek.com/v1
model: deepseek-chat

启动时指定 provider：

openclaw chat –provider deepseek "你好"

这样就能灵活切换，不用每次改环境变量。注意：不同模型对工具调用（function calling）的支持程度不同，DeepSeek 的 function calling 能力弱于 OpenAI，Claude 的 tool use 有自己的格式，OpenClaw 内部会做适配，但遇到复杂 Agent 任务时建议优先用 OpenAI 或 Claude。

老鸟叮嘱

1.API Key 别写死在代码里：用环境变量或 `.env` 文件，`.gitignore` 里加上 `.env`。
2.Base URL 别写错：OpenAI 官方是 `https://api.openai.com/v1`，DeepSeek 是 `https://api.deepseek.com/v1`，Claude 不需要（除非用代理）。
3.模型名别用旧版本：比如 `gpt-4o` 已经迭代多次，建议用 `gpt-4o-2024-08-06` 这种带日期的稳定版本。DeepSeek 的 `deepseek-chat` 是通用名，但若需要特定版本，看官方文档。
4.端口和防火墙：OpenClaw 默认监听 0.0.0.0:8080，如果部署在 VPS 上，务必用 Nginx 反向代理加 HTTPS，不要裸奔公网。后台管理端口建议只允许本地访问。
5.日志排查：启动时加 `–debug` 参数能打印详细请求日志，看到 401/403 先检查 Key，看到 429 是限流，等一会再试。

FAQ

Q：OpenClaw 必须用 Docker 部署吗？
A：不强制。可以直接在 Python 环境里 pip install openclaw，但 Docker 部署更方便隔离环境。官方推荐用 Docker Compose，一键拉起。

Q：接入 DeepSeek 时总是报 404，怎么办？
A：检查 base_url 是否完整。DeepSeek 的 API 地址是 `https://api.deepseek.com/v1`，不是 `https://api.deepseek.com`。另外确认 Key 对应的模型是否有权限，免费用户可能只能调用 `deepseek-chat`。

Q：OpenClaw 支持同时用多个 Key 负载均衡吗？
A：社区版不支持。你需要自己写一个简单的轮询脚本，或者用 nginx 做反向代理负载均衡。生产环境建议用商业版或自己二次开发。

Q：Claude 的 API 和 OpenAI 的 API 能共用同一个配置文件吗？
A：可以，如上文的多 provider 配置。但注意 Claude 的 tool use 格式不同，OpenClaw 内部会做转换，但部分高级功能（如流式输出）可能不一致，实测时留意。

Q：部署后模型列表刷不出来，是 OpenClaw 的问题吗？
A：OpenClaw 不会主动拉模型列表，模型名需要你手动填写。如果填了不存在的模型，启动时不会报错，但调用时会返回 400。建议先用 curl 测试 API 是否正常：

curl -X POST "https://api.openai.com/v1/chat/completions" -H "Authorization: Bearer $OPENAI_API_KEY" -H "Content-Type: application/json" -d '{"model":"gpt-4o","messages":[{"role":"user","content":"hi"}]}'

先排除 API 本身问题。

Q：OpenClaw 的配置文件支持环境变量引用吗？
A：支持。用 `${VAR}` 语法，启动前确保变量已 export。如果变量未定义，OpenClaw 会报错退出，所以建议在 `.env` 里写好默认值。

接入多模型 API 并不复杂，核心就是 Key、Base URL、模型名三个参数。按本文步骤配，10 分钟能跑通。如果卡在某个环节，先看日志，别急着重装系统。

—

**相关阅读：**

– [VPS部署AI工具100讲：AI Agent、Codex、Claude Code、Hermes Agent、Ollama与自动化工作流实战教程](https://www.zhujixuan.com/jishujiaocheng/9606.html)
– [Hermes Agent VPS 部署教程：Docker Compose 安装和初始化配置](https://www.zhujixuan.com/jishujiaocheng/9872.html)
– [Claude Code 与 Codex 对比：哪个更适合 VPS 远程开发](https://www.zhujixuan.com/jishujiaocheng/9816.html)