核心用法
本技能提供 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预检