AI 模型配置

OpenClaw 本身不包含 AI 模型，它通过 API 调用外部模型服务。这里教你选择和配置最适合的模型。

如何选择模型

Anthropic Claude（推荐）

Claude 是 OpenClaw 配合最好的模型，工具调用（tool use）能力最强。

获取 API Key

1. 访问 console.anthropic.com
2. 注册账号（需要海外手机号或 Google 账号）
3. 进入 API Keys 页面
4. 点击 "Create Key"，复制保存
5. 在 Plans & Billing 中添加付款方式并充值

可用模型

• claude-opus-4-6 — 最强模型，适合复杂任务和编程
• claude-sonnet-4-6 — 日常推荐，性价比最高
• claude-haiku-3-5 — 最快最便宜，适合简单问答

OpenAI GPT

获取 API Key

1. 访问 platform.openai.com/api-keys
2. 注册或登录，创建 API Key
3. 充值余额（Pay as you go）

可用模型

• gpt-5.3 — 最新旗舰模型
• gpt-4o — 多模态，支持图片理解
• gpt-4o-mini — 轻量快速，适合简单任务

国内模型

在国内使用海外 API 可能需要代理。如果希望直连，可以选择国内模型。

豆包（火山引擎）

字节跳动旗下的 AI 模型，中文能力出色，国内服务器直连无延迟。

1. 访问 火山引擎控制台
2. 开通 方舟大模型 服务
3. 创建 API Key
4. 推荐模型：doubao-seed-2-0-pro

# 豆包配置示例
providers:
  doubao:
    type: openai-compatible
    baseUrl: https://ark.cn-beijing.volces.com/api/v3
    apiKey: "你的API Key"
    models:
      - doubao-seed-2-0-pro-260215

Moonshot（月之暗面）

支持 128K 超长上下文，适合处理长文档。

1. 访问 platform.moonshot.cn
2. 注册获取 API Key
3. 模型：moonshot-v1-128k

智谱 GLM

清华系 AI 模型，支持代码生成和工具调用。

1. 访问 open.bigmodel.cn
2. 注册获取 API Key
3. 模型：glm-4-plus

OpenRouter 聚合

如果你想用一个 API Key 访问所有模型（Claude、GPT、Gemini、开源模型等），可以用 OpenRouter。

1. 访问 openrouter.ai
2. 注册并充值
3. 获取 API Key

# OpenRouter 配置
providers:
  openrouter:
    type: openrouter
    apiKey: "你的OpenRouter API Key"

配置方法

方式一：使用向导（推荐）

# 首次配置
openclaw onboard

# 修改模型配置
openclaw configure

方式二：手动编辑配置文件

# ~/.openclaw/config.yaml

# 主模型（Agent 使用的模型）
model: anthropic/claude-sonnet-4-6

# Anthropic 配置
anthropic:
  apiKey: "sk-ant-xxxxx"

# 或 OpenAI 配置
openai:
  apiKey: "sk-xxxxx"

方式三：环境变量

# 在 ~/.zshrc 或 ~/.bashrc 中添加
export ANTHROPIC_API_KEY="sk-ant-xxxxx"
export OPENAI_API_KEY="sk-xxxxx"

多模型与故障转移

OpenClaw 支持配置多个模型，实现智能切换和故障转移：

• 按场景切换 — 简单问答用便宜模型，复杂任务自动切到强模型
• 故障转移 — 主模型 API 出错时，自动切换到备用模型
• 手动切换 — 在聊天中用 /model 命令切换当前会话的模型

# 多模型配置示例
model: anthropic/claude-sonnet-4-6

# 模型故障转移链
modelFallback:
  - anthropic/claude-haiku-3-5
  - openai/gpt-4o-mini

成本参考

以下是不同使用强度下的月均成本估算（仅 API 费用）：