介绍
# Kimi Model Integration
将 Moonshot AI (Kimi) 和 Kimi Code 模型添加到 Clawdbot 的完整指南。
## 概述
Kimi 提供两个独立的模型系列：
1. **Moonshot AI (Kimi K2)** - 通过 OpenAI 兼容 API 提供的通用模型 2. **Kimi Code** - 具有专用终端节点的专用编程模型
两者都需要从不同来源获取的 API 密钥。
## 前置条件
- Clawdbot 已安装并配置 - API 密钥（请参阅“获取 API 密钥”部分）
## 获取 API 密钥
### Moonshot AI (Kimi K2)
1. 访问 https://platform.moonshot.cn 2. 注册账号 3. 导航至 API Keys 部分 4. 创建新的 API 密钥 5. 复制该密钥（以 `sk-...` 开头）
### Kimi Code
1. 访问 https://api.kimi.com/coding 2. 注册账号 3. 导航至 API Keys 部分 4. 创建新的 API 密钥 5. 复制该密钥（以 `sk-...` 开头）
**注意：** Moonshot 和 Kimi Code 使用独立的密钥和终端节点。
## 集成步骤
### 选项 1：Moonshot AI (Kimi K2 模型)
#### 步骤 1：设置环境变量
```bash export MOONSHOT_API_KEY="sk-your-moonshot-key-here" ```
或添加到 `.env` 文件：
```bash echo 'MOONSHOT_API_KEY="sk-your-moonshot-key-here"' >> ~/.env ```
#### 步骤 2：添加提供商配置
编辑您的 `clawdbot.json` 配置：
```json5 { "agents": { "defaults": { "model": { "primary": "moonshot/kimi-k2.5" } } }, "models": { "mode": "merge", "providers": { "moonshot": { "baseUrl": "https://api.moonshot.cn/v1", "apiKey": "${MOONSHOT_API_KEY}", "api": "openai-completions", "models": [ { "id": "moonlight-v1-32k", "name": "Moonlight V1 32K", "contextWindow": 32768 }, { "id": "moonshot-v1-8k", "name": "Moonshot V1 8K", "contextWindow": 8192 }, { "id": "moonshot-v1-32k", "name": "Moonshot V1 32K", "contextWindow": 32768 }, { "id": "moonshot-v1-128k", "name": "Moonshot V1 128K", "contextWindow": 131072 }, { "id": "kimi-k2.5", "name": "Kimi K2.5", "contextWindow": 200000 } ] } } } } ```
#### 步骤 3：重启 Clawdbot
```bash clawdbot gateway restart ```
#### 步骤 4：验证集成
```bash clawdbot models list ```
您应该在列表中看到 Moonshot 模型。
#### 步骤 5：使用模型
设置为默认： ```bash clawdbot models set moonshot/kimi-k2.5 ```
或在聊天中使用模型别名： ```bash /model moonshot/kimi-k2.5 ```
### 选项 2：Kimi Code（专用编程模型）
#### 步骤 1：设置环境变量
```bash export KIMICODE_API_KEY="sk-your-kimicode-key-here" ```
或添加到 `.env`：
```bash echo 'KIMICODE_API_KEY="sk-your-kimicode-key-here"' >> ~/.env ```
#### 步骤 2：添加提供商配置
编辑您的 `clawdbot.json` 配置：
```json5 { "agents": { "defaults": { "model": { "primary": "kimicode/kimi-for-coding" }, "models": { "kimicode/kimi-for-coding": { "alias": "kimi" } } } }, "models": { "mode": "merge", "providers": { "kimicode": { "baseUrl": "https://api.kimi.com/coding/v1", "apiKey": "${KIMICODE_API_KEY}", "api": "openai-completions", "models": [ { "id": "kimi-for-coding", "name": "Kimi For Coding", "contextWindow": 200000, "maxTokens": 8192 } ] } } } } ```
#### 步骤 3：重启 Clawdbot
```bash clawdbot gateway restart ```
#### 步骤 4：验证集成
```bash clawdbot models list ```
您应该在列表中看到 `kimicode/kimi-for-coding`。
#### 步骤 5：使用模型
设置为默认： ```bash clawdbot models set kimicode/kimi-for-coding ```
或在聊天中使用模型别名： ```bash /model kimi ```
## 同时使用两个提供商
您可以同时配置 Moonshot 和 Kimi Code：
```json5 { "agents": { "defaults": { "model": { "primary": "moonshot/kimi-k2.5" }, "models": { "kimicode/kimi-for-coding": { "alias": "kimi" }, "moonshot/kimi-k2.5": { "alias": "k25" } } } }, "models": { "mode": "merge", "providers": { "moonshot": { "baseUrl": "https://api.moonshot.cn/v1", "apiKey": "${MOONSHOT_API_KEY}", "api": "openai-completions", "models": [ { "id": "kimi-k2.5", "name": "Kimi K2.5", "contextWindow": 200000 } ] }, "kimicode": { "baseUrl": "https://api.kimi.com/coding/v1", "apiKey": "${KIMICODE_API_KEY}", "api": "openai-completions", "models": [ { "id": "kimi-for-coding", "name": "Kimi For Coding", "contextWindow": 200000 } ] } } } } ```
使用别名切换模型： - `/model k25` - Kimi K2.5（通用） - `/model kimi` - Kimi for Coding（专用）
## 故障排除
### 模型未出现在列表中
检查配置语法： ```bash clawdbot gateway config.get | grep -A 20 moonshot ```
验证 API 密钥是否已设置： ```bash echo $MOONSHOT_API_KEY echo $KIMICODE_API_KEY ```
### 认证错误
- 验证 API 密钥以 `sk-` 开头 - 在提供商控制台检查密钥是否有效 - 确保每个提供商的 Base URL 正确
### 连接问题
直接测试 API 终端节点： ```bash curl -X POST "https://api.moonshot.cn/v1/chat/completions" \ -H "Authorization: Bearer $MOONSHOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "kimi-k2.5", "messages": [{"role": "user", "content": "test"}]}' ```
## 模型推荐
- **Kimi K2.5** (`moonshot/kimi-k2.5`) - 最适合通用任务，200K 上下文 - **Kimi for Coding** (`kimicode/kimi-for-coding`) - 专用于代码生成 - **Moonshot V1 128K** (`moonshot/moonshot-v1-128k`) - 旧版模型，128K 上下文
## 参考
- Moonshot AI 文档: https://platform.moonshot.cn/docs - Kimi Code API: https://api.kimi.com/coding/docs - Clawdbot 模型提供商: /home/eyurc/clawdbot/docs/concepts/model-providers.md