用 OpenClaw 接入 Kimi（Moonshot）模型：API Key 配置完整步骤

Kimi（Moonshot AI）是 OpenClaw 官方内置支持的中国 AI 服务商之一，自 v2026.2.3 起在引导向导中可以直接选择。Kimi K2.5 以 256K Token 超长上下文、原生多模态能力和极具竞争力的定价，在 OpenClaw 社区中积累了大量中国用户。本文将带你完成从注册账号到多模型全套配置的完整流程。更多资源请访问 OpenClaw 中文版官网。

一、Kimi 模型系列一览

Moonshot AI 提供两条独立的 API 服务线，在 OpenClaw 中使用不同的服务商前缀和密钥，两者的 Key 不可互换：

当前主力模型清单（截至 2026 年 4 月）

Kimi K2.5 定价参考

相比 Claude Sonnet 4.6（$3/$15），Kimi K2.5 输入成本约低 5 倍、输出成本约低 6 倍，且 256K 上下文无额外溢价。

二、获取 Moonshot AI API Key

国际版（推荐）

1. 访问 platform.moonshot.ai，注册账户（支持邮箱或 Google 登录）
2. 进入控制台，点击左侧 「API Keys」→「创建 API Key」
3. 复制生成的 Key（格式：sk-xxxxxxxxxxxx）
4. 前往 「充值」 页面进行充值——新账户默认无余额，必须先充值才能使用

Tier 建议：Moonshot 官方建议充值 $20 以上升级到 Tier 2，可以解除较严格的速率限制，获得更流畅的使用体验。轻度测试可先充值 $5（赠 $5 体验券）。

国内版（国内用户可选）

如果你在中国大陆且访问 platform.moonshot.ai 有困难，可以使用国内端点：

• 控制台：platform.moonshot.cn
• API 端点：https://api.moonshot.cn/v1（而非 .ai）
• 支持支付宝、微信支付

三、方式一：引导向导快速配置（推荐新手）

自 OpenClaw v2026.2.3 起，Kimi K2.5 已出现在引导向导的模型选择菜单中，无需手动编辑配置文件：

1. 运行引导向导：openclaw onboard（新装）或 openclaw configure --section models（已装）
2. 选择 QuickStart 模式
3. 在”Model auth provider”步骤，选择 「Moonshot AI (Kimi K2.5)」
4. 在”Model AI auth method”步骤，选择 「Kimi API Key (.ai)」（国内用户选 .cn）
5. 粘贴你的 Moonshot API Key
6. 默认模型选择 「moonshot/kimi-k2.5」，其他步骤按默认回车

完成后重启 Gateway：

openclaw daemon restart
openclaw models list  # 确认 moonshot/kimi-k2.5 出现在列表中

四、方式二：直接编辑 openclaw.json（完整配置）

如果你需要配置全套模型（含 Thinking 模式和 Turbo 版本），直接编辑 ~/.openclaw/openclaw.json：

第一步：设置环境变量

在 ~/.openclaw/.env 中添加：

MOONSHOT_API_KEY=sk-你的Moonshot密钥

第二步：完整配置块

