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

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

Mac mini M4 部署 OpenClaw 框架配合 Ollama 运行 Qwen 2.5 模型,通过 WebSocket 长连接接入飞书实现私有化智能助理。核心步骤包括 Node.js 环境修复、模型性能调优、OpenClaw JSON 配置详解、飞书机器人事件订阅设置以及网关启动调试。解决了权限路径、工具调用兼容性等问题,最终实现本地 Agent 快速响应。

未来可期发布于 2026/3/28更新于 2026/10/2490 浏览
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 配置手术 (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. 二、避坑指南:环境初始化在 Mac 终端部署时,首要解决的是权限与路径问题。
  4. 1. 终端常用快捷键
  5. 2. Node.js 环境修复
  6. 临时加载环境
  7. 永久写入配置
  8. 三、模型选择:M4 性能调优
  9. 四、OpenClaw 配置手术 (JSON 详解)
  10. 五、飞书机器人接入:最后的临门一脚
  11. 六、运行与调试
  12. 启动 Gateway
  13. 第一次发消息需授权 (Pairing)
  14. 结语

更多推荐文章

查看全部
  • 视觉 Transformer (ViT) 技术原理及三篇经典论文解析
  • 2026 年 3 月全球 AI 前沿动态与技术突破
  • OpenClaw 在 WSL Ubuntu 及 CentOS 虚拟机安装与飞书对接教程
  • 大模型(LLM)在金融投资领域的应用
  • 阿里开源 Page-Agent:一行 JS 实现大模型前端 DOM 操控
  • WebGL 矩阵基础:平移、旋转、缩放与复合变换实战
  • AI 安全:大模型提示词注入攻击分类、原理与技术解析
  • 2026年机器人系统架构解析:从运动控制到VLA大模型的技术路径
  • 2024-2025 旗舰 LLM 架构演进:MoE 稀疏革命与 KV-cache 优化设计
  • 动态规划全局最优:在字符候选集中搜索最佳序列组合
  • Ubuntu 22.04下libwebkit2gtk-4.1-0安装指南
  • 基于 Nanobot 构建轻量级 QQ AI 机器人及搜索模块优化实践
  • 低代码 AI 化:是否正在重构开发行业格局?
  • Spring AI 基于 Ollama Qwen7B 和 PGVector 构建 RAG 问答系统
  • Ollama v0.17.0 发布:OpenClaw 自动安装、Web 搜索及 Context 动态分配优化
  • FPGA 加速图像处理:核心算法全解析
  • 2026我为什么开始用 Megick:一个更轻量、更顺手的 AI 创作工作台
  • VSCode 中精准禁用 Copilot 代码补全:按语言与场景灵活配置
  • 主流无人机倾斜摄影三维建模服务商盘点
  • 前端日期格式化:Intl.DateTimeFormat 详解与替代方案

相关免费在线工具

  • 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