模型配置

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

支持的模型提供商

云端模型

提供商	provider 值	支持的模型	特点
Anthropic	anthropic	Claude 3.5 Sonnet, Claude 3 Opus	推理能力强，适合复杂任务
OpenAI	openai	GPT-4, GPT-4 Turbo, GPT-3.5	生态完善，通用性强
Google	google	Gemini Pro, Gemini Ultra	多模态支持
Kimi	kimi	Kimi-K2.5	中文能力强
MiniMax	minimax	MiniMax-M2.5	国内服务稳定
DeepSeek	deepseek	DeepSeek Chat	性价比高

本地模型

提供商	provider 值	说明
Ollama	ollama	本地运行，隐私安全
LM Studio	lmstudio	图形界面，易于使用
LocalAI	localai	兼容 OpenAI API

配置方法

Anthropic Claude

{
  "model": {
    "provider": "anthropic",
    "modelId": "claude-3-5-sonnet-20241022",
    "apiKey": "sk-ant-xxx",
    "temperature": 0.7,
    "maxTokens": 4096
  }
}

获取 API Key: https://console.anthropic.com/

OpenAI GPT

{
  "model": {
    "provider": "openai",
    "modelId": "gpt-4-turbo",
    "apiKey": "sk-xxx",
    "temperature": 0.7,
    "maxTokens": 4096
  }
}

获取 API Key: https://platform.openai.com/api-keys

Google Gemini

{
  "model": {
    "provider": "google",
    "modelId": "gemini-pro",
    "apiKey": "xxx",
    "temperature": 0.7
  }
}

获取 API Key: https://aistudio.google.com/

Kimi

{
  "model": {
    "provider": "kimi",
    "modelId": "kimi-k2.5",
    "apiKey": "xxx"
  }
}

获取 API Key: https://platform.moonshot.cn/

Ollama (本地)

{
  "model": {
    "provider": "ollama",
    "modelId": "llama3",
    "baseUrl": "http://localhost:11434"
  }
}

安装 Ollama: https://ollama.ai/

# 下载模型
ollama pull llama3

# 启动服务
ollama serve

多模型配置

OpenClaw 支持配置多个模型，按需切换：

{
  "models": {
    "default": "claude",
    "claude": {
      "provider": "anthropic",
      "modelId": "claude-3-5-sonnet-20241022",
      "apiKey": "sk-ant-xxx"
    },
    "gpt": {
      "provider": "openai",
      "modelId": "gpt-4-turbo",
      "apiKey": "sk-xxx"
    },
    "local": {
      "provider": "ollama",
      "modelId": "llama3"
    }
  }
}

切换模型：

openclaw model switch gpt

模型参数

常用参数

参数	说明	默认值
temperature	创造性程度 (0-1)	0.7
maxTokens	最大输出 token 数	4096
topP	核采样参数	1.0
frequencyPenalty	频率惩罚	0
presencePenalty	存在惩罚	0

参数优化建议

精确任务（代码生成、数据分析）：

{
  "temperature": 0.3,
  "maxTokens": 2048
}

创意任务（内容创作、头脑风暴）：

{
  "temperature": 0.8,
  "maxTokens": 4096
}

嵌入模型配置

用于记忆和搜索的向量嵌入：

{
  "embedding": {
    "provider": "openai",
    "modelId": "text-embedding-3-small",
    "apiKey": "sk-xxx"
  }
}

支持的嵌入模型：

提供商	模型	维度
OpenAI	text-embedding-3-small	1536
OpenAI	text-embedding-3-large	3072
Google	text-embedding-004	768

模型选择建议

按任务类型

任务类型	推荐模型	原因
代码开发	Claude 3.5 Sonnet	代码能力强
文本创作	GPT-4 Turbo	创意性高
中文处理	Kimi-K2.5	中文优化
隐私敏感	Ollama + Llama3	本地运行
高性价比	DeepSeek Chat	价格低

按成本考虑

高预算：Claude 3.5 Sonnet > GPT-4 Turbo > Gemini Pro

中等预算：Kimi-K2.5 > MiniMax-M2.5

低预算：DeepSeek Chat > 本地模型

API 代理配置

如果需要通过代理访问 API：

{
  "model": {
    "provider": "openai",
    "modelId": "gpt-4-turbo",
    "apiKey": "sk-xxx",
    "baseUrl": "https://api-proxy.example.com/v1",
    "proxy": {
      "enabled": true,
      "url": "http://127.0.0.1:7890"
    }
  }
}

错误处理

常见错误

错误	原因	解决方案
API_KEY_INVALID	API Key 无效	检查 API Key 是否正确
RATE_LIMITED	请求频率超限	降低请求频率或升级套餐
MODEL_NOT_FOUND	模型不存在	检查模型 ID 是否正确
QUOTA_EXCEEDED	配额用尽	充值或等待重置

自动重试

{
  "model": {
    "retry": {
      "enabled": true,
      "maxAttempts": 3,
      "delay": 1000
    }
  }
}

监控和日志

查看模型使用统计

openclaw model stats

查看 API 调用日志

openclaw logs --filter model

下一步

• 基础配置
• API 参考
• 性能优化