Rubo Wang’s Website

Openclaw 在 Mac mini 上的安装、启动、使用、完全卸载与清理

Fri, 20 Mar 2026 00:00:00 GMT

环境说明

设备：搭载 Apple Silicon M4 芯片的 Mac，32GB 统一内存

本地大模型：Qwen 3.5 27B（通过 Ollama 运行，零 API 费用）

云端备用模型：DeepSeek（或其他兼容 OpenAI 格式的 API）

模型路由中间件：LiteLLM（统一管理本地和云端模型）

控制入口：飞书（长连接 WebSocket 模式）

进程守护：PM2（替代 macOS 原生 LaunchAgent，防止两者冲突）

第一阶段：准备基础环境

1.1 安装 Homebrew

打开 Mac 的终端（Terminal.app），运行：

注意（M4 芯片必做）：安装结束后，终端底部会打印两行以 eval 开头的命令。请将这两行复制出来，粘贴到终端里运行，否则后续所有 brew 命令会报找不到命令的错误。

1.2 安装 Node.js 和 Python

1.3 解决 nvm 与 Homebrew 的 Node.js 版本冲突

如果 Mac 上已安装 nvm（Node 版本管理器），Homebrew 安装的 Node 和 nvm 管理的旧版 Node 会产生冲突，导致 OpenClaw 安装时报 requires Node.js 20+ 错误。

使用 nvm 安装并固定 Node 20 LTS 版本：

运行以下命令确认版本输出为 v20.x.x 后再继续：

1.4 安装 PM2

第二阶段：安装本地大模型（Qwen 3.5 27B）

2.1 安装 Ollama

前往 ollama.com 下载并安装 Mac 客户端。安装完毕后，打开 Ollama.app，确认屏幕右上角菜单栏出现羊驼图标。

2.2 拉取 Qwen 3.5 27B 修正版

注意：请勿直接运行官方 ollama pull qwen3.5。官方版本存在工具调用（Tool Calling）缺陷，会导致 OpenClaw 无法正确识别 AI 的指令。请使用以下社区修正版本：

拉取完毕后，测试是否可以正常对话：

收到正常回复后按 Ctrl+D 退出。Ollama 会继续在后台运行，监听本地 http://localhost:11434。

第三阶段：安装并配置 LiteLLM

3.1 安装 LiteLLM

3.2 创建 LiteLLM 配置文件

按 i 进入插入模式，粘贴以下内容（将 DeepSeek 的 API Key 替换为真实密钥；如暂无云端 Key，可删除 cloud-fallback 节点）：

按 Esc 退出插入模式，输入 :wq 保存并退出。

3.3 找出 LiteLLM 的绝对路径

PM2 作为后台服务不会继承终端的环境变量，必须使用绝对路径：

记下输出的路径（例如 /opt/homebrew/bin/litellm）。

3.4 创建 LiteLLM 启动脚本

按 i 进入插入模式，粘贴以下内容（将路径替换为上一步找到的真实路径）：

按 Esc，输入 :wq 保存退出，然后赋予执行权限：

3.5 测试 LiteLLM 是否正常启动

确认输出中包含 LiteLLM: Proxy initialized 和 Uvicorn running on http://0.0.0.0:4000，按 Ctrl+C 退出。

第四阶段：安装并配置 OpenClaw

4.1 全局安装 OpenClaw

4.2 授予 Mac 系统权限

点击屏幕左上角苹果图标 -> 系统设置 -> 隐私与安全性，依次找到以下三项，为"终端（Terminal）"打上勾：

辅助功能（Accessibility）

屏幕录制（Screen Recording）

完全磁盘访问权限（Full Disk Access）

4.3 创建 OpenClaw 配置文件

按 i 进入插入模式，粘贴以下内容（将飞书的 appId 和 appSecret 替换为真实值，获取方式见第五阶段）：

按 Esc，输入 :wq 保存退出。

4.4 验证配置文件

确认输出中没有红色 ERROR 报错后继续。

第五阶段：对接飞书（Feishu）

5.1 创建飞书自建应用

浏览器打开飞书开放平台，使用飞书账号登录。

点击创建企业自建应用，填写应用名称（例如"Mac 管家"）和图标。

5.2 获取 App ID 和 App Secret

