Kimi 双模型一键接入指南

Clawdbot 接入 Moonshot AI 与 Kimi Code 模型的完整配置指南，提供双平台 API 密钥获取、JSON5 配置模板及故障排查方案。

基本信息

• 技能名称?Kimi Integration
• 中文名称?Kimi 双模型一键接入指南
• 作者?evgyur
• 分类?专业技能
• 版本?1.0.0
• 标签?moonshot, kimi, api-integration, clawdbot, llm-provider, coding-assistant, chinese-llm

使用方法

使用说明
核心用法
本技能提供 Kimi 模型家族接入 Clawdbot 的端到端方案，覆盖两个独立产品线：
Moonshot AI (Kimi K2) —— 通用大模型，采用标准 OpenAI 兼容接口，需从 platform.moonshot.cn 获取 API Key，通过 MOONSHOT_API_KEY 环境变量注入，配置 baseUrl: https://api.moonshot.cn/v1 ，支持 kimi-k2.5（200K 上下文）、moonlight-v1-32k、moonshot-v1-{8k/32k/128k} 等多档模型。
Kimi Code —— 专用代码模型，独立域名 endpoint，需从 api.kimi.com/coding 单独申请密钥，通过 KIMICODE_API_KEY 注入，配置 baseUrl: https://api.kimi.com/coding/v1 ，目前提供 kimi-for-coding 单模型（200K 上下文 / 8K 最大输出）。
配置流程遵循四步：环境变量设置 → clawdbot.json 的 providers 区块追加 → 网关重启 → clawdbot models list 校验。支持双 Provider 并存，通过 alias 字段在会话内快速切换（ /model k25 vs /model kimi ）。
显著优点
双轨并行 ：通用与代码能力解耦，用户可按任务类型灵活选型
上下文领先 ：K2.5 与 Coding 均提供 200K 长窗口，适合代码库级 RAG 与长文档分析
OpenAI 兼容 ：复用现有 openai-completions 协议栈，降低集成成本
官方背书 ：配置流程直接映射 Moonshot 与 Kimi Code 官方文档，API 域名与鉴权模式经生产验证
潜在局限
密钥分离 ：两套体系需分别注册、分别计费，增加密钥管理复杂度
模型矩阵差异 ：Kimi Code 仅单模型可选，缺乏像 Moonshot 那样的上下文档位细分
地域合规 ：Moonshot AI 服务主要面向中国大陆，海外网络环境需评估延迟与稳定性
生态锁定 ：alias 与 CLI 指令为 Clawdbot 私有语法，迁移至其他框架需重写配置层
适合人群
已部署 Clawdbot 且希望扩展中文大模型选项的开发者
需要 200K 长上下文处理代码仓库、法律合同、技术手册的工程师
追求「通用对话 + 专用编程」双模型策略的高级用户
常规风险
密钥泄露 ：环境变量或 .env 文件权限不当可能导致 sk-* 密钥暴露；建议配合密钥管理器（如 direnv + age 加密）使用
计费失控 ：200K 窗口模型 Token 单价较高，长会话易产生意外费用；建议设置用量告警
服务可用性 ：Moonshot 与 Kimi Code 分属不同运维主体，SLA 与故障窗口不统一，关键业务需设计 fallback 策略
配置漂移 ：JSON5 语法错误（如尾随逗号、括号不匹配）会导致网关启动失败，修改后务必执行 clawdbot gateway config.validate 预检