github star gitee star atomgit star PyPI Downloads AI 编程 AI 交流群

大家好，我是正在实战各种AI项目的程序员晚枫。

今天我们来配置AI模型提供商，让OpenClaw真正拥有AI大脑。这是非常关键的一步——配置好模型，OpenClaw才能真正帮你干活。

🚀 开篇：模型是什么？

先回答一个新手常见问题：什么是模型？

简单理解：模型就是一个"AI大脑"。不同的模型就是不同公司的"大脑"，有聪明的，有笨的，有贵的，有便宜的。

OpenClaw支持接入多个"大脑"，你可以同时配置Claude、GPT、国产大模型等。

OpenClaw支持的模型提供商一览

提供商代表模型特点国内访问推荐指数
AnthropicClaude 3 Opus/Sonnet/Haiku代码能力强，推理优秀❌ 需代理⭐⭐⭐⭐
OpenAIGPT-4/GPT-3.5通用能力强，生态完善❌ 需代理⭐⭐⭐⭐
GoogleGemini Pro/Ultra多模态强，免费额度多⚠️ 部分可用⭐⭐⭐
MoonshotKimi K2.5长文本处理强✅ 直接访问⭐⭐⭐⭐⭐
GLMChatGLM-4中文理解好✅ 直接访问⭐⭐⭐⭐
Qianfan文心一言百度出品✅ 直接访问⭐⭐⭐
MiniMaxabab6字节系✅ 直接访问⭐⭐⭐
Hunyuan混元腾讯出品✅ 直接访问⭐⭐⭐

获取API密钥 🔑

Anthropic (Claude)

官网：https://console.anthropic.com/

注册步骤：

  1. 访问 https://console.anthropic.com/
  2. 点击 Sign Up 注册账号
  3. 登录后进入 Settings → API Keys
  4. 点击 Create Key，复制保存

💡 提示：新账号有$5免费额度，可以先用完再充值。

OpenAI

官网：https://platform.openai.com/

注册步骤：

  1. 访问 https://platform.openai.com/
  2. Sign Up 注册账号
  3. 绑定信用卡（必需，国内卡可能不行）
  4. 进入 API Keys 页面
  5. 创建 Secret Key

⚠️ 注意：需要海外信用卡，国内卡基本无法绑定。

Moonshot (Kimi) ⭐推荐国内用户

官网：https://platform.moonshot.cn/

注册步骤：

  1. 访问 https://platform.moonshot.cn/
  2. 用国内手机号注册
  3. 进入 API Key 管理
  4. 创建 Key 并保存

💡 优势：

  • 国内直接访问，速度快 ✅
  • 新用户有15元免费额度
  • 价格便宜，性价比高
  • 支持超长上下文（128K）

配置Anthropic (Claude)

编辑 ~/.openclaw/openclaw.json：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
{
  "providers": {
    "anthropic": {
      "enabled": true,
      "apiKey": "sk-ant-api03-xxxxx",
      "baseUrl": "https://api.anthropic.com",

      "defaultModel": "claude-3-sonnet",
      "defaultParams": {
        "max_tokens": 4096,
        "temperature": 0.7
      },

      "models": {
        "claude-3-opus": {
          "id": "claude-3-opus-20240229",
          "name": "Claude 3 Opus",
          "description": "最强推理能力，适合复杂任务",
          "maxTokens": 4096,
          "contextWindow": 200000,
          "inputPrice": 0.015,
          "outputPrice": 0.075
        },
        "claude-3-sonnet": {
          "id": "claude-3-sonnet-20240229",
          "name": "Claude 3 Sonnet",
          "description": "平衡性能与成本，日常使用推荐",
          "maxTokens": 4096,
          "contextWindow": 200000,
          "inputPrice": 0.003,
          "outputPrice": 0.015
        },
        "claude-3-haiku": {
          "id": "claude-3-haiku-20240307",
          "name": "Claude 3 Haiku",
          "description": "快速响应，成本最低",
          "maxTokens": 4096,
          "contextWindow": 200000,
          "inputPrice": 0.00025,
          "outputPrice": 0.00125
        }
      }
    }
  }
}

价格说明（每1000 tokens，美元）：

