docs: add Moonshot provider setup

docs/providers/models.md

@@ -25,6 +25,7 @@ model as `provider/model`.
 - [OpenAI (API + Codex)](/providers/openai)
 - [Anthropic (API + Claude CLI)](/providers/anthropic)
 - [OpenRouter](/providers/openrouter)
+- [Moonshot AI (Kimi)](/providers/moonshot)
 - [OpenCode Zen](/providers/opencode)
 - [Z.AI](/providers/zai)
 - [GLM models](/providers/glm)

docs/providers/moonshot.md

@@ -0,0 +1,59 @@
+---
+summary: "Use Moonshot AI (Kimi K2) with Clawdbot"
+read_when:
+  - You want to use Moonshot/Kimi models in Clawdbot
+  - You need the Moonshot auth + config example
+---
+# Moonshot AI (Kimi)
+
+Moonshot provides the Kimi API with OpenAI-compatible endpoints. Configure the
+provider and set the default model to `moonshot/kimi-k2-0905-preview`.
+
+## CLI setup
+
+```bash
+clawdbot onboard --auth-choice moonshot-api-key
+```
+
+## Config snippet
+
+```json5
+{
+  env: { MOONSHOT_API_KEY: "sk-..." },
+  agents: {
+    defaults: {
+      model: { primary: "moonshot/kimi-k2-0905-preview" },
+      models: {
+        "moonshot/kimi-k2-0905-preview": { alias: "Kimi K2" }
+      }
+    }
+  },
+  models: {
+    mode: "merge",
+    providers: {
+      moonshot: {
+        baseUrl: "https://api.moonshot.ai/v1",
+        apiKey: "${MOONSHOT_API_KEY}",
+        api: "openai-completions",
+        models: [
+          {
+            id: "kimi-k2-0905-preview",
+            name: "Kimi K2 0905 Preview",
+            reasoning: false,
+            input: ["text"],
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+            contextWindow: 256000,
+            maxTokens: 8192
+          }
+        ]
+      }
+    }
+  }
+}
+```
+
+## Notes
+
+- Model refs use `moonshot/<modelId>`.
+- Override pricing and context metadata in `models.providers` if needed.
+- Use `https://api.moonshot.cn/v1` if you need the China endpoint.