跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashNode.jsAI

Mac mini M4 部署 OpenClaw + Ollama 本地大模型接入飞书机器人

介绍在 Mac mini M4 上通过 OpenClaw 框架结合 Ollama 运行 Qwen 2.5 模型，利用 WebSocket 接入飞书机器人的私有化部署方案。涵盖环境准备（Node.js、Ollama）、模型选型优化、配置文件修改、飞书事件订阅配置及调试步骤。

FlinkHero发布于 2026/4/6更新于 2026/5/2024 浏览
Mac mini M4 部署 OpenClaw + Ollama 本地大模型接入飞书机器人

随着 Mac mini M4 的发布，16GB 统一内存成为了本地跑 AI Agent 的绝佳土壤。本文将记录如何利用 OpenClaw 框架，配合 Ollama 运行的 Qwen 2.5 系列模型，通过 WebSocket 长连接接入飞书，实现一个完全私有化、极速响应的个人助理。

一、核心环境准备

硬件：Apple Mac mini M4 (16GB RAM)
系统：macOS Sequoia
模型后端：Ollama (运行 Qwen 2.5-7B)
Agent 框架：OpenClaw (v2026.3.2)
Node 版本：v24.14.0 (通过 nvm 管理)

二、避坑指南：环境初始化

在 Mac 终端部署时，首要解决的是权限与路径问题。

1. 终端常用快捷键

  • Ctrl+C：强制停止当前运行的命令（如安装卡死时）。
  • sudo：以管理员身份运行。若遇到权限不足，在指令前加 sudo 即可。

2. Node.js 环境修复

若遇到 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

三、模型选择：M4 性能调优

针对 16GB 内存，测试了不同参数量的模型：

  1. Qwen 2.5-14B：逻辑极强，但占用约 9GB 显存，响应稍慢。
  2. DeepSeek-R1-8B：推理能力卓越，但对 OpenClaw 的 Tools (函数调用) 兼容性一般。
  3. Qwen 2.5-7B (推荐)：秒回速度，完美支持自动化工具协议，是 M4 下的最佳平衡点。

安装命令：

ollama run qwen2.5:7b

四、OpenClaw 配置手术 (JSON 详解)

手动编辑 ~/.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"
}
}

五、飞书机器人接入：最后的临门一脚

很多同学卡在'机器人已上线但不回复'，请务必检查飞书后台：

  1. 启用机器人：在'应用功能'中确认开启。
  2. 事件订阅：必须添加 接收消息 (im.message.receive_v1) 事件。
  3. WebSocket 模式：在'事件订阅'中开启 WebSocket 模式。

版本发布：改了权限或事件后，必须创建新版本并点击'申请上线'，否则改动不生效！

六、运行与调试

启动网关并观察日志：

启动 Gateway

openclaw gateway --allow-unconfigured

第一次发消息需授权 (Pairing)

openclaw pairing approve feishu [验证码]

当日志出现 [ws] ws client ready 时，你的 M4 机器人就已经正式'活'过来了。

结语

通过 OpenClaw 与本地模型的结合，我们成功让 Mac mini M4 变成了一个 7x24 小时在线的智能助理。目前本地部署的 7B 模型还是远远不够的，后续可以使用付费 token 提升模型智力。

Q&A：

  • Q: 为什么报错 400: deepseek does not support tools?
  • A: 推理模型暂时无法处理 OpenClaw 的 JSON 函数调用格式，建议将 tools.profile 改为 minimal 或换用 Qwen 模型。

目录

  1. 一、核心环境准备
  2. 二、避坑指南：环境初始化
  3. 1. 终端常用快捷键
  4. 2. Node.js 环境修复
  5. 临时加载环境
  6. 永久写入配置
  7. 三、模型选择：M4 性能调优
  8. 四、OpenClaw 配置手术 (JSON 详解)
  9. 五、飞书机器人接入：最后的临门一脚
  10. 六、运行与调试
  11. 启动 Gateway
  12. 第一次发消息需授权 (Pairing)
  13. 结语
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫，关注极客日志

微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog

更多推荐文章

查看全部
  • 豆包 Seedream 4.0 多图融合技术解析与实战测评
  • AI 核心概念解析：从 LLM 到 Agent 的演进逻辑
  • Windows 本地编译 llama.cpp 完整流程
  • Python IDE 选型指南：PyCharm、VS Code 与 IDLE 对比
  • 昇腾平台 Llama-2-7b 大模型深度测评与部署方案
  • 分布式环境下高可靠性分布式锁的实现方案
  • 大模型 Agent Skills 设计详解
  • Meta-Llama-3-8B-Instruct 在 vLLM 加速下的多轮对话实践
  • 基于 Java 与 Vue 的大学生理财记账贷款系统
  • Llama 开源家族演进：从 Llama-1 到 Llama-3 深度解析
  • Java 线程池 ThreadPoolExecutor 入门：原理、核心参数与图解
  • IT 行业饱和背景下，为何网络安全成为热门转行方向？
  • Spring Boot 入门：Spring Web MVC 核心概念与实战解析
  • 基于 Java、GeoTools 与 PostGIS 的对跖点求解
  • Rust 与 WebAssembly 实战：浏览器与 Node.js 高性能应用
  • OpenClaw 架构解析：单进程设计与插件化扩展
  • JSP 文件上传详解
  • Java Web 开发学习：数据库知识复习与整理
  • AI 产品经理入门指南：核心技能与实战路径
  • OpenClaw 新功能：AI 直接解析 PDF 文档

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online

  • Markdown转HTML

    将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online