在左侧菜单点击凭证与基础信息，复制 App ID 和 App Secret，填入 openclaw.json 的对应字段。

填完后，重新打开配置文件更新：

5.3 添加机器人能力

在左侧菜单点击添加应用能力，选择并添加机器人（Bot）。

5.4 配置事件订阅

在左侧菜单点击事件与回调：

订阅方式选择：通过长连接接收事件（WebSocket）

此步骤为机器人能否收到消息的关键，选错会导致 400 连接错误，机器人完全无响应。

点击添加事件，搜索并添加 im.message.receive_v1（接收消息）。

5.5 配置权限

在左侧菜单点击权限管理，搜索并开通以下权限：

在左侧菜单点击权限管理。

点击页面右上角的批量导入（Batch Import）按钮。

将以下 JSON 完整粘贴进去，点击批量申请开通：

权限名称	用途
`im:message`	读取与发送消息（核心权限）
`im:message:send_as_bot`	以机器人身份发送消息
`im:message:readonly`	读取消息历史
`im:message.p2p_msg:readonly`	读取私聊消息
`im:message.group_at_msg:readonly`	读取群聊中被 @ 的消息
`im:chat.members:bot_access`	机器人加入群聊
`im:resource`	读取消息中的图片/文件资源
`contact:user.employee_id:readonly`	读取用户工号（用于身份识别）
`contact:user.email:readonly`	读取用户邮箱
`cardkit:card:read` / `write`	读取和发送飞书消息卡片
`application:bot.menu:write`	配置机器人菜单

如果还希望 OpenClaw 能操作飞书文档、多维表格、云盘，还需要额外开通以下权限（可选）：
docs:doc — 读写飞书文档
sheets:spreadsheet — 读写飞书电子表格
bitable:app — 读写多维表格
drive:drive — 读取云盘文件
calendar:calendar — 读写日历

5.6 发布版本

在左侧菜单点击版本管理与发布 -> 创建版本，填写版本号（如 1.0.0），点击发布。

如需管理员审核，前往飞书客户端工作台 -> 应用管理通过审核后方可生效。

注意：每次修改权限、事件订阅或应用能力后，均需重新发布一个新版本才能生效。

第六阶段：用 PM2 托管所有服务

6.1 创建 OpenClaw 启动脚本

找出 OpenClaw 的绝对路径：

创建启动脚本：

按 i 进入插入模式，粘贴以下内容（将路径替换为实际路径）：

按 Esc，输入 :wq 保存退出，赋予权限：

6.2 使用 PM2 启动所有服务

6.3 配置开机自启动

注意：该命令会在终端中打印一行以 sudo env PATH=... 开头的新命令。请将该命令完整复制后，粘贴回终端运行，输入 Mac 开机密码确认授权。

然后保存当前进程列表：

6.4 验证运行状态

确认 litellm 和 openclaw 均显示为绿色的 online。

第七阶段：飞书使用与模型切换

日常使用

打开飞书，搜索并打开创建的机器人，发送任意消息。机器人会使用本地 M4 Mac 上的 Qwen 27B 进行回复，数据不经过任何外部服务器。

飞书内快速切换模型

飞书指令	效果
`/model`	查看当前使用的模型
`/model local-qwen27b`	切换到本地 Qwen 模型
`/model deepseek-chat`	切换到云端 DeepSeek 模型
`/status`	查看网关运行状态

附录一：日常维护命令速查

操作	命令
查看所有服务状态	`pm2 status`
查看 OpenClaw 实时日志	`pm2 logs openclaw`
查看 LiteLLM 实时日志	`pm2 logs litellm`
重启 OpenClaw	`pm2 restart openclaw`
重启 LiteLLM	`pm2 restart litellm`
临时停止所有服务	`pm2 stop all`
取消开机自启	`pm2 unstartup`

附录二：关闭与卸载步骤

临时停止服务

取消开机自启

完全卸载

按照以下顺序执行，确保彻底清理：

清除系统权限：进入系统设置 -> 隐私与安全性，在"辅助功能"、"屏幕录制"、"完全磁盘访问权限"列表中，选中并删除"终端"的授权。

附录三：常见报错速查表

