Kimi Model Integration

Complete guide for adding Moonshot AI (Kimi) and Kimi Code models to Clawdbot.

Overview

Kimi offers two separate model families:

Moonshot AI (Kimi K2) - General-purpose models via OpenAI-compatible API
Kimi Code - Specialized coding model with dedicated endpoint

Both require API keys from different sources.

Prerequisites

Clawdbot installed and configured
API keys (see Getting API Keys section)

Getting API Keys

Moonshot AI (Kimi K2)

Visit https://platform.moonshot.cn
Register an account
Navigate to API Keys section
Create a new API key
Copy the key (starts with
```
sk-...
```
)

Kimi Code

Visit https://api.kimi.com/coding
Register an account
Navigate to API Keys section
Create a new API key
Copy the key (starts with
```
sk-...
```
)

Note: Moonshot and Kimi Code use separate keys and endpoints.

Integration Steps

Option 1: Moonshot AI (Kimi K2 models)

Step 1: Set environment variable

export MOONSHOT_API_KEY="sk-your-moonshot-key-here"

Or add to

.env

file:

echo 'MOONSHOT_API_KEY="sk-your-moonshot-key-here"' >> ~/.env

Step 2: Add provider configuration

Edit your

clawdbot.json

config:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "moonshot/kimi-k2.5"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "moonshot": {
        "baseUrl": "https://api.moonshot.cn/v1",
        "apiKey": "${MOONSHOT_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "moonlight-v1-32k",
            "name": "Moonlight V1 32K",
            "contextWindow": 32768
          },
          {
            "id": "moonshot-v1-8k",
            "name": "Moonshot V1 8K",
            "contextWindow": 8192
          },
          {
            "id": "moonshot-v1-32k",
            "name": "Moonshot V1 32K",
            "contextWindow": 32768
          },
          {
            "id": "moonshot-v1-128k",
            "name": "Moonshot V1 128K",
            "contextWindow": 131072
          },
          {
            "id": "kimi-k2.5",
            "name": "Kimi K2.5",
            "contextWindow": 200000
          }
        ]
      }
    }
  }
}

Step 3: Restart Clawdbot

clawdbot gateway restart

Step 4: Verify integration

clawdbot models list

You should see Moonshot models in the list.

Step 5: Use the model

Set as default:

clawdbot models set moonshot/kimi-k2.5

Or use model aliases in chat:

/model moonshot/kimi-k2.5

Option 2: Kimi Code (specialized coding model)

Step 1: Set environment variable

export KIMICODE_API_KEY="sk-your-kimicode-key-here"

Or add to

.env

echo 'KIMICODE_API_KEY="sk-your-kimicode-key-here"' >> ~/.env

Step 2: Add provider configuration

Edit your

clawdbot.json

config:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "kimicode/kimi-for-coding"
      },
      "models": {
        "kimicode/kimi-for-coding": {
          "alias": "kimi"
        }
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "kimicode": {
        "baseUrl": "https://api.kimi.com/coding/v1",
        "apiKey": "${KIMICODE_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "kimi-for-coding",
            "name": "Kimi For Coding",
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

Step 3: Restart Clawdbot

clawdbot gateway restart

Step 4: Verify integration

clawdbot models list

You should see

kimicode/kimi-for-coding

in the list.

Step 5: Use the model

Set as default:

clawdbot models set kimicode/kimi-for-coding

Or use model alias in chat:

/model kimi

Using Both Providers

You can configure both Moonshot and Kimi Code simultaneously:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "moonshot/kimi-k2.5"
      },
      "models": {
        "kimicode/kimi-for-coding": {
          "alias": "kimi"
        },
        "moonshot/kimi-k2.5": {
          "alias": "k25"
        }
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "moonshot": {
        "baseUrl": "https://api.moonshot.cn/v1",
        "apiKey": "${MOONSHOT_API_KEY}",
        "api": "openai-completions",
        "models": [
          { "id": "kimi-k2.5", "name": "Kimi K2.5", "contextWindow": 200000 }
        ]
      },
      "kimicode": {
        "baseUrl": "https://api.kimi.com/coding/v1",
        "apiKey": "${KIMICODE_API_KEY}",
        "api": "openai-completions",
        "models": [
          { "id": "kimi-for-coding", "name": "Kimi For Coding", "contextWindow": 200000 }
        ]
      }
    }
  }
}

Switch between models using aliases:

```
/model k25
```
- Kimi K2.5 (general)
```
/model kimi
```
- Kimi for Coding (specialized)

Troubleshooting

Model not appearing in list

Check config syntax:

clawdbot gateway config.get | grep -A 20 moonshot

Verify API key is set:

echo $MOONSHOT_API_KEY
echo $KIMICODE_API_KEY

Authentication errors

Verify API key starts with
```
sk-
```
Check key is valid on provider dashboard
Ensure correct base URL for each provider

Connection issues

Test API endpoint directly:

curl -X POST "https://api.moonshot.cn/v1/chat/completions" \
  -H "Authorization: Bearer $MOONSHOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "kimi-k2.5", "messages": [{"role": "user", "content": "test"}]}'

Model Recommendations

Kimi K2.5 (
```
moonshot/kimi-k2.5
```
) - Best for general tasks, 200K context
Kimi for Coding (
```
kimicode/kimi-for-coding
```
) - Specialized for code generation
Moonshot V1 128K (
```
moonshot/moonshot-v1-128k
```
) - Legacy model, 128K context

References

Moonshot AI Docs: https://platform.moonshot.cn/docs
Kimi Code API: https://api.kimi.com/coding/docs
Clawdbot Model Providers: /home/eyurc/clawdbot/docs/concepts/model-providers.md

Kimi Integration

AI Skill Market Insights

Be Part of the 0+ Developer Community

Kimi Model Integration

Overview

Prerequisites

Getting API Keys

Moonshot AI (Kimi K2)

Kimi Code

Integration Steps

Option 1: Moonshot AI (Kimi K2 models)

Step 1: Set environment variable

Step 2: Add provider configuration

Step 3: Restart Clawdbot

Step 4: Verify integration

Step 5: Use the model

Option 2: Kimi Code (specialized coding model)

Step 1: Set environment variable

Step 2: Add provider configuration

Step 3: Restart Clawdbot

Step 4: Verify integration

Step 5: Use the model

Using Both Providers

Troubleshooting

Model not appearing in list

Authentication errors

Connection issues

Model Recommendations

References

Quick Start

Manual Installation

TEAR & SHARE

Tags

Channels

Learn

Compare

Company