{
  "env": {
    "MOONSHOT_API_KEY": "sk-你的Moonshot密钥"
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "moonshot/kimi-k2.5",
        "fallbacks": [
          "moonshot/kimi-k2-turbo-preview",
          "deepseek/deepseek-chat"
        ]
      },
      "models": {
        "moonshot/kimi-k2.5": {
          "alias": "kimi"
        },
        "moonshot/kimi-k2-0905-preview": {
          "alias": "kimi-k2"
        },
        "moonshot/kimi-k2-turbo-preview": {
          "alias": "kimi-turbo"
        },
        "moonshot/kimi-k2-thinking": {
          "alias": "kimi-think"
        },
        "moonshot/kimi-k2-thinking-turbo": {
          "alias": "kimi-think-turbo"
        }
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "moonshot": {
        "baseUrl": "https://api.moonshot.ai/v1",
        "apiKey": "${MOONSHOT_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "kimi-k2.5",
            "name": "Kimi K2.5（通用多模态）",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": {
              "input": 0.0000006,
              "output": 0.0000025
            },
            "contextWindow": 256000,
            "maxTokens": 8192
          },
          {
            "id": "kimi-k2-0905-preview",
            "name": "Kimi K2（代码增强版）",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0.0000006,
              "output": 0.0000025
            },
            "contextWindow": 256000,
            "maxTokens": 8192
          },
          {
            "id": "kimi-k2-turbo-preview",
            "name": "Kimi K2 Turbo（高速版）",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 256000,
            "maxTokens": 8192
          },
          {
            "id": "kimi-k2-thinking",
            "name": "Kimi K2 Thinking（深度推理）",
            "reasoning": true,
            "input": ["text"],
            "contextWindow": 256000,
            "maxTokens": 32768
          },
          {
            "id": "kimi-k2-thinking-turbo",
            "name": "Kimi K2 Thinking Turbo（推理高速版）",
            "reasoning": true,
            "input": ["text"],
            "contextWindow": 256000,
            "maxTokens": 32768
          }
        ]
      }
    }
  }
}

国内用户注意：如果使用国内端点，将 baseUrl 改为 "https://api.moonshot.cn/v1"，其余配置不变。

第三步：验证配置

openclaw daemon restart

# 确认所有 Kimi 模型已加载
openclaw models list | grep moonshot

# 发送测试消息
# 在聊天中：/status 确认当前模型为 moonshot/kimi-k2.5
# 切换推理模式：/model kimi-think

五、Thinking 推理模式配置详解

Kimi K2 系列提供独立的 Thinking（深度推理）模型，相当于 OpenAI o1 系列的定位。在 OpenClaw 中使用时有一些重要注意事项：

开启 / 关闭思维模式

可以在配置文件中为特定模型控制思维模式的默认状态：

{
  "agents": {
    "defaults": {
      "models": {
        "moonshot/kimi-k2.5": {
          "params": {
            "thinking": {
              "type": "disabled"
            }
          }
        },
        "moonshot/kimi-k2-thinking": {
          "params": {
            "thinking": {
              "type": "enabled"
            }
          }
        }
      }
    }
  }
}

OpenClaw 还会根据运行时的 /think 指令动态切换思维模式：

• /think off → thinking.type: disabled（普通模式）
• /think → thinking.type: enabled（开启推理）

注意：当 Moonshot Thinking 模式开启时，tool_choice 参数必须设置为 auto 或 none，不能设为强制调用特定工具。这是 Moonshot API 的限制，OpenClaw 会自动处理，无需手动配置。

六、Kimi Coding 专用服务商配置

Kimi Coding 是 Moonshot AI 专门为代码场景优化的 API 服务，使用独立的 API 端点和 Key，在 OpenClaw 中使用 kimi-coding/ 前缀。

获取 Kimi Coding API Key

Kimi Coding 的 Key 在 Moonshot 控制台的单独区域创建，与标准 API Key 不同。登录 platform.moonshot.ai 后，在控制台找到”Kimi Coding”专区创建对应 Key（格式同为 sk- 开头，但不能与标准 API Key 混用）。

openclaw.json 配置

{
  "env": {
    "MOONSHOT_API_KEY": "sk-你的标准Moonshot密钥",
    "KIMICODE_API_KEY": "sk-你的KimiCoding密钥"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "kimi-coding": {
        "baseUrl": "https://api.moonshot.ai/anthropic",
        "apiKey": "${KIMICODE_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "k2p5",
            "name": "Kimi for Coding K2.5",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 256000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "models": {
        "kimi-coding/k2p5": {
          "alias": "kimi-code"
        }
      }
    }
  }
}

注意：Kimi Coding 使用 Anthropic Messages API 格式（api: "anthropic-messages"），而非 OpenAI 兼容格式，这与标准 Moonshot API 不同。

