kimi-integration

本 Skill 为 Clawdbot 用户提供完整的 Moonshot AI（Kimi K2.5）与 Kimi Code 双模型家族集成方案。核心用法涵盖从 API 密钥获取、环境变量配置到 JSON5 配置文件编写的全流程，支持通过 moonshot 与 kimicode 双提供商并行部署，并可利用别名系统实现 /model k25 与 /model kimi 的快速切换。

显著优点包括：一是双模型协同能力，Kimi K2.5 提供 200K 超长上下文适用于通用任务，Kimi Code 则针对编程场景优化；二是采用 OpenAI 兼容 API 格式，降低迁移成本；三是配置文档详尽，包含分步验证命令与故障排查指南（如 clawdbot models list 检测与 curl 直连测试）；四是支持环境变量注入与 .env 文件管理，避免硬编码敏感信息。

潜在局限性在于：需分别向 Moonshot 与 Kimi Code 平台申请两套独立 API Key，增加了密钥管理复杂度；配置涉及多步骤 JSON 编辑与命令行操作，对非技术用户门槛较高；作为 T3 社区来源，虽经安全审计但缺乏官方企业级背书；且依赖外部 API 服务稳定性，内网环境或无境外访问权限场景下无法使用。

适合目标群体包括：需要在 Clawdbot 中接入国产大模型的开发者、追求长上下文窗口（200K）的研究人员、以及希望分离通用对话与代码生成工作流的工程团队。特别适用于已有 Kimi API 额度且熟悉命令行配置的技术用户。

使用风险方面：主要涉及 API 密钥泄露风险（需妥善保管 sk- 开头的密钥）、网络连接依赖性（需访问 api.moonshot.cn 与 api.kimi.com）、以及 curl 测试脚本可能产生的实际 API 调用费用。建议用户在测试前确认密钥有效性，并避免在公共日志中输出配置详情。

核心用法

本Skill提供Clawdbot与Moonshot AI（Kimi K2系列）及Kimi Code的完整集成方案，涵盖双平台API密钥获取、环境变量配置、JSON5配置文件编写及模型切换命令。

关键配置要点：

• Moonshot AI：端点https://api.moonshot.cn/v1，支持K2.5（200K上下文）、Moonlight V1等通用模型
• Kimi Code：独立端点https://api.kimi.com/coding/v1，专用于代码生成任务
• 两平台API密钥分离管理，均需以sk-开头
• 通过clawdbot.json的providers字段定义多源模型，支持别名简化切换（如/model k25、/model kimi）

显著优点

1. 国产模型深度适配：针对Kimi系列200K超长上下文窗口优化配置，超越多数国际开源模型
2. 双模式灵活部署：通用对话（K2.5）与专业编程（Kimi Code）可并行配置，按需切换
3. 零代码集成：纯JSON配置驱动，无需修改Clawdbot核心代码
4. 安全实践完备：文档强制要求环境变量管理密钥，杜绝硬编码泄露风险

潜在局限

• 密钥管理复杂度：双平台需分别申请、分别配置，增加运维负担
• 网络可达性：依赖Moonshot官方API，存在区域网络波动可能
• 成本透明度：Kimi Code计费模式独立于通用模型，需分别监控用量

适合人群

• 需要超长上下文（100K+）处理长文档、代码仓库的开发者
• 寻求GPT-4/Claude替代方案的国产AI应用构建者
• 已通过Clawdbot架构部署多模型路由的技术团队

常规风险

1. 密钥泄露：若用户忽视文档警告将密钥写入配置文件，存在版本控制泄露风险
2. 端点混淆：Moonshot与Kimi Code端点不同，配置错误导致认证失败
3. 成本控制：200K上下文模型调用成本较高，需配合Clawdbot用量监控

安全评估

安全认证报告显示本Skill为S级（92分），六维检测全通过：静态分析95分（无危险函数）、动态行为90分（curl仅访官方API）、隐私合规95分（无数据收集）。所有外部调用均经TLS 1.2+加密，符合GDPR数据最小化原则。