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

Mac Mini 部署 OpenClaw 本地 AI 智能体配置指南

Mac Mini 部署 OpenClaw 本地 AI 智能体涉及系统优化、环境配置及安全加固。通过禁用休眠、启用 SSH、安装 Node.js 及 Docker，结合配置文件调整实现 7×24 小时运行。重点包括防火墙设置、Docker 沙箱隔离、消息渠道集成及远程访问安全。运维阶段需监控日志、定期更新并管理 API 密钥，确保智能体稳定执行文件操作与任务调度。

编程诗人发布于 2026/4/10更新于 2026/10/2493 浏览

引言

开源 AI 智能体 OpenClaw 已成为技术圈热门话题，能将大语言模型的推理能力转化为真实的系统操作力。Mac Mini 凭借极致能效、静音运行、统一内存架构等特质，成为运行 OpenClaw 的理想宿主。本文将介绍如何将 Mac Mini 打造成全天候在线的 AI 数字管家，并探讨安全加固、性能优化与生产级部署的最佳实践。

一、为什么选择 Mac Mini + OpenClaw？

1.1 OpenClaw：本地 AI 智能体的核心价值

OpenClaw 是一个具备系统级权限的自主执行框架：

  • 文件系统操作：创建、编辑、删除文件，整理目录结构
  • 终端指令执行：运行 Shell 命令，调用系统工具
  • 应用控制：操作浏览器、日历、邮件等本地应用
  • 消息渠道集成：连接 Telegram/WhatsApp/iMessage 等
  • 工具链扩展：通过 Skills 插件系统调用数千种 API

其核心设计哲学是本地优先执行，兼顾隐私保护与低延迟。

1.2 Mac Mini 的核心优势

① 极致能效比：M4 芯片待机功耗极低，24×7 运行成本低。

② 统一内存架构：Apple Silicon 采用 CPU 与 GPU 共享内存池的设计，消除了数据在系统 RAM 与显存之间穿梭的性能瓶颈。

③ 真正的静音运行：风扇转速低，适合放置在家或办公室的 24 小时运行设备。

④ iMessage 独家支持：OpenClaw 的 iMessage 集成需要 macOS 环境。

1.3 硬件配置建议

配置项最低要求推荐配置说明
芯片M1M4/M4 ProM4 的神经网络引擎大幅提升本地推理能力
内存16GB32GB/64GB16GB 是基本流畅线，64GB 可运行大型本地模型
存储256GB512GB/1TB系统占用 + 日志缓存，本地模型需额外空间
网络Wi-Fi有线以太网7×24 运行必须使用有线连接保证稳定性

重要提示：如果仅使用云端 API，16GB M4 完全足够；如需运行本地模型，建议直接上 64GB。

二、环境准备与基础配置

2.1 系统设置优化

在开始安装前，需要对 Mac Mini 进行服务器化配置：

① 禁用休眠

# 查看当前休眠设置
pmset -g
# 禁用休眠（7×24 运行必需）
pmset -asleep0
pmset -a disksleep 0
pmset -a displaysleep 30
# 仅关闭显示器

② 启用 SSH 远程管理

  • 进入 系统设置 → 通用 → 共享
  • 开启'远程登录'（SSH）
  • 记录下 Mac Mini 的局域网 IP

③ 创建独立用户账户 为 OpenClaw 创建专用的标准用户（非管理员），实现权限隔离：

  • 系统设置 → 用户与群组 → 添加账户
  • 账户类型选择'标准'，命名为'openclaw-agent'

④ 安装必要工具

# 安装 Homebrew（包管理器）
/bin/bash -c"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装 Node.js 22+（OpenClaw 核心依赖）
brew install node@22
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 验证安装
node --version
npm --version
# 安装 Git（可选，用于技能插件管理）
brew install git
# 安装 Docker Desktop（强烈推荐用于沙箱隔离）
brew install --cask docker

