OpenClaw 第三方模型接入

OpenClaw 支持多种 AI 模型提供商。本教程介绍如何配置和切换不同的模型。

支持的模型提供商

提供商说明认证方式
AnthropicClaude 系列模型API Key
OpenAIGPT 系列模型API Key / OAuth
GoogleGemini 系列模型API Key
GitHub CopilotCopilot 订阅OAuth
OpenRouter200+ 模型聚合API Key
MiniMax国产模型API Key
Xiaomi MiMo小米自研模型API Key

配置模型认证

Anthropic(Claude)

bash
# 登录认证
openclaw infer auth login --provider anthropic

# 或直接设置 API Key
openclaw infer auth setup-token --provider anthropic
# 按提示输入你的 Anthropic API Key

OpenAI

bash
# OAuth 登录(推荐)
openclaw infer auth login --provider openai

# 或使用 API Key
openclaw infer auth setup-token --provider openai

GitHub Copilot

bash
# OAuth 登录(需要 Copilot 订阅)
openclaw infer auth login-github-copilot

OpenRouter(聚合平台)

bash
# 使用 OpenRouter API Key,可访问 200+ 模型
openclaw infer auth setup-token --provider openrouter

多提供商并存

OpenClaw 支持同时配置多个提供商,使用时可以灵活切换,不需要重新认证。


设置默认模型

bash
# 查看可用模型
openclaw models list

# 设置默认模型
openclaw models set claude-sonnet-4-20250514

# 查看当前模型配置
openclaw models status

模型别名与降级策略

OpenClaw 支持设置模型别名和自动降级:

bash
# 添加模型别名
openclaw models aliases add fast claude-sonnet-4-20250514

# 设置降级模型(主模型不可用时自动切换)
openclaw models fallbacks add claude-sonnet-4-20250514 gpt-4o

查看认证状态

bash
# 查看所有提供商认证状态
openclaw infer auth status

# 查看使用量
openclaw status --usage

配置完成!

模型配置完成后,OpenClaw 会自动使用你设置的默认模型处理请求。 可以随时通过 openclaw models set 切换模型。