当你刚安装好 OpenClaw 后，它其实什么都不会做。它不会自动运行，也不会主动回复，更不会执行任务。
安装只是把框架放到你电脑里。要让它真正“活起来”，你必须完成基础设置。
这篇文章带你一步一步理解每一步在干什么、为什么要做、出问题怎么办。
核心只有三件事：
- 安装并运行官方向导（onboard）
- 接入 Kimi 最新模型 K2.5（Moonshot AI）
- 启动 Gateway 并测试
1. 确认你已安装 OpenClaw CLI
openclaw --version
看到版本号（如 0.12.x 或更新）就成功。
没找到命令？
- 关掉终端重新打开
- 或重新运行安装脚本：
Mac/Linux：
curl -fsSL https://openclaw.ai/install.sh
Windows：
iwr -useb https://openclaw.ai/install.ps1
2. 运行官方 Onboard 向导（最推荐的第一步）
openclaw onboard --install-daemon
向导中：
- Onboarding mode → Quickstart
- Model provider → 先 Skip for now（后面手动加 Kimi）
- 其他问题默认或 Skip
向导完成后，默认工作空间已创建（~/.openclaw/workspace），所有配置、记忆、技能都在这里。
3. 获取 Kimi API Key 并设置环境变量
- 打开 Moonshot AI 平台 注册登录（或 https://platform.moonshot.ai），在控制台 → API Keys 生成 Key。
- 设置环境变量（推荐用 MOONSHOT_ 前缀，永久生效）：
Mac / Linux（加到 ~/.zshrc 或 ~/.bashrc）：
export MOONSHOT_API_KEY="sk-你的KimiAPIKey"
Windows PowerShell：
$Env:MOONSHOT_API_KEY="sk-你的KimiAPIKey"
重启终端生效。
4. 配置 Kimi 为专用 Provider
用 VS Code 打开配置文件：
code ~/.openclaw/openclaw.json
加入或合并以下内容：
{
"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 (最新多模态模型)",
"reasoning": true,
"input": ["text", "image"],
"contextWindow": 256000,
"maxTokens": 8192
},
{
"id": "kimi-k2-thinking",
"name": "Kimi K2 Thinking (专用深度推理)",
"reasoning": true,
"input": ["text"],
"contextWindow": 256000,
"maxTokens": 65536
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "moonshot/kimi-k2.5"
},
"models": {
"moonshot/kimi-k2.5": {},
"moonshot/kimi-k2-thinking": {}
}
}
}
}
中国用户推荐用 https://api.moonshot.cn/v1（延迟更低）。
海外用户可改成 https://api.moonshot.ai/v1。
保存后重启 Gateway：
openclaw gateway restart
5. 启动并检查核心服务 Gateway
openclaw gateway status # 应显示 running
# 前台启动测试（可选）
openclaw gateway --port 18789
端口冲突？用 lsof -i:18789 关闭占用程序，或换端口。
6. 测试是否成功
方法一：浏览器 Dashboard（最推荐）
openclaw dashboard
输入：
“你好，测试一下 Kimi K2.5 模型连接是否正常”
正常回复 → 全部成功！
方法二：命令行 TUI 测试
openclaw tui
常见错误排查
问题1：模型列表看不到 kimi-k2.5
openclaw models list | grep kimi
没显示 → 检查 JSON 是否正确保存，重启 gateway。
问题2：提示 API Key 无效
echo $MOONSHOT_API_KEY检查是否生效- 重启终端 + gateway
问题3：Dashboard 打不开
openclaw gateway restart
问题4：想切换成思考专用模型
把 primary 改成 "moonshot/kimi-k2-thinking" 再重启即可。
问题5：海外延迟高
把 baseUrl 改成 https://api.moonshot.ai/v1 并重启。
下一步可以做什么
你现在拥有：
- 稳定运行的 Gateway
- 接入 Kimi 最新 K2.5 多模态模型（高性价比 + 视觉能力）
- 默认工作空间就绪
接下来推荐：
- 接入 Telegram / WhatsApp（Dashboard → Channels 一键配置）
- 安装插件 / Skills（
openclaw plugins install ...） - 开机自启（onboard 已装 daemon）
- 部署到服务器长期运行
- 自定义 AI 性格（编辑 workspace 里的 SOUL.md）
完成！
现在你的 OpenClaw 已真正“活了”，而且用的是 2026 年最新最强的 Kimi K2.5 模型。