（10808期）Kimi Integration – Kimi 双模型一键接入指南

Kimi 双模型一键接入指南 Clawdbot 接入 Moonshot AI 与 Kimi Code 模型的完整配置指南，提供双平台 API 密钥获取、JSON5 配置模板及故障排查方案。 使用说明 核心用法 本技能提供 Kimi 模型家族接入 Clawdbot 的端到端方案，覆盖两个独立产品线： Moonshot AI (Kimi K2) —— 通用大模型，采用标准 OpenAI 兼容接口，需从 platform.moonshot.cn 获取 API Key，通过 MOONSHOTAPIKEY 环境变量注入，配置 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 单独申请密钥，通过 KIMICODEAPIKEY 注入，配置 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 预检 原始说明 Step-by-step guide for integrating Moonshot AI (Kimi) and Kimi Code models into Clawdbot. Use when someone asks how to add Kimi models, configure Moonshot AI, or set up Kimi for Coding in Clawdbot.