报错信息	原因	解决方案
`requires Node.js 20+`	nvm 锁定了旧版本	运行 `nvm install 20 && nvm alias default 20`
`Unrecognized key: "provider"`	配置文件格式为旧版	将根节点改为 `models.providers`
`models.providers.litellm.models: expected array`	缺少 `models` 数组	在 `litellm` 配置块中添加 `models: [...]`
`Gateway start blocked: set gateway.mode=local`	未指定网关模式	运行 `openclaw config set gateway.mode local`
`Cannot destructure property 'tenant_access_token'`	App ID/Secret 错误或应用未发布	核对密钥，并在飞书后台重新发布版本
`Request failed with status code 400 (ws)`	飞书未开启长连接订阅	在飞书开发者后台将订阅方式改为"长连接"并重新发布
`Restarted LaunchAgent` 无限循环	PM2 与 macOS LaunchAgent 冲突	运行 `launchctl unload ~/Library/LaunchAgents/ai.openclaw.gateway.plist`
`PM2 [ERROR] File not found`	PM2 将命令字符串当文件名	用绝对路径启动脚本代替内联命令
`pm2 status: errored`	Python 环境路径不匹配	用 `which litellm` 找绝对路径，并写入启动脚本
`/bin/bash: gateway: No such file or directory`	PM2 无法识别子命令参数	将 `openclaw gateway run` 写入 Shell 脚本，由 PM2 执行脚本
飞书点开机器人没有输入框	事件未订阅或版本未发布	添加 `im.message.receive_v1` 事件后重新发布版本
发消息机器人不回复	`dmPolicy` 限制或权限未开通	配置文件中设置 `"dmPolicy": "open"` 和 `"allowFrom": ["*"]`

在 Mac mini 上搭建私有云 Nextcloud（Docker + OrbStack 完整指南）

Mon, 02 Mar 2026 00:00:00 GMT

本文面向想把闲置 Mac mini 变成自托管私有云的用户。
方案特点：容器化部署稳定不崩溃、支持本地大硬盘目录挂载、可接入 Cloudflare Tunnel 实现外网访问、支持 iPhone 照片自动备份。

1. 方案说明

为什么用 Docker 而不是原生安装

Nextcloud 依赖 PHP、Web 服务器和大量扩展，在 macOS 上原生安装依赖极其复杂，且版本升级容易出问题。使用 Docker 容器化部署，环境隔离、开箱即用、易于维护。

Apple Silicon 注意事项

在 M1/M2/M3 等 Apple Silicon 芯片的 Mac mini 上，如果 Docker 拉取了 amd64 架构的镜像，系统会通过 Rosetta 或 QEMU 模拟运行，这种跨架构模拟极易导致 Apache/PHP 崩溃，日志里出现：

解决方法很简单：启动容器时加 --platform linux/arm64，强制使用原生镜像。

2. 安装 Docker 运行环境（OrbStack）

OrbStack 是专为 macOS 优化的 Docker 运行环境，比 Docker Desktop 更轻量、省电且启动更快，尤其在 Apple Silicon 上表现优秀。

2.1 安装 OrbStack

前提：已安装 Homebrew。

2.2 开机自启设置

打开 OrbStack 应用 → 左上角菜单 → Settings → General，

勾选 Start at Login（登录时启动）。这是后续无人值守的基础。

2.3 验证 Docker 可用

有正常输出即可。

3. 准备目录与端口规划

3.1 端口说明

服务	宿主机端口
Nextcloud 网页	`8081`

建议使用 8081 避免与 macOS 上其他服务（如 Nginx、Apache）的 80/443 冲突。

如果你有其他服务占用了 8081，可改为 8082、8088 等。

3.2 准备你想挂载进 Nextcloud 的本地目录

也可以使用外接硬盘的路径，例如 /Volumes/MyHardDrive/Files，

只要这个目录在 Docker 启动时确保已挂载上即可。

4. 启动 Nextcloud 容器

4.1 清理旧残留（如果之前装过）

如果以前装过 Nextcloud 且状态混乱，先清理干净：

⚠️ 以上命令会删除容器和 Nextcloud 的数据库，全新开始时使用。

4.2 启动容器（核心命令）

参数详解：