为何需要 Docker？OpenClaw 官方安全指南建议将高风险指令（Bash 命令、文件写入）隔离在容器内运行，防止 AI 误操作损害宿主机。

2.2 硬件扩展建议

24×7 运行的 OpenClaw 需要连接多种外设。Mac Mini 有限的端口很快会成为瓶颈。

推荐配置：USB-C 扩展坞

  • 内置 NVMe SSD 插槽，用于存储 AI 模型和日志
  • 高速数据传输，不影响模型加载速度
  • 多个 USB-A/USB-C 端口，减少设备插拔

外置存储优势：将 OpenClaw 的所有数据（模型权重、会话日志、缓存文件）放在外置 SSD 上，既延长内置 SSD 寿命，又方便备份和迁移。

三、OpenClaw 安装与核心配置

3.1 一键安装（推荐）

# 使用官方安装脚本（自动处理依赖）
curl -fsSL https://openclaw.ai/install.sh | bash

安装过程中会提示确认风险及安装模式。

3.2 替代方案：npm 安装

# 全局安装最新版
npm install -g openclaw@latest
# 验证安装
openclaw --version

3.3 运行配置向导

openclaw onboard --install-daemon

配置向导将引导完成以下步骤：

步骤操作说明
1选择安装模式选择'Local/self-hosted'
2配置模型提供商可选择 OpenAI/Anthropic/Ollama 本地模型
3输入 API 密钥根据选择的提供商填写
4选择默认模型推荐 Claude 3.5 Sonnet（工具调用能力最稳健）
5连接消息平台选择 Telegram/WhatsApp 等（建议至少配置一个）
6安装后台守护选择 Yes，让 OpenClaw 随系统启动

重要提示：如果使用 Ollama 本地模型，需先启动 Ollama 服务并确认 API 地址，配置方式可参考官方文档。

3.4 关键配置文件解析

安装完成后，核心配置文件位于用户目录下：

~/.openclaw/
├── .env # 环境变量（API 密钥、工作路径）
├── config.yaml # 主配置文件
├── agents/ # 智能体配置
│   └── main/ # 默认智能体
└── logs/ # 日志文件
    └── audit.log # 敏感操作审计日志

必须修改的配置项：

# 编辑.env 文件
nano ~/.openclaw/.env 

# API 密钥（根据实际使用的提供商填写）
ANTHROPIC_API_KEY=sk-xxxxxxxxxxxxx
# OPENAI_API_KEY=sk-xxxxxxxxxxxxx
# Telegram 配置（用于远程控制）
TG_BOT_TOKEN=1234567890:ABCDEFghijklmnopqrstuvwxyz
ALLOWED_USER_IDS=123456789 # 仅允许指定用户 ID 访问，防入侵
# 工作路径隔离
WORKSPACE_PATH="/Users/openclaw-agent/openclaw_workspace"
# 限制 AI 可操作目录
# 代理配置（国内用户必需）
HTTPS_PROXY=http://127.0.0.1:7890

# 编辑 config.yaml
nano ~/.openclaw/config.yaml 

gateway:
  bind: "loopback" # 仅监听本地，防止外部访问
  port: 18789 # Web 管理界面端口
auth:
  mode: "token" # 强制令牌认证
sandbox:
  use_docker: true # 启用 Docker 沙箱隔离
  docker_image: "openclaw/sandbox:latest"
messaging:
  channels:
    telegram:
      dmPolicy: "pairing" # 新用户需批准，不用"open"

四、安全加固：从'能用'到'安全'

OpenClaw 拥有系统级权限，安全是不可妥协的前提。

4.1 基础安全配置（10 分钟完成）

① macOS 防火墙与加密

# 开启防火墙
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --setglobalstate on
# 开启 FileVault 磁盘加密（系统设置 → 隐私与安全性）

② 运行安全审计

openclaw security audit --deep

定期运行此命令检查配置漏洞。

③ 监控出站连接 安装网络监控工具（如 LuLu，免费开源），观察 OpenClaw 的所有外连请求。正常运行时应仅连接你的 AI 提供商、配置的消息平台及已安装技能的目标 API。