模型输入价格输出价格推荐场景
Opus$0.015$0.075复杂推理、架构设计
Sonnet$0.003$0.015日常使用 ✅
Haiku$0.00025$0.00125简单任务、快速响应

配置OpenAI

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
{
  "providers": {
    "openai": {
      "enabled": true,
      "apiKey": "sk-xxxxx",
      "baseUrl": "https://api.openai.com/v1",

      "defaultModel": "gpt-4",

      "models": {
        "gpt-4": {
          "id": "gpt-4",
          "maxTokens": 8192,
          "contextWindow": 8192,
          "description": "通用能力强"
        },
        "gpt-4-turbo": {
          "id": "gpt-4-turbo-preview",
          "maxTokens": 4096,
          "contextWindow": 128000,
          "description": "更快、更便宜"
        },
        "gpt-3.5-turbo": {
          "id": "gpt-3.5-turbo",
          "maxTokens": 4096,
          "contextWindow": 16385,
          "description": "最便宜，够用"
        }
      }
    }
  }
}

配置国产大模型

Moonshot (Kimi) ⭐⭐⭐⭐⭐

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
{
  "providers": {
    "moonshot": {
      "enabled": true,
      "apiKey": "sk-xxxxx",
      "baseUrl": "https://api.moonshot.cn/v1",
      "defaultModel": "moonshot-v1-8k",

      "models": {
        "moonshot-v1-8k": {
          "id": "moonshot-v1-8k",
          "maxTokens": 8192,
          "contextWindow": 8192,
          "description": "日常对话推荐，便宜好用"
        },
        "moonshot-v1-32k": {
          "id": "moonshot-v1-32k",
          "maxTokens": 32768,
          "contextWindow": 32768,
          "description": "长文本分析"
        },
        "moonshot-v1-128k": {
          "id": "moonshot-v1-128k",
          "maxTokens": 131072,
          "contextWindow": 131072,
          "description": "超长上下文，整本书都能读"
        }
      }
    }
  }
}

价格参考（人民币/百万tokens）：

  • moonshot-v1-8k：输入1元，输出2元
  • moonshot-v1-32k：输入2元，输出4元
  • moonshot-v1-128k：输入4元，输出8元

GLM (智谱AI)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
  "providers": {
    "glm": {
      "enabled": true,
      "apiKey": "xxxxx.xxxxx",
      "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
      "defaultModel": "glm-4",

      "models": {
        "glm-4": {
          "id": "glm-4",
          "maxTokens": 4096,
          "contextWindow": 128000,
          "description": "中文理解好"
        },
        "glm-4-air": {
          "id": "glm-4-air",
          "maxTokens": 4096,
          "contextWindow": 128000,
          "description": "便宜版"
        }
      }
    }
  }
}

阿里千问 (Qwen)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
  "providers": {
    "qwen": {
      "enabled": true,
      "apiKey": "your-api-key",
      "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
      "defaultModel": "qwen-plus",

      "models": {
        "qwen-plus": {
          "id": "qwen-plus",
          "maxTokens": 8192,
          "contextWindow": 32768
        },
        "qwen-max": {
          "id": "qwen-max",
          "maxTokens": 8192,
          "contextWindow": 32768,
          "description": "最强版"
        }
      }
    }
  }
}

腾讯混元 (Hunyuan)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "providers": {
    "hunyuan": {
      "enabled": true,
      "apiKey": "your-secret-key",
      "baseUrl": "https://hunyuan.cloud.tencent.com/v1",
      "defaultModel": "hunyuan-pro",

      "models": {
        "hunyuan-pro": {
          "id": "hunyuan-pro",
          "maxTokens": 8192,
          "contextWindow": 32000
        }
      }
    }
  }
}

多模型负载均衡配置 ⭐

同时配置多个提供商，实现故障自动切换，保证服务稳定：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{
  "routing": {
    "strategy": "failover",
    "providers": ["moonshot", "anthropic", "openai"],
    "timeout": 30000,
    "retry": 3,
    "fallback": "moonshot"
  },

  "providers": {
    "anthropic": {
      "enabled": true,
      "priority": 1,
      "apiKey": "${ANTHROPIC_KEY}"
    },
    "moonshot": {
      "enabled": true,
      "priority": 2,
      "apiKey": "${MOONSHOT_KEY}"
    },
    "openai": {
      "enabled": true,
      "priority": 3,
      "apiKey": "${OPENAI_KEY}"
    }
  }
}