参数	作用
`--restart always`	Docker 引擎启动后自动拉起容器
`--platform linux/arm64`	强制使用 arm64 原生镜像，防止 M 芯片上的段错误崩溃
`-p 8081:80`	将容器的 80 端口映射到宿主机 8081
`PHP_MEMORY_LIMIT=1024M`	给 PHP 足够内存处理大图片/视频缩略图
`PHP_UPLOAD_LIMIT=16G`	允许上传大文件（实际还受分块策略影响）
`-v nextcloud_data:/var/www/html`	使用 Docker 托管卷存放 Nextcloud 核心系统，最稳定
`-v ~/Nextcloud_Files:/mnt/storage`	把 Mac 本地目录穿透进容器，用作外部存储
`nextcloud:stable`	使用稳定版镜像（而非 `latest`，稳定性更好）

5. 首次安装与初始化

5.1 访问安装页

启动容器后等待约 30 秒（容器内部在解压核心文件），然后打开浏览器访问：

http://localhost:8081

5.2 安装向导

你将看到 Nextcloud 的安装向导：

设置管理员用户名和密码（请妥善保存，无找回功能）。

数据库部分：保持默认选中 SQLite（适合个人/家庭使用，无需额外配置）。

点击 "安装 (Install)" 并等待。

安装完成后会自动跳转到 Nextcloud 首页，这代表一切正常。

5.3 确认容器状态正常的常用命令

6. 配置受信任域名（trusted_domains）

Nextcloud 默认只信任安装时的域名（通常是 localhost）。

如果你想通过局域网 IP 或公网域名访问，会看到：

通过不被信任的域名访问 (Access through untrusted domain)

解决方法： 使用 Nextcloud 官方的 occ 命令行工具将新地址加入白名单，

无需手动修改 config.php，执行后立即生效。

6.1 信任局域网 IP

如何查看 Mac mini 的局域网 IP：系统设置 → 网络 → 点击当前 Wi-Fi/有线连接 → 查看 IP 地址。

6.2 信任公网域名

7. 挂载本地目录（External Storage）

通过"外部存储"功能，可以把你 Mac mini 上的任意本地目录、外接硬盘，

作为 Nextcloud 里的一个文件夹来管理，非常灵活。

7.1 启用 External Storage 应用

右上角头像 → "应用 (Apps)"

左侧菜单找到 "未启用的应用" 或通过搜索找到 External storage support

点击 "启用 (Enable)"

7.2 添加本地目录挂载

右上角头像 → "管理设置 (Administrative settings)"

左侧菜单 → "外部存储 (External storages)"

点击 "添加存储 (Add storage)"，填写如下：

字段	填写内容
文件夹名称	随意，如 `本地文件`
外部存储类型	本地 (Local)
身份验证	无 (None)
配置 / 路径	`/mnt/storage`
可用对象	留空（仅管理员）或选择指定用户

点击右侧的 "✓ 对钩" 保存。左侧出现绿色圆点代表挂载成功。

此处填写的是容器内部的路径 /mnt/storage，而不是 Mac 上的路径，
这正是我们在 docker run 命令里通过 -v ~/Nextcloud_Files:/mnt/storage 映射进去的。

现在你可以：

在 Nextcloud 网页上传文件 → 自动落到 Mac 的 ~/Nextcloud_Files

在 Mac Finder 里直接往 ~/Nextcloud_Files 拖文件 → Nextcloud 里自动可见

8. 配置 Cloudflare Tunnel 外网访问（可选）

如果你使用 Cloudflare Tunnel 将内网服务暴露到公网，

只需在 Tunnel 的 Public Hostnames 中添加一条记录：

字段	值
Subdomain	`cloud`
Domain	`yourdomain.com`
Type	HTTP
URL	`localhost:8081`

配置好后，https://cloud.yourdomain.com 即可从任何地方访问你的 Nextcloud。

9. 修复 iOS 客户端授权无反应

当 Nextcloud 经过 Cloudflare 等反向代理后，iOS 客户端在点击

"Grant Access（授权访问）" 时，可能会卡住没有任何反应。

原因： Nextcloud 不知道自己被套了 HTTPS 反代，

生成了 http:// 开头的授权回调链接；iOS 的安全策略拒绝接受非 HTTPS 的跳转。

修复方法（执行后立即生效，无需重启容器）：

配置完成后，彻底关闭手机上的 Nextcloud App 再重新打开，

重新登录时"Grant Access"按钮将正常响应并跳转。

