9.6 Moonshot AI

Moonshot Kimi 配置指南

概述

Moonshot AI 通过 OpenAI 兼容的端点提供 Kimi API。OpenClaw 支持使用 Moonshot 的各种 Kimi 模型,包括标准版、预览版和思考模式版本。

认证方式

使用 MOONSHOT_API_KEY 环境变量进行认证:

export MOONSHOT_API_KEY=your-api-key-here

快速开始

# 引导式配置
openclaw onboard --auth-choice moonshot-api-key

# 设置环境变量
export MOONSHOT_API_KEY=your-api-key-here

# 设置为默认模型
openclaw models set moonshot/kimi-k2.5

可用模型

Moonshot 提供以下 Kimi 模型:

  • kimi-k2.5 - Kimi K2.5 标准版
  • kimi-k2-0905-preview - Kimi K2 预览版(2024年9月5日)
  • kimi-k2-turbo-preview - Kimi K2 Turbo 预览版
  • kimi-k2-thinking - Kimi K2 思考模式
  • kimi-k2-thinking-turbo - Kimi K2 思考模式 Turbo 版

配置示例

基础配置

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "moonshot/kimi-k2.5"
      }
    }
  }
}

完整配置(自定义提供商)

{
  "models": {
    "providers": {
      "moonshot": {
        "baseUrl": "https://api.moonshot.ai/v1",
        "apiKey": "${MOONSHOT_API_KEY}",
        "api": "openai",
        "models": [
          {
            "id": "kimi-k2.5",
            "name": "Kimi K2.5",
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

API 端点

根据您的地理位置选择合适的 API 端点:

  • 国际版: https://api.moonshot.ai/v1
  • 中国版: https://api.moonshot.cn/v1

常用命令

# 列出可用的 Moonshot 模型
openclaw models list --provider moonshot

# 粘贴 API 令牌
openclaw models auth paste-token --provider moonshot

# 设置默认模型
openclaw models set moonshot/kimi-k2.5

模型引用格式

Moonshot 模型使用以下格式引用:

moonshot/kimi-k2.5
moonshot/kimi-k2-thinking
重要提示
Moonshot 和 Kimi Coding 是独立的提供商,API 密钥不可互换。请确保使用正确的提供商和对应的 API 密钥。
推荐模型
对于需要深度思考和推理的任务,推荐使用 kimi-k2-thinkingkimi-k2-thinking-turbo 思考模式。