OpenClaw Docs CN

模型接入 / 国外模型

国外模型接入

如果你的重点是通用最强能力、代码任务、英文输出、国际平台机器人,国外模型通常更值得优先接。OpenClaw 当前官方文档里,最清晰、最适合直接照着走的国外路线主要是:OpenAIAnthropicGoogle GeminiOpenRouter。其他像 xAI、Groq、Mistral 也在 provider catalog 里出现,但知识库这里先以官方说明最完整的几条为主。

先给结论

如果你主要做代码、国际平台机器人和英文内容,国外 provider 往往更值得做主模型;但中国用户最容易忽略的不是模型本身,而是网络、认证方式和 fallback 方案。

最值得先看的 4 条国外路线

OpenAI

OpenAI provider 页支持两类思路:API key,以及适合 OpenAI / Codex 账号用户的 Codex OAuth。官方还明确写了实时能力的传输方式:优先 WebSocket,必要时再回退到 SSE。

如果你要做稳定通用聊天、多模态、以及生态最成熟的工具接入,这条路线很常见。

Anthropic

Anthropic provider 页支持 API keysetup-token onboarding 两条认证路线。一个容易被忽略的点是:prompt caching 只在 API key 路线下可用,setup-token 路线并不是完全等价替代。

如果你的重点是复杂推理、写作质量和高质量 agent 行为,这条路线通常值得重点看。

Google Gemini

Google provider 页支持标准的 Gemini API key 路线。官方文档同时也提到了 google-antigravitygoogle-gemini-cli 这类非官方 OAuth 路线,但明确给了安全提醒:如果你要用这类非官方登录方式,最好使用非关键账号。

所以对大多数人来说,更稳的做法还是 API key 路线优先。

OpenRouter

如果你不想在 OpenClaw 里分别对接很多海外 provider,OpenRouter 是非常实用的一条统一出口。官方 provider 页支持 OpenRouter onboarding / auth,这对想快速试多家国外模型的人很友好。

官方地址与 OpenClaw 接法速查

国外模型这一栏最容易乱的地方,是把 模型官方站、开发者文档、聚合平台 混成一件事。下面这张表按知识库常用分类,把入口统一整理好了。

平台 官网 / 产品入口 开发者文档 / 控制台 OpenClaw 主流接法 更适合什么场景
OpenAI openai.com platform.openai.com 内置 provider。优先用 API Key;如果你本来就在 OpenAI / Codex 路线里,也可以按官方支持的 OAuth 路径走。 通用能力、代码、多模态和生态成熟度都很强,适合作为国外主模型的常规起点。
Anthropic / Claude anthropic.com console.anthropic.com / docs.anthropic.com 内置 provider。主流是 API Key;如果你走 setup-token onboarding,也要记住它和完整 API Key 路线并不完全等价。 复杂推理、长文写作、agent 行为质量和代码辅助都很强。
Google Gemini gemini.google.com AI Studio / ai.google.dev 内置 provider。最稳的是 API Key 路线;如果你看到社区里的 OAuth 方案,要把它和官方 API Key 路线分开看。 Google 生态用户、多模态实验和国际产品测试常会优先接这一条。
xAI / Grok x.ai docs.x.ai 如果你当前 OpenClaw 版本的 provider catalog 已带 xAI,就按 catalog / onboarding 录入 API Key;如果没有,就按 custom provider / compatible endpoint 接。 国际热点追踪、社媒风格内容和 Grok 系模型测试。
Groq groq.com console.groq.com 优先按 OpenAI-compatible endpoint / custom provider 理解;如果你的 OpenClaw 版本目录里已经露出 Groq provider,再按对应向导走。 极低延迟和高吞吐路线很受欢迎,适合即时响应型机器人。
Mistral mistral.ai console.mistral.ai / docs.mistral.ai 当前更稳的写法是优先按 provider catalog 或 custom provider 处理,不要假设所有 OpenClaw 版本都带一模一样的 Mistral 登录向导。 适合欧洲合规讨论、文本任务和多样化 fallback 组合。
OpenRouter openrouter.ai 官方文档 内置 provider。最适合用作 统一出口,一条线路切换多家国外模型,也方便做 fallback 和成本对比。 不想分头维护多家 Key、想同时试多家国外模型时非常合适。

国外模型适合哪些场景

场景 更适合先看哪条路线 原因
代码与工具调用 OpenAI / Anthropic 官方接入成熟,模型能力和 agent 生态更完整
英文写作和国际平台机器人 Anthropic / OpenAI / Gemini 英文表现和国际生态更顺
想快速切换多家模型 OpenRouter 一条出口更容易做灰度、fallback 和成本对比
要同时测多家 catalog 模型 OpenRouter 或 provider catalog 里其他路线 方便统一管理,但要注意上游真实来源

国外模型接入时最容易忽略的 4 件事

  1. 网络稳定性:模型本身再强,如果你的网络环境不稳,多渠道机器人就会抖得很明显。
  2. 认证方式不一样:有的是 API key,有的是 OAuth / portal / setup-token,不要想当然。
  3. fallback 要独立考虑:强模型做 primary,便宜或更容易成功的模型放 fallback,别只配一条线。
  4. 多模态要看 imageModel:不是所有主模型都自动覆盖图片任务,必要时要单独配视觉模型。

要不要一开始就用 xAI / Groq / Mistral

它们已经出现在官方 provider catalog 里,所以不是“不能用”。但如果你的目标是先把知识库主路径写清楚,OpenAI、Anthropic、Google Gemini、OpenRouter 这几条的官方文档覆盖度更高,更适合先作为主教程。

后面如果你要继续扩写这一栏,再单独给 xAI、Groq、Mistral 做补充页会更稳。

推荐的入门顺序

  1. 只想要一条最常见、最通用的国外路线:先看 OpenAI。
  2. 想要高质量写作和复杂推理:重点看 Anthropic。
  3. 已经在 Google 生态里:看 Gemini。
  4. 想一条线切很多模型:看 OpenRouter。

和中国模型怎么配合更合理

对中国用户来说,比较实用的组合通常是:

  • 中文办公主场景:主模型用中国 provider,fallback 放一条国外强模型。
  • 编码主场景:主模型用国外强模型,fallback 放一条中文成本友好的模型。
  • 国际平台机器人:主模型用国外 provider,图片或摘要任务再单独补 imageModel。

具体怎么搭,可以继续看 模型 fallback 与混合调用实践

国外路线最常见的 3 种接法

  • 内置 provider:OpenAI、Anthropic、Gemini、OpenRouter 这几条优先按官方 provider 向导走,最省心。
  • provider catalog / 版本相关入口:xAI、Groq、Mistral 这类要先看你当前 OpenClaw 版本的 provider catalog 有没有现成入口。
  • custom provider / OpenAI-compatible endpoint:对聚合站、社区中转、公司网关或未内置的国外平台,这一路最稳。

官方参考