OpenClaw（前身Clawdbot/Moltbot）是一个开源的本地AI自主代理框架，能让你的电脑真正“活过来”：操作浏览器、执行脚本、管理文件、日程、定时任务、发消息等。全部数据本地存储，支持接入Kimi K2.5、Gemini、Claude等大模型，隐私强、自定义高。本文将手把手教你如何在MacBook上完成OpenClaw的安装和Kimi K2.5的配置。 一、为什么选择OpenClaw + Kimi K2.5？
1.1 Kimi K2.5的优势
• Moonshot AI旗舰模型，中文能力超强
• 多模态支持（文本+图像）
• Agent Swarm支持，适合复杂任务
• Token成本低（比Claude便宜80-90%）
• 免费额度高，适合测试使用
1.2 OpenClaw的特点
• 完全本地运行，数据隐私有保障
• 权限可控，支持多种安全策略
• 支持飞书/Telegram等多种通道接入
• 技能扩展丰富，可自定义功能
二、系统要求
在开始安装之前，请确保你的系统满足以下要求：
| |
| macOS Ventura或更高版本（Apple Silicon最佳） |
| ≥22（可通过brew install node@22安装） |
| |
| Moonshot AI账号（platform.moonshot.ai注册） |
三、一键安装OpenClaw
打开终端，运行官方安装脚本：
curl -fsSL https://openclaw.ai/install.sh | bash
安装后直接进入onboarding向导。如果已安装，可通过以下命令更新：
npm install -g openclaw@latest
四、Onboarding向导完整流程
运行以下命令启动配置向导：
openclaw onboard
关键选择（按顺序）：
4.1 Security warning
输入“Yes”（读懂风险再继续，这是高权限工具）
4.2 Config handling
选择“Use existing values”（保留旧配置，避免重填）
4.3 Default model
选择“moonshot/kimi-k2.5”（或手动输入）
4.4 Enable hooks
全选以下三个hook（强烈推荐）：
• boot-md：启动时加载系统提示
• command-logger：记录命令执行日志
• session-memory：会话记忆功能
4.5 Gateway service
如果已安装，选择“Restart”重启服务
4.6 Install shell completion
选择“Yes”（终端Tab补全超方便）
向导结束会自动打开dashboard（http://127.0.0.1:18789/），保持tab打开。
五、配置Moonshot Kimi K2.5 API Key
这是最关键的一步，配置不当会导致silent fail。Kimi API兼容OpenAI格式，但必须提供key。
5.1 获取API Key
1. 登录Moonshot平台：https://platform.moonshot.ai/console/api-keys
2. 创建新API Key（sk-开头）
5.2 设置环境变量
设置环境变量（永久生效）：
export MOONSHOT_API_KEY="sk-你的完整key" echo 'export MOONSHOT_API_KEY="sk-你的完整key"' >> ~/.zshrc source ~/.zshrc
5.3 编辑配置文件
编辑config引用env（nano ~/.openclaw/openclaw.json）：
在“models.providers.moonshot”对象中添加：
"apiKey": "${MOONSHOT_API_KEY}",
并确保models数组有kimi-k2.5定义：
{ "id": "kimi-k2.5", "name": "Kimi K2.5", "reasoning": true, "input": ["text", "image"], "contextWindow": 131072, "maxTokens": 8192 }
5.4 重启Gateway
openclaw gateway restart
六、常见问题排查与修复
6.1 Gateway status显示running，但dashboard无响应/1006 abnormal closure
原因：gateway crash或websocket连接异常。
修复步骤：
# 确认端口空闲 lsof -i :18789 kill -9 # 如果占用# 重启并检测 openclaw gateway restart openclaw gateway probe # 应显示success openclaw gateway status # 确认running + listening # 查看实时日志 openclaw gateway logs --follow
6.2 Gateway start blocked: set gateway.mode=local
原因：config中gateway.mode未设或解析失败。
openclaw config set gateway.mode local openclaw gateway restart
6.3 Kimi不回复/silent fail
原因：API key未加载。
# 确认env echo $MOONSHOT_API_KEY # 必须显示sk-... # 健康检查 openclaw health --deep
七、测试与上手玩法
1. 打开dashboard：
openclaw dashboard
2. 输入：“你好，今天天气怎么样？” → 正常回复即成功。
3. 进阶玩法：
• 定时任务：“设置每天早8点推送新闻到终端”
• 加通道：“openclaw channels login feishu”（飞书最稳）
• 个性化：编辑~/.openclaw/BOOT.md加系统提示，重启gateway
结语
通过以上步骤，Mac用户能快速部署OpenClaw + Kimi K2.5组合，打造私人AI助理。如果卡在具体报错，复制终端输出搜索“OpenClaw [你的错误]”，社区教程丰富。玩得开心，但别让它太自由哦~