提示： 设置 overwriteprotocol=https 后，
如果你用 http://192.168.x.x:8081 访问会出现 400 Bad Request，
这时要么通过域名访问内网（配合路由器 DNS 劫持），
要么临时删除该配置项：

10. iPhone 照片自动备份

10.1 App 内配置

App Store 安装官方 Nextcloud 客户端

输入服务器地址（如 https://cloud.yourdomain.com）并登录

右下角 "更多 (More)" → "设置 (Settings)" → "自动上传 (Auto upload)"

开启 自动上传照片 和 自动上传视频

建议开启 "使用子文件夹（按年/月整理）"（自动分类便于管理）

如需省流量，开启 "仅在 Wi-Fi 时上传"

10.2 iOS 系统权限（必须设置，否则后台不上传）

打开 iPhone "设置" → 找到 Nextcloud → 修改以下权限：

权限	设置为
位置 (Location)	始终 (Always)
后台 App 刷新	开启
照片 (Photos)	完全访问

原理： Nextcloud iOS 利用系统的位置变化事件在后台唤醒上传进程，
因此"位置：始终"是后台能自动上传的关键，
这不会增加明显的电量消耗。

10.3 最佳实践

插电 + 连 Wi-Fi 时，系统会给 Nextcloud 更多后台时间，上传速度和成功率最高。

不要在多任务界面强行上滑关掉 Nextcloud，这会彻底阻止后台运行。

对于十几 GB 的 4K 大视频，建议在家里连局域网，打开 App 前台上传，避免 Cloudflare 的超时限制。

11. 开机自启与无人值守

实现"断电重启后所有服务自动恢复"，需要同时满足三个条件：

11.1 Mac 硬件：来电自动开机 + 永不休眠

11.2 Mac 账户：自动登录

系统设置 → 用户与群组 → 登录选项 → 开启 自动登录 并选择你的账户。

因为 OrbStack（Docker 引擎）需要用户登录桌面后才能完整启动，
自动登录是无人值守的前提。

11.3 OrbStack：登录时自动启动

OrbStack 主界面 → Settings → General → 勾选 Start at Login。

OrbStack 启动后，由于容器设置了 --restart always，

Nextcloud 容器会在几秒内自动恢复运行。

11.4 验证自启配置

至此，你的 Mac mini 实现了真正的无人值守：

断电 → 来电 → 自动开机 → 自动登录 → OrbStack 自启 → Nextcloud 容器自启 → 全部恢复正常。

12. 常见错误排查

12.1 「通过不被信任的域名访问」

加入 trusted_domains 白名单（见第 6 节）。

12.2 「iOS Grant Access 无反应」

设置 overwriteprotocol 和 overwrite.cli.url（见第 9 节）。

12.3 「502 Bad Gateway / localhost 打不开」

容器崩溃或正在重启循环。查看日志定位原因：

12.4 「Segmentation fault (11)」崩溃

镜像架构不匹配。先完全清理，再带 --platform linux/arm64 重新启动：

12.5 「Cloudflare Error 524」上传大文件超时

524 是 Cloudflare 等了超过 100 秒后端没响应所致。

解决方法：

大批量备份时，在家连局域网，App 里用 http://192.168.x.x:8081 直连内网上传（不经 Cloudflare）。

将 Nextcloud iOS App 里的分块大小设置为 10~20 MB（Settings → Advanced → Chunk size）。

12.6 「Internal Storage not working」外部存储红灯

检查容器启动命令里是否有对应的 -v 挂载；并确认容器内路径填写正确（不是 Mac 本地路径）：

附录：快速命令速查

Mac Mini打造外网可访问的S3&WebDAV存储

Mon, 02 Mar 2026 00:00:00 GMT

对于研究者而言，拥有一个大容量、高可用且外网可随时访问的数据中转站至关重要。本文将详细介绍如何利用闲置的 Mac mini，通过纯原生方式部署 MinIO（S3 兼容存储）和 Rclone（转换为 WebDAV），并结合 Cloudflare Tunnel 实现免公网 IP 的安全域名访问。整个方案资源占用极低，且能完美绕过 Cloudflare 免费版的单次 100MB 上传限制。

零、基础环境与网络准备

1. 禁用 Mac mini 休眠

