Moonshot AI

这页纸是教我们怎么设置一个叫 Moonshot AI 的聪明大脑来工作的。你可以把它想成是给电脑介绍一个新朋友，这个朋友叫 Kimi，它很会聊天和回答问题。但是，请 Kimi 来玩需要两个步骤：第一，要有一把正确的钥匙；第二，要告诉电脑我们想请哪个 Kimi 来玩，因为 Kimi 有好几个不同的样子呢。

首先，我们要拿到钥匙。钥匙有两种，长得不一样，不能混着用。

1. 如果你想请普通的 Kimi 大脑来聊天，你需要一把叫 moonshot-api-key 的钥匙。告诉电脑钥匙的方法是，在电脑上输入：openclaw onboard --auth-choice moonshot-api-key。
2. 如果你想请一个特别会写代码的 Kimi（叫 Kimi Coding），你需要另一把叫 kimi-code-api-key 的钥匙。告诉电脑的方法是输入：openclaw onboard --auth-choice kimi-code-api-key。

拿到钥匙后，我们要写一张“邀请卡”，告诉电脑具体怎么请 Kimi。邀请卡是用一种叫 JSON 的格式写的，像搭积木一样。这里要小心，给普通 Kimi 和给会写代码的 Kimi 的邀请卡，写法是不一样的哦！

如果你想请普通的 Kimi 大脑来玩： 你的邀请卡里要写上这几样东西：

1. 放钥匙的地方：在 env 里面，写上 MOONSHOT_API_KEY: "sk-..."。这里的 "sk-..." 就是你拿到的那把真正的钥匙。
2. 选一个你最喜欢的 Kimi 当默认朋友：在 agents.defaults.model.primary 后面，写上你想选的 Kimi 名字，比如 "moonshot/kimi-k2.5"。
3. 告诉电脑 Kimi 们都在哪里：在 models.providers.moonshot 里面，要写上 Kimi 的家在哪里（baseUrl），怎么用钥匙（apiKey），还有所有可以选的 Kimi 名单（models）。名单里已经列出了五个 Kimi 的名字和它们的本领。

如果你想请特别会写代码的 Kimi（Kimi Coding）来玩： 你的邀请卡会简单一些：

1. 放钥匙的地方：在 env 里面，写上 KIMI_API_KEY: "sk-..."。注意，这里的钥匙名字和上面不一样哦！
2. 选默认朋友：在 agents.defaults.model.primary 后面，写上 "kimi-coding/k2p5"。

最后，有几个重要的事情要记住：

• 普通 Kimi 的名字前面要加 moonshot/，比如 moonshot/kimi-k2.5。会写代码的 Kimi 名字前面要加 kimi-coding/，比如 kimi-coding/k2p5。它们俩的钥匙和家（baseUrl）也都不一样，千万不能搞混。
• 如果你在中国，想请普通的 Kimi，它的家地址要写成 https://api.moonshot.cn/v1。如果不是在中国，就写成 https://api.moonshot.ai/v1。
• 邀请卡里写的 Kimi 能记住多长的对话（contextWindow），如果以后 Kimi 的爸爸妈妈说这个数字变了，你也要记得在你的邀请卡里改过来。