4.2 高级隔离方案

方案 A：Docker 沙箱（推荐） 在 config.yaml 中启用 use_docker: true 后，所有 Bash 命令和文件写入操作将在隔离容器内执行。

方案 B：独立用户账户 我们已在第 2 步创建了 openclaw-agent 标准账户。切换至该账户运行 OpenClaw。

方案 C：外置存储隔离 将所有 AI 相关数据放在外置 SSD 上，与系统盘物理隔离。配置文件中指定：

WORKSPACE_PATH: "/Volumes/AIWorkspace/openclaw"

方案 D：虚拟机隔离（最高级别） 使用 UTM 创建 macOS 虚拟机，启用'Isolate Guest from Host'选项。

4.3 敏感文件黑名单

绝对禁止 OpenClaw 访问以下目录：

  • ~/.ssh/ —— SSH 密钥
  • ~/Library/Keychains/ —— 系统钥匙串
  • ~/.gnupg/ —— GPG 密钥
  • ~/.aws/ —— AWS 凭证
  • ~/Documents/ —— 个人文档（建议单独划分子集）

五、消息渠道配置与远程控制

5.1 Telegram 配置（最稳定）

Telegram 是 OpenClaw 官方推荐的控制渠道，推送可靠、跨平台。

① 创建 Telegram Bot

  1. 在 Telegram 中搜索 @BotFather
  2. 发送 /newbot，按提示设置名称和用户名
  3. 收到 API Token

② OpenClaw 中连接

openclaw channels login --channel telegram

终端会显示二维码和链接，用 Telegram 扫码即可。

③ 获取用户 ID 并限制 向你的 Bot 发送任意消息，然后访问 API 接口获取 from.id，填入 .env 的 ALLOWED_USER_IDS。

5.2 其他渠道

  • WhatsApp：需安装 WhatsApp Business，通过'Linked Devices'扫码
  • iMessage：仅 macOS 支持，可实现 Apple 生态整合
  • Web 界面：访问 http://localhost:18789，使用 openclaw onboard 生成的令牌登录

5.3 远程访问（VPN 方案）

禁止直接将 18789 端口暴露到公网。推荐使用 Tailscale 搭建零信任网络：

# 安装 Tailscale
brew install tailscale
sudo tailscale up
# 在 Tailscale 管理后台启用 MAC 地址认证
# 现在可通过 Tailscale 分配的 IP 远程访问

此方案无需开放公网端口，且自带设备认证。

六、生产级部署与运维

6.1 系统服务管理

OpenClaw 的 --install-daemon 已自动创建 LaunchAgent，确保开机自启、崩溃后自动重启。

手动管理命令：

# 查看服务状态
launchctl list | grep openclaw
# 手动启动/停止
launchctl start ~/Library/LaunchAgents/ai.openclaw.agent.plist
launchctl stop ~/Library/LaunchAgents/ai.openclaw.agent.plist

6.2 监控与告警

① 日志监控

