> For the complete documentation index, see [llms.txt](https://yeasy.gitbook.io/openclaw_guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://yeasy.gitbook.io/openclaw_guide/di-si-bu-fen-shi-zhan-yu-you-hua-shen-du-zhi-nan/16_claude_ecosystem/16.1_claude_integration.md). # 16.1 Claude 模型接入与 MCP 生态集成 本节讲清 OpenClaw 如何与 Claude 模型家族对接，以及如何通过 MCP 协议将外部数据源和工具接入智能体。模型供应商接入的基础配置已在 [4.2 模型供应商接入与认证方式](/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/04_config_models/4.2_provider_access.md) 中详述，模型选择与 Fallback 链路见 [4.3](/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/04_config_models/4.3_model_selection.md) 和 [4.4](/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/04_config_models/4.4_failover.md)。本节在此基础上，聚焦 Claude 生态特有的集成要点。 ## 16.1.1 Claude 模型家族速览 Anthropic 的 Claude 模型长期按能力与成本分为三个系列（2026-06-09 起，新一代 Fable 5 / Mythos 5 位于这三档之上；两者曾于 2026-06-12 被暂停访问，官方模型页此后已恢复 Fable 5 为正常提供、Mythos 5 为受限可用）： | 系列 | 定位 | 上下文（当前 OpenClaw 侧） | 备注 | | -------------- | ------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | | **Haiku 4.5** | 低延迟、低成本 | 200K | 适合高频低成本场景；支持 Extended Thinking（非 Adaptive） | | **Sonnet 4.6** | 均衡性价比 | Anthropic 官方能力为 1M；OpenClaw 当前 direct API 路径仍通过 `params.context1m: true` 显式请求，且凭据需具备资格 | OpenClaw 当前默认走 adaptive thinking | | **Opus 4.6** | 强推理能力 | Anthropic 官方能力为 1M；OpenClaw 当前 direct API 路径仍通过 `params.context1m: true` 显式请求，且凭据需具备资格 | OpenClaw 当前默认走 adaptive thinking | | **Sonnet 5** | Sonnet 档新主力（2026-06-30 发布） | 1M 默认开启 | Adaptive Thinking 默认开启；手动 Extended Thinking 返回 400 | | **Opus 4.7** | Opus 4.8 前代强推理模型 | 1M 默认开启 | thinking 细节以当前 provider/model catalog 为准 | | **Opus 4.8** | Opus 5 之前的 Opus 档模型，官方已列入 legacy | Anthropic 官方默认 1M；OpenClaw 可用性以当前 provider/model catalog 为准 | 默认 `effort=high`，thinking 细节以当前 provider/model catalog 为准 | | **Opus 5** | Opus 档新主力（2026-07-24 发布），官方建议不确定时的默认起点 | Anthropic 官方发布规格为 1M、128K 输出；OpenClaw 可用性以当前 provider/model catalog 为准 | Adaptive Thinking；Claude API 与 Claude Code 上默认 `effort=high`，不支持手动 Extended Thinking | | **Fable 5** | 新一代旗舰：能力最强的广泛发布模型（2026-06-09 GA，$10/$50）；曾于 2026-06-12 短暂暂停访问，此后已恢复 | Anthropic 官方发布规格为 1M、128K 输出；OpenClaw 可用性以当前 provider/model catalog 为准 | Adaptive Thinking 常开（不可关闭）；同日发布的 Mythos 5 仅限受邀（Project Glasswing 受限可用） | > **注意**：模型的具体版本号、上下文窗口大小、定价与访问状态会随 Anthropic 的产品迭代而更新，请以 [Anthropic 官方文档](https://platform.claude.com/docs/en/about-claude/models/overview) 为准。本书示例中的模型标识符（如 `anthropic/claude-sonnet-4-6`）仅反映撰写时的最新版本。 ## 16.1.2 在 OpenClaw 中配置 Claude OpenClaw 使用 `provider/model` 格式的模型标识符。对于 Anthropic 内置供应商，通过 `openclaw onboard` 完成认证后无需手动写 `models.providers`，只需在 `agents.defaults.model` 中指定即可： ```jsonc { agents: { defaults: { model: { primary: "anthropic/claude-sonnet-4-6", fallbacks: [ "", ], }, }, }, } ``` > **生产建议**：低成本或快照模型的具体 ID 变化较快，应以当前 `openclaw models list --all`、`models status --probe` 与 Anthropic 官方模型目录为准；不要把旧示例里的日期后缀当成通用规则。 需要显式配置 `models.providers` 的场景主要是自定义 provider 或代理端点： * **走自建代理**：将 Anthropic 请求转发到内部代理服务器。 * **手工维护私有模型目录**：显式声明 `baseUrl`、`api` 与 `models`。 通过 Google Vertex AI 调用 Claude 时，通常使用 `anthropic-vertex/claude-sonnet-4-6` 这样的模型标识，并通过 GCP ADC、`GOOGLE_APPLICATION_CREDENTIALS`、服务账号或 metadata server credentials 提供凭据；`anthropic-vertex` 不是普通 API key onboarding 路径。多凭据轮换或限流回退更应使用 auth profiles、`auth.order` 或 GCP 侧凭据治理，不要把通用环境变量候选池写成 Vertex 的主接口。 自建代理场景的配置示例： ```jsonc { models: { providers: { anthropic: { apiKey: "${ANTHROPIC_API_KEY}", baseUrl: "https://my-proxy.internal/anthropic/v1", api: "anthropic-messages", models: [{ id: "claude-sonnet-4-6", name: "Claude Sonnet 4.6" }], }, }, }, } ``` ## 16.1.3 Claude 特有的能力与配置要点 Claude 模型有一些区别于其他供应商的特性，在 OpenClaw 中使用时需要特别关注： **扩展上下文窗口**：Anthropic 当前官方能力表中，Claude Sonnet 4.6 与 Opus 4.6 都属于 1M context window 模型；但 OpenClaw 当前 direct API 路径仍通过 `params.context1m: true` 显式请求，并要求凭据具备长上下文资格。更稳妥的做法是同时参考 Anthropic 官方能力说明与本机 `openclaw models list --provider anthropic` 的 catalog。 **扩展思考与自适应思考**：Anthropic 同时提供 Extended Thinking 与 Adaptive Thinking 两类能力，但 OpenClaw 当前最稳定、最明确的默认语义是：**Claude 4.6 系列在未显式指定 thinking level 时默认走 adaptive thinking**。如果你要强制某个模型使用特定 thinking 形态，先以当前 Anthropic 文档与 OpenClaw provider 文档为准，再决定是否覆盖默认行为，而不是把整条 Claude 产品线写成一个固定支持矩阵。 thinking 内容的显示通过 `display` 参数控制，支持 `"summarized"` 或 `"omitted"`，默认值取决于具体 Claude 模型；例如 Sonnet 4.6 / Opus 4.6 与 Opus 4.7 的默认行为不同。所有思考 tokens 均计入 API 消耗。该功能与 OpenClaw 的提示词装配机制兼容。 **工具调用对齐**：Claude 对工具调用（Tool Use）的支持与 OpenClaw 的工具系统天然兼容。Claude 会以结构化 JSON 格式返回工具调用请求，OpenClaw 的 Agent Runtime 自动解析并分发到对应工具。对于需要人工审批的敏感工具调用（如 `exec`），审批流程与 [9.2.4](/openclaw_guide/di-san-bu-fen-shi-xian-yuan-li-yu-gong-cheng-luo-di/09_gateway_protocol/9.2_control_plane.md) 中描述的 Gateway 审批机制一致。 ## 16.1.4 MCP 服务器集成 MCP（Model Context Protocol）是 Anthropic 主导的开放协议，用于标准化 AI 模型与外部数据源、工具之间的通信。OpenClaw 通过内置的 MCP 客户端支持接入 MCP 服务器，使智能体能够访问文件系统、数据库、代码仓库等外部资源。 ### MCP 在 OpenClaw 中的标准与兼容接入方式 | 接入方式 | 通信方式 | 适用场景 | | ------------------------- | ------------------ | ---------------------------------- | | **stdio** | 标准输入/输出 | 本地 MCP 服务器，如文件系统、Git | | **HTTP（Streamable HTTP）** | HTTP 请求/响应，支持流式 | 新远程 MCP 服务、API 网关、云服务 | | **SSE（旧兼容）** | Server-Sent Events | 兼容旧版远程 MCP；新远程服务优先 Streamable HTTP | ### 配置示例 以下是在 OpenClaw 中接入 MCP 服务器的典型配置： ```jsonc { // OpenClaw 管理的 MCP 服务器位于顶层 mcp.servers mcp: { servers: { // GitHub 官方 MCP 服务器（stdio 方式；也可使用官方容器形态） github: { command: "docker", args: [ "run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server", ], env: { GITHUB_PERSONAL_ACCESS_TOKEN: "${GITHUB_PAT}", }, }, // 远程 MCP 服务器（Streamable HTTP 方式） "custom-api": { url: "https://api-gateway.internal/mcp", transport: "streamable-http", headers: { Authorization: "Bearer ${CUSTOM_API_TOKEN}", }, }, }, }, } ``` > **注意**：MCP 服务器的配置格式以 OpenClaw 官方文档为准。社区 MCP 服务器列表和接入指南参见 [MCP 官方仓库](https://github.com/modelcontextprotocol)。 ### MCP 与 OpenClaw 内置工具的关系 OpenClaw 自身的内置工具（文件系统、Shell、浏览器等）通过 Tool Policy 管控（见 [5.2](/openclaw_guide/di-er-bu-fen-jin-jie-shi-yong/05_tools_skills/5.2_tool_policy.md)），与 MCP 服务器提供的工具是**并行存在**的两套能力。区别在于： * **内置工具**：由 Agent Runtime 直接执行，受 Tool Policy 和沙箱策略约束，延迟最低。 * **MCP 工具**：通过 MCP 协议与外部进程通信，适合接入第三方服务、数据库、自定义 API 等 OpenClaw 未内置的能力。 两者可以在同一个智能体中共存。Agent 的模型推理阶段会同时看到内置工具和 MCP 工具的列表，由模型决定调用哪个。 ## 16.1.5 多供应商混合部署 OpenClaw 不绑定单一模型供应商。在生产环境中，常见的做法是混合使用多家供应商以提升可用性和成本效益。Claude 在这一架构中通常作为高质量推理的主力或兜底： | 策略 | 主模型 | Fallback | 适用场景 | | --------- | ----------------------------- | ------------------------------------ | -------- | | Claude 主力 | `anthropic/claude-sonnet-4-6` | `openai/gpt-5.5` | 重视推理质量 | | 成本优先 | 当前目录中的低延迟模型 | `anthropic/claude-sonnet-4-6` | 高并发低成本 | | 跨供应商冗余 | `anthropic/claude-sonnet-4-6` | `anthropic-vertex/claude-sonnet-4-6` | 同模型跨区域容灾 | Fallback 链路的配置方式和行为详见 [4.4 故障转移基础](/openclaw_guide/di-yi-bu-fen-ji-chu-ru-men/04_config_models/4.4_failover.md)。 ***