策略说明：
| 策略 | 说明 | 推荐场景 |
|------|------|---------|
| failover | 主模型失败时自动切换到备用 | 追求稳定 ✅ |
| round-robin | 轮询使用各模型 | 追求均衡 |
| random | 随机选择 | 测试环境 |

工作原理：

1
2
3
4
5
6
7
用户发送消息
    ↓
尝试 Claude → 成功 → 返回结果
    ↓ 失败
尝试 DeepSeek → 成功 → 返回结果
    ↓ 失败
尝试 混元 → 返回结果 或 报错

测试模型连接 🔧

配置完成后，测试是否成功：

1
2
3
4
5
6
7
8
9
# 查看已配置的提供商
openclaw providers list

# 测试特定提供商
openclaw providers test anthropic
openclaw providers test moonshot

# 查看模型状态
openclaw models list

在Control UI中测试

打开 http://127.0.0.1:18789/，在Chat界面发送测试消息：

1
你好，请介绍一下你自己，用一句话说明你是谁

如果能收到回复，说明配置成功！🎉

成本优化技巧 💰

1. 按场景选择模型

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
  "routing": {
    "rules": [
      {
        "condition": "contains(prompt, '代码') or contains(prompt, '代码')",
        "provider": "anthropic",
        "model": "claude-3-sonnet"
      },
      {
        "condition": "length(prompt) > 50000",
        "provider": "moonshot",
        "model": "moonshot-v1-128k"
      },
      {
        "default": true,
        "provider": "moonshot",
        "model": "moonshot-v1-8k"
      }
    ]
  }
}

2. 设置用量限制

1
2
3
4
5
6
7
8
9
10
11
12
{
  "usage": {
    "limits": {
      "daily": 1000000,
      "monthly": 20000000
    },
    "alerts": {
      "threshold": 0.8,
      "webhook": "https://your-webhook.com/alert"
    }
  }
}

3. 推荐配置方案

场景推荐配置月成本估计
学习尝鲜Moonshot免费额度0元
日常使用Moonshot Pro50-100元
专业开发Claude Sonnet + Moonshot备份200-400元
企业级Claude Opus + 多模型组合1000元+

快速开始：新手推荐配置

如果你不想折腾，直接复制这个配置：

1
2
3
4
5
6
7
8
9
10
{
  "providers": {
    "moonshot": {
      "enabled": true,
      "apiKey": "你的moonshot-key",
      "baseUrl": "https://api.moonshot.cn/v1",
      "defaultModel": "moonshot-v1-8k"
    }
  }
}

然后去 https://platform.moonshot.cn/ 注册拿API Key，填进去就能用了。

下节预告

下一讲进入第二阶段：通道连接，学习如何连接Telegram，让你的AI助手能在聊天软件中使用。

👉 继续阅读：第6讲-Telegram通道连接与Bot部署

💬 加入学习交流群

模型配置问题？加群交流：

👉 点击加入交流群

推荐：AI Python编程实战营

🎁 限时福利：送《利用Python进行数据分析》实体书

👉 点击了解详情

---## 📚 完整学习路线这是OpenClaw入门课程的第X讲。查看完整课程大纲：👉 **OpenClaw入门课程大纲**课程包含30讲，从安装部署到实战项目，带你全面掌握OpenClaw。

课程导航

上一篇： 第4讲-配置文件详解

下一篇： 第6讲-Telegram通道连接与Bot部署

PS：建议先配置一个国内模型（如Moonshot）和一个国外模型（如Claude），这样既有稳定性又有高性能。

💬 联系我

平台账号/链接
微信扫码加好友
微博@程序员晚枫
知乎@程序员晚枫
抖音@程序员晚枫
小红书@程序员晚枫
B 站Python 自动化办公社区

主营业务：AI 编程培训、企业内训、技术咨询

🎓 AI 编程实战课程

想系统学习 AI 编程？程序员晚枫的 AI 编程实战课 帮你从零上手！