OpenClaw Docs CN

模型接入 / 栏目总览

模型接入总览

Model Access

模型这一章,不是帮你追榜单,而是帮你先选对路线。

模型接入决定的是 OpenClaw 的“脑子”怎么工作。对大多数用户来说,最稳的顺序不是一上来比谁最强,而是先回答三个问题:你主要做中文还是国际任务,你更看重能力还是成本,你要不要本地可控和 fallback。

先选路线,再选模型 中文用户优先看中国 provider 高可用一定要补 fallback
Problem

这一栏主要帮你解决什么问题

如果模型这一章没理顺,后面你会在成本、中文效果、工具调用稳定性、多渠道机器人一致性上来回踩坑。

不知道该先接中国模型还是国外模型 这一栏会先按任务场景帮你选路线,而不是先丢给你一堆名字。
总把官方 provider 和兼容接口混在一起 不同 provider 的认证方式差别很大,混写以后最容易排障失控。
明明有 API Key,为什么还是不可用 这往往不是 Key 本身坏了,而是 allowlist、fallback 或 provider 方式没配顺。
只配了主模型,没有考虑稳定性 真正长期跑 OpenClaw,主模型决定上限,fallback 决定稳定性。
Four Rules

先记住模型接入最重要的 4 条规则

这 4 条不是进阶知识,而是你后面所有模型页都会反复遇到的基础规则。

模型名统一写成 provider/model

  • zai/glm-5
  • anthropic/claude-opus-4-6
  • 先分 provider,再分具体模型

主模型和 fallback 是两层事

  • primary 决定默认路线
  • fallbacks 决定兜底顺序
  • 别只配主模型不做备用

allowlist 很容易卡住你

  • agents.defaults.models
  • 一旦启用就是允许列表
  • 很多“不能切模型”都是它导致的

兼容接口要按 custom provider 理解

  • OpenAI-compatible endpoint
  • 聚合网关
  • 公司自建 MaaS
Reading Path

最推荐的阅读顺序

这一章最适合按“先做判断,再走路线,再补稳定性”的顺序往下走。

Quick Choice

如果你现在只想解决一个问题

不用整章从头读完,直接按你当前最关心的问题进入。

Route Types

OpenClaw 里的模型路线,主要分 4 类

把这 4 类分清楚,后面你就不会再把“官方 provider、门户登录、兼容接口、聚合网关”混成一件事。

内置 provider 官方目录已带好 provider 和常见认证流程,最适合第一次跑通。
Portal / 插件登录路线 适合 Qwen Portal、MiniMax Portal 这类“不是单纯填 Key”就能完成的路线。
本地与自建服务 Ollama、vLLM 是官方本地路线,其它服务更适合按 custom provider 看。
聚合与代理网关 OpenRouter、LiteLLM、SiliconFlow 等更像统一出口,不等于模型厂商本体。

对中国用户最稳的建议