为保证服务器 24 小时在线，需彻底关闭休眠机制：

2. 开启 SSH 访问

进入 系统设置 > 通用 > 共享，打开 远程登录 开关，以便后续无头（Headless）管理。

一、原生部署 MinIO (S3 兼容存储)

相比 Docker 虚拟机，原生安装能最大化压榨 Mac 的读写性能。

1. 安装与目录准备

2. 配置环境变量

创建一个环境变量文件来存储账号密码和公网域名（假设您之后打算绑定的域名为 s3.yourdomain.com 和 console.yourdomain.com）：

⚠️ 注意：MINIO_ROOT_PASSWORD 必须至少 8 位，否则服务无法启动。

3. 配置开机自启 (Launchd)

创建 macOS 原生的 LaunchAgent 服务文件。首先使用 whoami 查看您的系统用户名（例如 rubo）。

新建并编辑配置文件：

粘贴以下内容（务必将所有的 rubo 替换为您真实的用户名）：

保存后，加载并启动服务：

此时 MinIO 已经在本地的 9000 (API) 和 9001 (Web 控制台) 端口运行了。

二、部署 Rclone (将 S3 桥接为 WebDAV)

许多文献管理软件（如 Zotero）只支持 WebDAV，我们可以用 Rclone 在本地将 S3 实时映射为 WebDAV 服务。

1. 安装与配置 Rclone

运行 rclone config，按以下交互指引配置本地 MinIO 节点：

按 n 新建 remote，命名为 myminio

Storage 选 s3

Provider 选 Minio

env_auth 选 false

access_key_id 填您上面设置的 admin_ai_research

secret_access_key 填 YourStrongPassword123

region 填 us-east-1

endpoint 填 http://127.0.0.1:9000 (内网通信，填本地地址)

其余选项一路回车默认，最后按 y 保存并 q 退出。

2. 配置 WebDAV 开机自启

创建日志目录：

新建 plist 服务文件：

粘贴以下内容（注意替换 rubo 为您的用户名，并自定义 WebDAV 的独立账号 davuser 和密码 davpass123）：

加载并启动服务：

现在 WebDAV 运行在本地的 8080 端口。

三、配置 Cloudflare Tunnel (公网域名访问)

通过零信任隧道，无需公网 IP 即可安全暴露服务。

1. 安装并授权 Tunnel

在 Mac mini 终端安装 cloudflared：

登录 Cloudflare Zero Trust，在 Networks > Tunnels 点击 Create a tunnel。选择 Cloudflared，选择 Mac 操作系统，复制并执行控制台提供的以 sudo cloudflared service install... 开头的长命令。随后启动隧道：

2. 配置路由映射 (Public Hostnames)

在隧道的配置页面，添加以下三条映射记录（注意 Type 全部选 HTTP）：

MinIO API (用于代码读写大模型)

Subdomain: s3

URL: localhost:9000

MinIO Console (用于浏览器管理和分享链接)

Subdomain: console

URL: localhost:9001

WebDAV (用于 Zotero 或访达挂载)

Subdomain: webdav

URL: 127.0.0.1:8080 (⚠️ 注意这里填 127.0.0.1 而非 localhost，以避免 502 报错)

💡 关键修复：WebDAV 防 400 报错设置 编辑刚刚建好的 webdav 规则，展开 Additional application settings > HTTP settings，在 HTTP Host Header 中填入 webdav.yourdomain.com，然后保存。这能解决因反向代理导致 Rclone 域名验证失败的问题。

四、优雅绕过 Cloudflare 的 100MB 上传限制

Cloudflare 免费版限制单次 HTTP 请求不得超过 100MB。突破此限制的核心是强制使用 S3 的分块上传（Multipart Upload）。

1. 在 Python 代码中（boto3）

使用 TransferConfig 封装上传函数：

2. 在命令行中（AWS CLI）

在使用 AWS CLI 的机器上执行一次全局配置：

此后所有的 aws s3 cp 都会自动分块绕过限制。

⚠️ 避坑指南：避免在 Web Console (浏览器) 或 WebDAV 挂载端上传大于 100MB 的单体文件，大模型权重和数据集请统一走 S3 API/CLI。

至此，您的 Mac mini 已经成为了一台安全、高效且跨网可达的数据中心。