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

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

Mac mini M4 本地部署 OpenClaw 框架结合 Ollama 运行 Qwen 2.5 模型,通过 WebSocket 协议接入飞书机器人。涵盖 Node.js 环境配置、终端权限处理、模型参数选择及 JSON 配置文件编写。重点解决飞书应用事件订阅与网关启动授权问题,实现私有化智能助理的快速搭建与调试。

Ne0发布于 2026/4/7更新于 2026/5/2312 浏览
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. 终端常用操作

  • Control + 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 配置详解

手动编辑 ~/.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 机器人就已经正式'活'过来了。

运行成功

常见问题

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

目前本地部署的 7b 模型还是远远不够的,后续可以使用付费 token 提升模型智力。

目录

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

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

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

更多推荐文章

查看全部
  • 现阶段大模型的主要行业应用场景分析
  • MC.JS WEBMC1.8 十分钟搭建简易方块世界
  • Chrome 浏览器集成 Gemini 功能:网页浏览实时 AI 问答
  • Omnibox 2.0.3 爬虫源影视资源配置指南
  • 硅基流动免费获取大模型 API 密钥指南(含 DeepSeek)
  • HarmonyOS RcList 组件事件处理机制与应用示例
  • RabbitMQ 事务机制详解与 Spring 配置实践
  • Ubuntu 25.10 桌面版安装教程
  • nano banana 提示词资源网站推荐及使用技巧
  • 非连续道路 GeoJSON 生成连续性问题的 Java 实现与修复
  • OpenArm开源机械臂:颠覆传统协作机器人研发范式的低成本解决方案
  • 前端报错排查指南
  • AI-Goofish-Monitor:基于 Playwright 与多模态模型的闲鱼商品监控工具
  • AI-Goofish-Monitor:闲鱼智能监控机器人指南
  • Flutter 三方库 dart_webrtc 在鸿蒙系统上的适配指南
  • Python:self 详解
  • AI-Goofish-Monitor:基于 AI 与 Playwright 的闲鱼商品智能监控工具
  • 多模态大型语言模型训练指南:理解与交互文本、图像、视频及音频
  • AI-Goofish-Monitor:基于 Playwright 和 AI 的闲鱼商品监控工具
  • SQL Server 2022 安装配置与基础使用指南

相关免费在线工具

  • RSA密钥对生成器

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

  • Mermaid 预览与可视化编辑

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

  • 随机西班牙地址生成器

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

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online