{
  "schemaVersion": "1.0",
  "item": {
    "slug": "kimi-integration",
    "name": "Kimi Integration",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/evgyur/kimi-integration",
    "canonicalUrl": "https://clawhub.ai/evgyur/kimi-integration",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/kimi-integration",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kimi-integration",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "references/config-examples.md",
      "scripts/test_kimi_connection.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/kimi-integration"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/kimi-integration",
    "agentPageUrl": "https://openagent3.xyz/skills/kimi-integration/agent",
    "manifestUrl": "https://openagent3.xyz/skills/kimi-integration/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/kimi-integration/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Kimi Model Integration",
        "body": "Complete guide for adding Moonshot AI (Kimi) and Kimi Code models to Clawdbot."
      },
      {
        "title": "Overview",
        "body": "Kimi offers two separate model families:\n\nMoonshot AI (Kimi K2) - General-purpose models via OpenAI-compatible API\nKimi Code - Specialized coding model with dedicated endpoint\n\nBoth require API keys from different sources."
      },
      {
        "title": "Prerequisites",
        "body": "Clawdbot installed and configured\nAPI keys (see Getting API Keys section)"
      },
      {
        "title": "Moonshot AI (Kimi K2)",
        "body": "Visit https://platform.moonshot.cn\nRegister an account\nNavigate to API Keys section\nCreate a new API key\nCopy the key (starts with sk-...)"
      },
      {
        "title": "Kimi Code",
        "body": "Visit https://api.kimi.com/coding\nRegister an account\nNavigate to API Keys section\nCreate a new API key\nCopy the key (starts with sk-...)\n\nNote: Moonshot and Kimi Code use separate keys and endpoints."
      },
      {
        "title": "Option 1: Moonshot AI (Kimi K2 models)",
        "body": "Step 1: Set environment variable\n\nexport MOONSHOT_API_KEY=\"sk-your-moonshot-key-here\"\n\nOr add to .env file:\n\necho 'MOONSHOT_API_KEY=\"sk-your-moonshot-key-here\"' >> ~/.env\n\nStep 2: Add provider configuration\n\nEdit your clawdbot.json config:\n\n{\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"moonshot/kimi-k2.5\"\n      }\n    }\n  },\n  \"models\": {\n    \"mode\": \"merge\",\n    \"providers\": {\n      \"moonshot\": {\n        \"baseUrl\": \"https://api.moonshot.cn/v1\",\n        \"apiKey\": \"${MOONSHOT_API_KEY}\",\n        \"api\": \"openai-completions\",\n        \"models\": [\n          {\n            \"id\": \"moonlight-v1-32k\",\n            \"name\": \"Moonlight V1 32K\",\n            \"contextWindow\": 32768\n          },\n          {\n            \"id\": \"moonshot-v1-8k\",\n            \"name\": \"Moonshot V1 8K\",\n            \"contextWindow\": 8192\n          },\n          {\n            \"id\": \"moonshot-v1-32k\",\n            \"name\": \"Moonshot V1 32K\",\n            \"contextWindow\": 32768\n          },\n          {\n            \"id\": \"moonshot-v1-128k\",\n            \"name\": \"Moonshot V1 128K\",\n            \"contextWindow\": 131072\n          },\n          {\n            \"id\": \"kimi-k2.5\",\n            \"name\": \"Kimi K2.5\",\n            \"contextWindow\": 200000\n          }\n        ]\n      }\n    }\n  }\n}\n\nStep 3: Restart Clawdbot\n\nclawdbot gateway restart\n\nStep 4: Verify integration\n\nclawdbot models list\n\nYou should see Moonshot models in the list.\n\nStep 5: Use the model\n\nSet as default:\n\nclawdbot models set moonshot/kimi-k2.5\n\nOr use model aliases in chat:\n\n/model moonshot/kimi-k2.5"
      },
      {
        "title": "Option 2: Kimi Code (specialized coding model)",
        "body": "Step 1: Set environment variable\n\nexport KIMICODE_API_KEY=\"sk-your-kimicode-key-here\"\n\nOr add to .env:\n\necho 'KIMICODE_API_KEY=\"sk-your-kimicode-key-here\"' >> ~/.env\n\nStep 2: Add provider configuration\n\nEdit your clawdbot.json config:\n\n{\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"kimicode/kimi-for-coding\"\n      },\n      \"models\": {\n        \"kimicode/kimi-for-coding\": {\n          \"alias\": \"kimi\"\n        }\n      }\n    }\n  },\n  \"models\": {\n    \"mode\": \"merge\",\n    \"providers\": {\n      \"kimicode\": {\n        \"baseUrl\": \"https://api.kimi.com/coding/v1\",\n        \"apiKey\": \"${KIMICODE_API_KEY}\",\n        \"api\": \"openai-completions\",\n        \"models\": [\n          {\n            \"id\": \"kimi-for-coding\",\n            \"name\": \"Kimi For Coding\",\n            \"contextWindow\": 200000,\n            \"maxTokens\": 8192\n          }\n        ]\n      }\n    }\n  }\n}\n\nStep 3: Restart Clawdbot\n\nclawdbot gateway restart\n\nStep 4: Verify integration\n\nclawdbot models list\n\nYou should see kimicode/kimi-for-coding in the list.\n\nStep 5: Use the model\n\nSet as default:\n\nclawdbot models set kimicode/kimi-for-coding\n\nOr use model alias in chat:\n\n/model kimi"
      },
      {
        "title": "Using Both Providers",
        "body": "You can configure both Moonshot and Kimi Code simultaneously:\n\n{\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"moonshot/kimi-k2.5\"\n      },\n      \"models\": {\n        \"kimicode/kimi-for-coding\": {\n          \"alias\": \"kimi\"\n        },\n        \"moonshot/kimi-k2.5\": {\n          \"alias\": \"k25\"\n        }\n      }\n    }\n  },\n  \"models\": {\n    \"mode\": \"merge\",\n    \"providers\": {\n      \"moonshot\": {\n        \"baseUrl\": \"https://api.moonshot.cn/v1\",\n        \"apiKey\": \"${MOONSHOT_API_KEY}\",\n        \"api\": \"openai-completions\",\n        \"models\": [\n          { \"id\": \"kimi-k2.5\", \"name\": \"Kimi K2.5\", \"contextWindow\": 200000 }\n        ]\n      },\n      \"kimicode\": {\n        \"baseUrl\": \"https://api.kimi.com/coding/v1\",\n        \"apiKey\": \"${KIMICODE_API_KEY}\",\n        \"api\": \"openai-completions\",\n        \"models\": [\n          { \"id\": \"kimi-for-coding\", \"name\": \"Kimi For Coding\", \"contextWindow\": 200000 }\n        ]\n      }\n    }\n  }\n}\n\nSwitch between models using aliases:\n\n/model k25 - Kimi K2.5 (general)\n/model kimi - Kimi for Coding (specialized)"
      },
      {
        "title": "Model not appearing in list",
        "body": "Check config syntax:\n\nclawdbot gateway config.get | grep -A 20 moonshot\n\nVerify API key is set:\n\necho $MOONSHOT_API_KEY\necho $KIMICODE_API_KEY"
      },
      {
        "title": "Authentication errors",
        "body": "Verify API key starts with sk-\nCheck key is valid on provider dashboard\nEnsure correct base URL for each provider"
      },
      {
        "title": "Connection issues",
        "body": "Test API endpoint directly:\n\ncurl -X POST \"https://api.moonshot.cn/v1/chat/completions\" \\\n  -H \"Authorization: Bearer $MOONSHOT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\": \"kimi-k2.5\", \"messages\": [{\"role\": \"user\", \"content\": \"test\"}]}'"
      },
      {
        "title": "Model Recommendations",
        "body": "Kimi K2.5 (moonshot/kimi-k2.5) - Best for general tasks, 200K context\nKimi for Coding (kimicode/kimi-for-coding) - Specialized for code generation\nMoonshot V1 128K (moonshot/moonshot-v1-128k) - Legacy model, 128K context"
      },
      {
        "title": "References",
        "body": "Moonshot AI Docs: https://platform.moonshot.cn/docs\nKimi Code API: https://api.kimi.com/coding/docs\nClawdbot Model Providers: /home/eyurc/clawdbot/docs/concepts/model-providers.md"
      }
    ],
    "body": "Kimi Model Integration\n\nComplete guide for adding Moonshot AI (Kimi) and Kimi Code models to Clawdbot.\n\nOverview\n\nKimi offers two separate model families:\n\nMoonshot AI (Kimi K2) - General-purpose models via OpenAI-compatible API\nKimi Code - Specialized coding model with dedicated endpoint\n\nBoth require API keys from different sources.\n\nPrerequisites\nClawdbot installed and configured\nAPI keys (see Getting API Keys section)\nGetting API Keys\nMoonshot AI (Kimi K2)\nVisit https://platform.moonshot.cn\nRegister an account\nNavigate to API Keys section\nCreate a new API key\nCopy the key (starts with sk-...)\nKimi Code\nVisit https://api.kimi.com/coding\nRegister an account\nNavigate to API Keys section\nCreate a new API key\nCopy the key (starts with sk-...)\n\nNote: Moonshot and Kimi Code use separate keys and endpoints.\n\nIntegration Steps\nOption 1: Moonshot AI (Kimi K2 models)\nStep 1: Set environment variable\nexport MOONSHOT_API_KEY=\"sk-your-moonshot-key-here\"\n\n\nOr add to .env file:\n\necho 'MOONSHOT_API_KEY=\"sk-your-moonshot-key-here\"' >> ~/.env\n\nStep 2: Add provider configuration\n\nEdit your clawdbot.json config:\n\n{\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"moonshot/kimi-k2.5\"\n      }\n    }\n  },\n  \"models\": {\n    \"mode\": \"merge\",\n    \"providers\": {\n      \"moonshot\": {\n        \"baseUrl\": \"https://api.moonshot.cn/v1\",\n        \"apiKey\": \"${MOONSHOT_API_KEY}\",\n        \"api\": \"openai-completions\",\n        \"models\": [\n          {\n            \"id\": \"moonlight-v1-32k\",\n            \"name\": \"Moonlight V1 32K\",\n            \"contextWindow\": 32768\n          },\n          {\n            \"id\": \"moonshot-v1-8k\",\n            \"name\": \"Moonshot V1 8K\",\n            \"contextWindow\": 8192\n          },\n          {\n            \"id\": \"moonshot-v1-32k\",\n            \"name\": \"Moonshot V1 32K\",\n            \"contextWindow\": 32768\n          },\n          {\n            \"id\": \"moonshot-v1-128k\",\n            \"name\": \"Moonshot V1 128K\",\n            \"contextWindow\": 131072\n          },\n          {\n            \"id\": \"kimi-k2.5\",\n            \"name\": \"Kimi K2.5\",\n            \"contextWindow\": 200000\n          }\n        ]\n      }\n    }\n  }\n}\n\nStep 3: Restart Clawdbot\nclawdbot gateway restart\n\nStep 4: Verify integration\nclawdbot models list\n\n\nYou should see Moonshot models in the list.\n\nStep 5: Use the model\n\nSet as default:\n\nclawdbot models set moonshot/kimi-k2.5\n\n\nOr use model aliases in chat:\n\n/model moonshot/kimi-k2.5\n\nOption 2: Kimi Code (specialized coding model)\nStep 1: Set environment variable\nexport KIMICODE_API_KEY=\"sk-your-kimicode-key-here\"\n\n\nOr add to .env:\n\necho 'KIMICODE_API_KEY=\"sk-your-kimicode-key-here\"' >> ~/.env\n\nStep 2: Add provider configuration\n\nEdit your clawdbot.json config:\n\n{\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"kimicode/kimi-for-coding\"\n      },\n      \"models\": {\n        \"kimicode/kimi-for-coding\": {\n          \"alias\": \"kimi\"\n        }\n      }\n    }\n  },\n  \"models\": {\n    \"mode\": \"merge\",\n    \"providers\": {\n      \"kimicode\": {\n        \"baseUrl\": \"https://api.kimi.com/coding/v1\",\n        \"apiKey\": \"${KIMICODE_API_KEY}\",\n        \"api\": \"openai-completions\",\n        \"models\": [\n          {\n            \"id\": \"kimi-for-coding\",\n            \"name\": \"Kimi For Coding\",\n            \"contextWindow\": 200000,\n            \"maxTokens\": 8192\n          }\n        ]\n      }\n    }\n  }\n}\n\nStep 3: Restart Clawdbot\nclawdbot gateway restart\n\nStep 4: Verify integration\nclawdbot models list\n\n\nYou should see kimicode/kimi-for-coding in the list.\n\nStep 5: Use the model\n\nSet as default:\n\nclawdbot models set kimicode/kimi-for-coding\n\n\nOr use model alias in chat:\n\n/model kimi\n\nUsing Both Providers\n\nYou can configure both Moonshot and Kimi Code simultaneously:\n\n{\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"moonshot/kimi-k2.5\"\n      },\n      \"models\": {\n        \"kimicode/kimi-for-coding\": {\n          \"alias\": \"kimi\"\n        },\n        \"moonshot/kimi-k2.5\": {\n          \"alias\": \"k25\"\n        }\n      }\n    }\n  },\n  \"models\": {\n    \"mode\": \"merge\",\n    \"providers\": {\n      \"moonshot\": {\n        \"baseUrl\": \"https://api.moonshot.cn/v1\",\n        \"apiKey\": \"${MOONSHOT_API_KEY}\",\n        \"api\": \"openai-completions\",\n        \"models\": [\n          { \"id\": \"kimi-k2.5\", \"name\": \"Kimi K2.5\", \"contextWindow\": 200000 }\n        ]\n      },\n      \"kimicode\": {\n        \"baseUrl\": \"https://api.kimi.com/coding/v1\",\n        \"apiKey\": \"${KIMICODE_API_KEY}\",\n        \"api\": \"openai-completions\",\n        \"models\": [\n          { \"id\": \"kimi-for-coding\", \"name\": \"Kimi For Coding\", \"contextWindow\": 200000 }\n        ]\n      }\n    }\n  }\n}\n\n\nSwitch between models using aliases:\n\n/model k25 - Kimi K2.5 (general)\n/model kimi - Kimi for Coding (specialized)\nTroubleshooting\nModel not appearing in list\n\nCheck config syntax:\n\nclawdbot gateway config.get | grep -A 20 moonshot\n\n\nVerify API key is set:\n\necho $MOONSHOT_API_KEY\necho $KIMICODE_API_KEY\n\nAuthentication errors\nVerify API key starts with sk-\nCheck key is valid on provider dashboard\nEnsure correct base URL for each provider\nConnection issues\n\nTest API endpoint directly:\n\ncurl -X POST \"https://api.moonshot.cn/v1/chat/completions\" \\\n  -H \"Authorization: Bearer $MOONSHOT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\": \"kimi-k2.5\", \"messages\": [{\"role\": \"user\", \"content\": \"test\"}]}'\n\nModel Recommendations\nKimi K2.5 (moonshot/kimi-k2.5) - Best for general tasks, 200K context\nKimi for Coding (kimicode/kimi-for-coding) - Specialized for code generation\nMoonshot V1 128K (moonshot/moonshot-v1-128k) - Legacy model, 128K context\nReferences\nMoonshot AI Docs: https://platform.moonshot.cn/docs\nKimi Code API: https://api.kimi.com/coding/docs\nClawdbot Model Providers: /home/eyurc/clawdbot/docs/concepts/model-providers.md"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/evgyur/kimi-integration",
    "publisherUrl": "https://clawhub.ai/evgyur/kimi-integration",
    "owner": "evgyur",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/kimi-integration",
    "downloadUrl": "https://openagent3.xyz/downloads/kimi-integration",
    "agentUrl": "https://openagent3.xyz/skills/kimi-integration/agent",
    "manifestUrl": "https://openagent3.xyz/skills/kimi-integration/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/kimi-integration/agent.md"
  }
}