Kimi模型集成

为Clawdbot添加Moonshot AI（Kimi）和Kimi Code模型的完整指南。

概述

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密钥部分
4. 创建新的API密钥
5. 复制密钥（以sk-...开头）

Kimi 代码

1. 访问https://api.kimi.com/coding
2. 注册一个账户
3. 导航到 API 密钥部分
4. 创建一个新的 API 密钥
5. 复制密钥（以sk-...开头

）注意：

Moonshot 和 Kimi 代码使用独立的密钥和端点。

集成步骤

选项一：Moonshot AI（Kimi K2 模型）

export MOONSHOT_API_KEY="sk-your-moonshot-key-here"

步骤 1：设置环境变量或添加到.env

echo 'MOONSHOT_API_KEY="sk-your-moonshot-key-here"' >> ~/.env

文件中：

步骤 2：添加提供商配置编辑您的clawdbot.json

{
  "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
          }
        ]
      }
    }
  }
}

配置文件：

clawdbot gateway restart

步骤 3：重启 Clawdbot

clawdbot models list

步骤 4：验证集成

步骤五：使用模型

设为默认：

clawdbot models set moonshot/kimi-k2.5

或在聊天中使用模型别名：

/model moonshot/kimi-k2.5

选项二：Kimi Code（专用编程模型）

步骤一：设置环境变量

export KIMICODE_API_KEY="sk-your-kimicode-key-here"

或添加到.env文件中：

echo 'KIMICODE_API_KEY="sk-your-kimicode-key-here"' >> ~/.env

步骤二：添加提供商配置

编辑您的clawdbot.json配置文件：

{
  "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
          }
        ]
      }
    }
  }
}

步骤三：重启Clawdbot

clawdbot gateway restart

步骤四：验证集成

clawdbot models list

您应该能看到kimicode/kimi-for-coding出现在列表中。

步骤五：使用模型

设为默认：

clawdbot models set kimicode/kimi-for-coding

或在聊天中使用模型别名：

/model kimi

同时使用两个提供商

您可以同时配置Moonshot和Kimi Code：

{
  "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 代码专用版（专业型）

故障排除

模型未出现在列表中

检查配置语法：

clawdbot gateway config.get | grep -A 20 moonshot

验证API密钥是否已设置：

echo $MOONSHOT_API_KEY
echo $KIMICODE_API_KEY

身份验证错误

• 验证API密钥以sk-
• 开头
• 在提供商控制面板检查密钥是否有效

确保每个提供商的基址URL正确

连接问题

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"}]}'

直接测试API端点：

• 模型推荐Kimi K2.5（moonshot/kimi-k2.5
• ）- 最适合通用任务，200K上下文Kimi 代码专用版（) - 专为代码生成而设计
• 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