#How do I use Kimi K2.5 via openrouter
1 messages ยท Page 1 of 1 (latest)
Based on the FAQ, here's how to configure Kimi K2.5 via OpenRouter:
The interactive clawdbot configure wizard only shows commonly used models, but you can manually add any OpenRouter model by editing your config file.
Step 1: Set up OpenRouter (if not done)
clawdbot configure
Select OpenRouter as provider and enter your API key (sk-or-... from OpenRouter).
Step 2: Manually add Kimi K2.5 to your config (~/.clawdbot/clawdbot.json):
{
agents: {
defaults: {
model: { primary: "openrouter/moonshot/kimi-k2.5" },
models: {
"openrouter/moonshot/kimi-k2.5": { alias: "kimi" }
}
}
},
env: {
OPENROUTER_API_KEY: "sk-or-your-key-here"
}
}
Step 3: Restart the gateway
clawdbot gateway restart
Step 4: Verify
clawdbot models list
You should see openrouter/moonshot/kimi-k2.5 (or your alias kimi) in the list. Then you can use /model kimi to switch to it.
The key is that OpenRouter model IDs follow the format openrouter/<provider>/<model-name>. Kimi is from Moonshot AI, so the full model ID is typically openrouter/moonshot/kimi-k2.5 or similar on OpenRouter. Check OpenRouter's model catalog for the exact ID.
Let me know if you need help finding the exact model identifier on OpenRouter! ๐ฆ
This doesnt work and neither does openrouter/moonshotai/kimi-k2.5 which is the correct format.
Found it! The correct model ID is openrouter/moonshotai/kimi-k2.5.
Updated config (~/.clawdbot/clawdbot.json):
{
agents: {
defaults: {
model: { primary: "openrouter/moonshotai/kimi-k2.5" },
models: {
"openrouter/moonshotai/kimi-k2.5": { alias: "kimi" }
}
}
},
env: {
OPENROUTER_API_KEY: "sk-or-your-key-here"
}
}
Then restart and verify:
clawdbot gateway restart
clawdbot models list | grep -i kimi
If it still doesn't show up, check your models status:
clawdbot models status --json
The issue might be that Clawdbot needs the provider explicitly configured. You may need to add a provider block:
{
providers: {
openrouter: {
apiKey: "sk-or-your-key-here"
}
}
}
Let me know what clawdbot models status shows after trying this! ๐ฆ
openrouter/moonshotai/kimi-k2 works fine, openrouter/moonshotai/kimi-k2.5 still reports: Agent failed before reply: Unknown model: openrouter/moonshotai/kimi-k2.5
Based on my search, it looks like Kimi K2.5 was just released in January 2026 (very recently). This means:
- It may not be fully available via OpenRouter's API yet - OpenRouter might still be in the process of adding it
- The model might have a different ID format when it goes live
What you can do:
-
Wait a bit - OpenRouter typically adds new models within 24-48 hours of release
-
Check OpenRouter directly - Visit https://openrouter.ai/moonshotai to see all available Kimi models and their exact IDs
-
Try alternative formats:
// Maybe with a tag like :free or :latest "openrouter/moonshotai/kimi-k2.5:free" "openrouter/moonshotai/kimi-k2.5:latest"
- Use Kimi K2 in the meantime -
openrouter/moonshotai/kimi-k2is working for you, and it's very similar
The fact that kimi-k2 works but kimi-k2.5 doesn't suggests the 2.5 version isn't fully deployed to OpenRouter's API infrastructure yet. This is normal for very new model releases.
You can also ask OpenRouter directly on their Discord or check their status page for when K2.5 becomes available via API. ๐ฆ
It is, it works fine with opencode.
Any news on this @finite laurel ??
Kimi K2.5 is available on OpenRouter, but it won't show up in the interactive clawdbot configure menu because it's not a "baked in" model โ you need to specify it manually.
Here's how to set it up:
1. Authenticate with OpenRouter:
clawdbot onboard --auth-choice apiKey --token-provider openrouter --token "$OPENROUTER_API_KEY"
2. Add to your clawdbot.json:
{
env: { OPENROUTER_API_KEY: "sk-or-..." },
agents: {
defaults: {
model: { primary: "openrouter/moonshotai/kimi-k2.5" }
}
}
}
Model ID format: openrouter/moonshotai/kimi-k2.5 (the format is openrouter/<provider>/<model>)
The OpenRouter docs confirm this is a valid model. You can also browse available models at https://openrouter.ai/docs#models to see others.
Note: If you already have OpenRouter configured, just update the model name โ no need to re-authenticate.
For me, kimi-k2.5 doesn't work while k2 does. Just in case somebody is facing similar issues.
Same issue. manually edited the model in my .json with openrouter/moonshotai/kimi-k2.5. Meanwhile openrouter/moonshotai/kimi-k2 works fine
Good catch! The model ID format might be slightly different. On OpenRouter, the model slug could be:
moonshotai/kimi-k2.5โ trymoonshotai/kimi-k2-5(with hyphen instead of dot)- Or check the exact ID in OpenRouter's model dropdown/API docs
Try these alternatives:
{
agents: {
defaults: {
model: { primary: "openrouter/moonshotai/kimi-k2-5" }
}
}
}
Or search the exact model ID on OpenRouter:
- Go to https://openrouter.ai/docs#models
- Search for "Kimi K2.5"
- Copy the exact model identifier they use
The pattern I've seen is that sometimes model slugs use hyphens where you'd expect dots (e.g., kimi-k2-thinking uses hyphens). Let me know if that works or if you need more help!
yes same here. kimi-k2.5 keeps failing for me
for me too
Multiple users are hitting this โ suggests Kimi K2.5 might not be fully enabled on OpenRouter's API yet (it was just released).
What to check:
-
OpenRouter Status: https://openrouter.ai/status โ see if the model is listed as available
-
Specific error message: If you have logs, paste the exact error โ that helps narrow it down (model not found, auth error, etc.)
-
Alternative: Try
openrouter/moonshotai/kimi-k2-thinkingโ that one is confirmed working
If it's a deployment issue on OpenRouter's end:
- This sometimes happens with brand new models โ they get listed but aren't fully activated yet
- Users should check OpenRouter's Discord or status page for updates
Can you share what error message you're seeing? That'll help determine if it's the model ID or a backend availability issue.
When is this gonna be fixed?
That's a question for the OpenRouter team โ I don't have visibility into their deployment schedule or when they'll fully enable K2.5.
Best ways to get an answer:
- OpenRouter Discord: https://discord.gg/openrouter โ ask directly in their support channels
- OpenRouter Status Page: https://openrouter.ai/status โ subscribe for updates
- OpenRouter GitHub: https://github.com/openrouter/openrouter-api โ check for issues
For now: Use openrouter/moonshotai/kimi-k2-thinking as an alternative, or wait for OpenRouter to fully deploy K2.5.
If anyone from the community has contacts at OpenRouter, that might get a faster answer than public channels!
@finite laurel OpenRouter has a page for k2.5, so the API is online (https://openrouter.ai/moonshotai/kimi-k2.5). When can the model be working in OpenClaw?
Based on the documentation, Kimi K2.5 doesn't show up in clawdbot configure because it's not a built-in model โ but you can add it as a custom provider via OpenRouter! ๐ฆ
Here's how to configure it in your clawdbot.json:
{
env: {
OPENROUTER_API_KEY: "sk-or-v1-..." // Your OpenRouter key
},
models: {
mode: "merge",
providers: {
openrouter: {
baseUrl: "https://openrouter.ai/api/v1",
apiKey: "${OPENROUTER_API_KEY}",
api: "openai-responses",
models: [
{
id: "moonshotai/kimi-k2.5",
name: "Kimi K2.5",
reasoning: false,
input: ["text", "image"],
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
contextWindow: 200000,
maxTokens: 65536
}
]
}
}
},
agent: {
model: {
primary: "openrouter/moonshotai/kimi-k2.5"
}
}
}
Key points:
- OpenRouter uses the OpenAI-compatible API format (
openai-responses) - Model ID on OpenRouter is
moonshotai/kimi-k2.5 - You'll need an OpenRouter API key from https://openrouter.ai/keys
- Context window and pricing may vary โ check OpenRouter for current rates
Let me know if you need help with the exact cost/context values! ๐ฆ