七、模型选择最佳实践

根据任务类型，在聊天中通过别名快速切换模型：

# 查看全部可用别名
/model list

# 日常对话和任务处理
/model kimi          # → moonshot/kimi-k2.5（默认，最均衡）

# 代码生成和审查（非 Coding 专用线）
/model kimi-k2       # → moonshot/kimi-k2-0905-preview

# 速度优先的批量任务
/model kimi-turbo    # → moonshot/kimi-k2-turbo-preview

# 复杂推理（数学、逻辑规划）
/model kimi-think    # → moonshot/kimi-k2-thinking

# 代码任务（Kimi Coding 专用线，需额外 Key）
/model kimi-code     # → kimi-coding/k2p5

八、256K 上下文的实用场景

Kimi K2.5 的 256K Token 上下文是目前 OpenClaw 常用模型中最大的（无需额外费用），以下场景最能发挥这一优势：

• 整个代码仓库分析：将项目所有代码文件一次性送入上下文，让 AI 全局理解后再定位 Bug 或做架构设计
• 长文档处理：数百页的 PDF 报告、技术文档、法律合同，直接全文送入分析，无需分块
• 超长对话记忆：在连续多天的项目对话中，AI 可以记住更多历史背景，不会频繁触发压缩
• 批量数据处理：将大量结构化数据（CSV、JSON）连同分析指令一次性处理

成本提示：256K 上下文虽然不额外收费，但实际使用的 Token 越多，费用就越高。建议在 HEARTBEAT 等周期性任务中启用 isolatedSession，避免不必要的上下文累积。

九、国际 vs 国内端点：如何选择？

十、常见问题排查

问：报错 “Unknown model: anthropic/kimi-k2.5”

服务商前缀写错了。Moonshot 模型的正确前缀是 moonshot/，而非 anthropic/。检查 agents.defaults.model.primary，确认格式为 moonshot/kimi-k2.5。

问：Moonshot Key 用于 Kimi Coding 端点报 401

这是最常见的配置错误。标准 Moonshot API Key 和 Kimi Coding Key 完全独立，不可互换。确认你为 kimi-coding 服务商使用的是 KIMICODE_API_KEY，而非 MOONSHOT_API_KEY。

问：配置完成后 models list 中没有 kimi 系列模型

确认 openclaw.json 中的 models.mode 设置为 "merge"（而非 "override"）。执行 openclaw doctor 检查配置解析是否有 JSON 语法错误。

问：使用 Thinking 模式时工具调用失败

Thinking 模式下，工具调用的 tool_choice 不能设为强制调用指定工具。OpenClaw 会自动处理这个约束，如果仍然出错，检查是否有技能文件中硬编码了 tool_choice: "required"。

问：v2026.4.1 引导向导中没有出现 Kimi Code 选项

这是 v2026.4.1 修复的一个已知问题（原引导向导缺少 Kimi Code API Key 的选项入口，#54412）。升级到 v2026.4.1 后已修复。如果仍未显示，通过手动编辑 openclaw.json 的方式配置 Kimi Coding（见第六节）。

总结

OpenClaw 接入 Kimi 的核心配置三要素：

1. 分清两条服务线：标准 API（moonshot/，MOONSHOT_API_KEY）和 Kimi Coding（kimi-coding/，KIMICODE_API_KEY）——Key 不可互换
2. 选对端点：国内用户优先使用 api.moonshot.cn/v1 + 支付宝充值，国际用户使用 api.moonshot.ai/v1
3. 按场景选模型：日常任务用 K2.5，速度优先用 Turbo，复杂推理用 Thinking，代码专项用 Kimi Coding

完成配置后，256K Token 的超长上下文让你的 OpenClaw 助手可以轻松应对整个代码库的分析、数百页文档的处理等以往需要分块处理的复杂任务。想了解更多 OpenClaw 国产模型接入教程，欢迎访问 OpenClaw 中文版官网。