# 实时查看日志
tail -f ~/.openclaw/logs/audit.log
# 检查错误
grep -i error ~/.openclaw/logs/*.log

② 系统资源监控 通过 Activity Monitor 监控 CPU/内存使用率、内外置 SSD 的磁盘活动、网络连接状态。

③ 定期维护清单

频率任务
每日快速浏览 audit.log，确认无异常指令
每周清理缓存目录，检查磁盘剩余空间
每月更新 OpenClaw：npm update -g openclaw
每月轮换 API 密钥（重新生成并更新.env）
每季测试备份恢复，验证数据完整性

6.3 性能优化

① 模型路由策略 如果同时使用云端 API 和本地模型，可配置路由策略：简单任务走本地小模型，复杂任务走云端。

② Heartbeat 机制 在生产环境中，不要每步都调用大模型。设置'心跳检查'逻辑，大幅降低 API 成本和延迟。

③ 并发控制 在 .env 中设置：

MAX_CONCURRENT_TASKS=3
TOOL_TIMEOUT_SECONDS=30

避免 AI 同时发起过多请求导致系统过载。

七、实战演练：一句话触发复杂任务

7.1 基础测试

配置完成后，在 Telegram 中发送：'你好，帮我看看桌面上有哪些文件？' OpenClaw 应能理解指令意图，调用 ls 命令列出桌面文件，并将结果整理成自然语言返回。

7.2 复杂任务测试

尝试一个真实自动化场景：'我下周要去上海出差 3 天。请帮我：1. 在日历上创建行程 2. 查询这三天的天气预报 3. 生成一个行李清单建议 4. 把所有内容整理成邮件草稿'。

如果配置得当，OpenClaw 会依次调用 Calendar API、执行 Web 搜索、基于常识生成清单、调用 Mail 应用生成草稿。

7.3 调试技巧

当任务失败时，检查：

# 查看详细日志
openclaw logs --level debug
# 测试工具调用
openclaw tool call --tool fs.list --args'{"path": "~/Desktop"}'

八、常见问题排查

Q1：OpenClaw 启动失败，提示'Port 18789 already in use'

# 查找占用进程
lsof -i :18789
# 终止该进程或修改 config.yaml 中的端口

Q2：Telegram Bot 无响应

  • 检查 .env 中的 TG_BOT_TOKEN 是否正确
  • 确认 ALLOWED_USER_IDS 包含你的用户 ID
  • 查看日志：grep telegram ~/.openclaw/logs/*

Q3：工具调用失败'Sandbox error'

  • 确认 Docker Desktop 已运行：docker ps
  • 检查 config.yaml 中 sandbox.use_docker 是否为 true
  • 尝试拉取沙箱镜像：docker pull openclaw/sandbox:latest

Q4：国内网络无法连接 API

# .env 中配置代理（需自行搭建）
HTTPS_PROXY=http://127.0.0.1:7890
HTTP_PROXY=http://127.0.0.1:7890

Q5：提示'Model context window too small'

参考官方文档，修改 ~/.openclaw/agents/main/agent/models.json 中的 maxContextLength 字段为 32768 或更大。

Q6：想重置所有配置

# 完全卸载
openclaw uninstall
# 删除配置目录（谨慎！）
rm -rf ~/.openclaw

九、进阶方向：从个人助理到企业级应用

9.1 本地模型集成

通过 Ollama 部署本地模型，在 OpenClaw 中配置实现完全本地化推理，零 API 费用。

9.2 技能插件开发

OpenClaw 支持自定义 Skills，用 TypeScript 编写后放入 ~/.openclaw/skills/ 即可。

9.3 云上部署选项

如果不愿自购硬件，部分云服务商提供 Mac Mini 云实例，按小时计费。可先在云端验证 PoC，再决定是否自建。

9.4 极简替代方案

对于仅需核心调度功能的场景，可关注 PicoClaw 和 ZeroClaw。它们能在树莓派等低功耗设备上运行，彻底摆脱对 Mac Mini 的依赖——但需注意，本地模型推理仍需 GPU 服务器。

目录

  1. 引言
  2. 一、为什么选择 Mac Mini + OpenClaw？
  3. 1.1 OpenClaw：本地 AI 智能体的核心价值
  4. 1.2 Mac Mini 的核心优势
  5. 1.3 硬件配置建议
  6. 二、环境准备与基础配置
  7. 2.1 系统设置优化
  8. 查看当前休眠设置
  9. 禁用休眠（7×24 运行必需）
  10. 仅关闭显示器
  11. 安装 Homebrew（包管理器）
  12. 安装 Node.js 22+（OpenClaw 核心依赖）
  13. 验证安装
  14. 安装 Git（可选，用于技能插件管理）
  15. 安装 Docker Desktop（强烈推荐用于沙箱隔离）
  16. 2.2 硬件扩展建议
  17. 三、OpenClaw 安装与核心配置
  18. 3.1 一键安装（推荐）
  19. 使用官方安装脚本（自动处理依赖）
  20. 3.2 替代方案：npm 安装
  21. 全局安装最新版
  22. 验证安装
  23. 3.3 运行配置向导
  24. 3.4 关键配置文件解析
  25. 编辑.env 文件
  26. API 密钥（根据实际使用的提供商填写）
  27. OPENAIAPIKEY=sk-xxxxxxxxxxxxx
  28. Telegram 配置（用于远程控制）
  29. 工作路径隔离
  30. 限制 AI 可操作目录
  31. 代理配置（国内用户必需）
  32. 编辑 config.yaml
  33. 四、安全加固：从“能用”到“安全”
  34. 4.1 基础安全配置（10 分钟完成）
  35. 开启防火墙
  36. 开启 FileVault 磁盘加密（系统设置 → 隐私与安全性）
  37. 4.2 高级隔离方案
  38. 4.3 敏感文件黑名单
  39. 五、消息渠道配置与远程控制
  40. 5.1 Telegram 配置（最稳定）
  41. 5.2 其他渠道
  42. 5.3 远程访问（VPN 方案）
  43. 安装 Tailscale
  44. 在 Tailscale 管理后台启用 MAC 地址认证
  45. 现在可通过 Tailscale 分配的 IP 远程访问
  46. 六、生产级部署与运维
  47. 6.1 系统服务管理
  48. 查看服务状态
  49. 手动启动/停止
  50. 6.2 监控与告警
  51. 实时查看日志
  52. 检查错误
  53. 6.3 性能优化
  54. 七、实战演练：一句话触发复杂任务
  55. 7.1 基础测试
  56. 7.2 复杂任务测试
  57. 7.3 调试技巧
  58. 查看详细日志
  59. 测试工具调用
  60. 八、常见问题排查
  61. Q1：OpenClaw 启动失败，提示“Port 18789 already in use”
  62. 查找占用进程
  63. 终止该进程或修改 config.yaml 中的端口
  64. Q2：Telegram Bot 无响应
  65. Q3：工具调用失败“Sandbox error”
  66. Q4：国内网络无法连接 API
  67. .env 中配置代理（需自行搭建）
  68. Q5：提示“Model context window too small”
  69. Q6：想重置所有配置
  70. 完全卸载
  71. 删除配置目录（谨慎！）
  72. 九、进阶方向：从个人助理到企业级应用
  73. 9.1 本地模型集成
  74. 9.2 技能插件开发
  75. 9.3 云上部署选项
  76. 9.4 极简替代方案

更多推荐文章

查看全部
  • Spring Boot 整合 DL4J 构建智能写作助手
  • OpenClaw：从程序员玩具到开源 AI 代理的演变
  • Flutter 三方库 groq_sdk 的鸿蒙化适配指南
  • 数据结构：单向链表的基本操作
OpenCode 开源 AI 编程助手完全使用指南
  • Linux 网络基础：局域网通信与跨网段传输详解
  • 前端独立产品设计全流程：掌握三大 AI 设计 Skill
  • OpenClaw 实战：WSL2 环境下使用 Python 调用摄像头
  • Java AI 代码最佳实践优化器实测
  • NewBie-image-Exp0.1 镜像上手：XML 提示词控制角色生成
  • 6 种 Python 脚本打包成可执行文件的主流方法
  • RAG 优化方案与实践详解
  • MicroPE 基于 NVMe 启动运行 GLM-4.6V-Flash-WEB 的本地 AI 部署实践
  • Spring Boot Web 后端开发核心注解
  • Qwen3-Embedding-4B 本地化部署实战：llama.cpp 与 vLLM 方案
  • Python For 循环详解与实战应用
  • 国内 AI 编程助手订阅套餐横评与选型指南
  • Python 二级考试真题及参考代码解析（简单应用题）
  • 滑动窗口算法专题：经典题目解析与实现
  • 计算机视觉基础与实战应用指南

    • 相关免费在线工具

    • 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