Mac mini M4 部署 OpenClaw 框架结合 Ollama 本地大模型实现飞书机器人接入。通过配置 Node.js 环境、选择合适参数量模型（如 Qwen 2.5-7B）、调整 OpenClaw JSON 配置及启用飞书 WebSocket 事件订阅，完成私有化智能助理搭建。调试阶段需处理权限路径问题并授权 Pairing，确保 Gateway 正常启动与消息收发。
硬件：Apple Mac mini M4 (16GB RAM)
系统：macOS Sequoia
模型后端：Ollama (运行 Qwen 2.5-7B)
Agent 框架：OpenClaw
Node 版本：v24.14.0 (通过 nvm 管理)
在 Mac 终端部署时，首要解决的是权限与路径问题。
Ctrl+C：强制停止当前运行的命令（如安装卡死时）。sudo：以管理员身份运行。若遇到权限不足，在指令前加 sudo 即可。若遇到 zsh: command not found: openclaw，说明 NVM 路径未加载。
source ~/.nvm/nvm.sh && nvm use 24
echo 'export NVM_DIR="$HOME/.nvm"\n[ -s "$NVM_DIR/nvm.sh" ] && \ . "$NVM_DIR/nvm.sh"' >> ~/.zshrc && source ~/.zshrc
针对 16GB 内存，测试了不同参数量的模型：
安装命令：
ollama run qwen2.5:7b
手动编辑 ~/.openclaw/openclaw.json 是解决配置报错的最快方式。
关键配置项说明：
baseUrl: 必须指向 http://127.0.0.1。appSecret: 飞书后台的真实密钥（非 cli_ 开头）。tools.profile: 设置为 minimal 或 none 以减少小模型工具调用的报错。最终稳定版配置参考：
{
"models": {
"providers": {
"custom-127-0-0-1-11434": {
"baseUrl": "http://127.0.0.1",
"apiKey": "ollama",
"api": "openai-completions",
"models": [
{
"id": "qwen2.5:7b",
"reasoning": false
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "custom-127-0-0-1-11434/qwen2.5:7b"
}
}
},
"channels": {
"feishu": {
"enabled": true,
"appId": "cli_xxxxxxxx",
"appSecret": "xxxxxxxxxxxx",
"connectionMode": "websocket"
}
},
"gateway": {
"port": 18789,
"mode": "local"
}
}
若卡在'机器人已上线但不回复'，请务必检查飞书后台：
接收消息 (im.message.receive_v1) 事件。版本发布：改了权限或事件后，必须创建新版本并点击'申请上线'，否则改动不生效！
启动网关并观察日志：
openclaw gateway --allow-unconfigured
openclaw pairing approve feishu [验证码]
当日志出现 [ws] ws client ready 时，你的 M4 机器人就已经正式'活'过来了。
tools.profile 改为 minimal 或换用 Qwen 模型。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online