Lumen AI

How to Use Kimi K2.5 in OpenClaw: Complete Setup Guide

Feb 3, 2026

How to Use Kimi K2.5 in OpenClaw: Complete Setup Guide

OpenClaw connects to chat apps through its Gateway, including WhatsApp, Telegram, Discord, Slack, and Signal. This guide shows how to configure the Moonshot (Kimi) provider and set the default model to moonshot/kimi-k2.5.

What is This Integration?

OpenClaw supports Moonshot’s OpenAI-compatible Kimi API. You can set your default model to moonshot/kimi-k2.5 and route messages from your chat channels to the model.

Why Choose This Setup?

  • Supported channels: WhatsApp, Telegram, Discord, Slack, Signal (and more)
  • Official Moonshot provider: OpenAI-compatible endpoint
  • Long context: moonshot/kimi-k2.5 supports a 256,000 token context window

Prerequisites

  • OpenClaw CLI installed
  • Moonshot API key (MOONSHOT_API_KEY)
  • Correct endpoint for your region:
    • International: https://api.moonshot.ai/v1
    • China: https://api.moonshot.cn/v1
  • Optional: Kimi Code API key if you plan to use the Kimi Code provider (separate from Moonshot; keys are not interchangeable)

Step 1: Onboard the Moonshot Provider

Run the Moonshot onboarding command:

openclaw onboard --auth-choice moonshot-api-key

If you want to use Kimi Code instead, use:

openclaw onboard --auth-choice kimi-code-api-key

Note: Moonshot and Kimi Code are separate providers. Keys are not interchangeable, and model references differ (moonshot/... vs kimi-code/...).

Step 2: Configure Default Model and Endpoint

Set the default model to moonshot/kimi-k2.5 and make sure your Moonshot base URL matches your region.

Key points:

  • Model reference: moonshot/kimi-k2.5
  • Base URL (international): https://api.moonshot.ai/v1
  • Base URL (China): https://api.moonshot.cn/v1
  • Context window: 256,000 tokens

Step 3: Connect a Chat Channel

OpenClaw supports multiple channels via its Gateway. Common options include:

  • WhatsApp
  • Telegram
  • Discord
  • Slack
  • Signal

Troubleshooting Quick Checks

  • Ensure MOONSHOT_API_KEY is set or the Moonshot onboarding command was completed.
  • Use the correct base URL for your region (.ai for international, .cn for China).
  • Make sure the model reference is moonshot/kimi-k2.5.
  • If using Kimi Code, use its own key and kimi-code/... model refs.

References

Last updated: February 5, 2026

How to Use Kimi K2.5 in OpenClaw: Complete Setup Guide | Blog