模型配置

OpenClaw 支持多种 AI 模型，你可以根据需求选择。

支持的模型提供商

提供商	环境变量	推荐模型
Anthropic	ANTHROPIC_API_KEY	Claude Opus 4.6（最强）
OpenAI	OPENAI_API_KEY	GPT-4o
Google	GEMINI_API_KEY	Gemini 2.5 Pro
OpenRouter	OPENROUTER_API_KEY	300+ 模型聚合
Ollama	本地运行	Llama 3、Qwen 等

配置 API Key

编辑 ~/.openclaw/.env：

# Anthropic（社区推荐首选）
ANTHROPIC_API_KEY=sk-ant-api03-xxxxx

# OpenAI
OPENAI_API_KEY=sk-xxxxx

# Google Gemini
GEMINI_API_KEY=AIzaSyxxxxx

# OpenRouter（一个 Key 用所有模型）
OPENROUTER_API_KEY=sk-or-v1-xxxxx

设置主模型

# 查看可用模型
openclaw models list

# 设置主模型
openclaw models set anthropic/claude-opus-4-6

# 添加备选模型（主模型不可用时自动切换）
openclaw models fallbacks add openai/gpt-4o
openclaw models fallbacks add google/gemini-2.5-pro

聊天中切换模型

在对话中直接发送命令：

/model openai/gpt-4o
/model anthropic/claude-sonnet-4-6

使用 Ollama 本地模型

如果你不想用云端 API，可以用 Ollama 运行本地模型：

# 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh

# 下载模型
ollama pull llama3.1
ollama pull qwen2.5

# 在 OpenClaw 中配置
openclaw models set ollama/llama3.1

模型选择建议

• 日常使用：Claude Sonnet 4.6（性价比高）
• 复杂任务：Claude Opus 4.6（Agent 执行最强）
• 预算有限：Ollama 本地模型（完全免费）
• 想要灵活：OpenRouter（一个 Key 切换所有模型）

模型故障转移

OpenClaw 支持自动故障转移，当主模型不可用时自动切换到备选模型：

# 配置故障转移链
openclaw models set anthropic/claude-opus-4-6
openclaw models fallbacks add anthropic/claude-sonnet-4-6
openclaw models fallbacks add openai/gpt-4o

也可以在配置文件 ~/.openclaw/openclaw.json 中直接编辑：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-6",
        "fallbacks": [
          "anthropic/claude-sonnet-4-6",
          "openai/gpt-4o"
        ]
      }
    }
  }
}