名称： kimi-integration
描述： 在 Clawdbot 中集成 Moonshot AI (Kimi) 和 Kimi Code 模型的逐步指南。当用户询问如何添加 Kimi 模型、配置 Moonshot AI 或在 Clawdbot 中设置 Kimi for Coding 时使用。

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 Code

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

注意： Moonshot 和 Kimi Code 使用独立的密钥和端点。

集成步骤

选项 1：集成 Moonshot AI (Kimi K2 模型)

步骤 1：设置环境变量

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

或添加到 .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
          }
        ]
      }
    }
  }
}

步骤 3：重启 Clawdbot

clawdbot gateway restart

步骤 4：验证集成

clawdbot models list

你应该能在列表中看到 Moonshot 模型。

步骤 5：使用模型

设置为默认模型：

clawdbot models set moonshot/kimi-k2.5

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

/model moonshot/kimi-k2.5

选项 2：集成 Kimi Code (专业代码模型)

步骤 1：设置环境变量

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

或添加到 .env 文件：

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

步骤 2：添加提供商配置

编辑你的 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
          }
        ]
      }
    }
  }
}

步骤 3：重启 Clawdbot

clawdbot gateway restart

步骤 4：验证集成

clawdbot models list

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

步骤 5：使用模型

设置为默认模型：

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 for Coding (专业代码模型)

故障排除

模型未出现在列表中

检查配置语法：

clawdbot gateway config.get | grep -A 20 moonshot

验证 API 密钥是否已设置：

echo $MOONSHOT_API_KEY
echo $KIMICODE_API_KEY

认证错误

• 确认 API 密钥以 sk- 开头
• 在提供商控制台检查密钥是否有效
• 确保每个提供商的 base URL 正确

连接问题

直接测试 API 端点：

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