脚本之家 服务器常用软件
快捷导航
您的位置：主页 > AI > openclaw > Macmini配置OpenClaw

苹果Macmini下OpenClaw保姆级配置教程(全网最简单)

  发布时间：2026-03-03 13:20:25   作者：佚名   我要评论
如果你也想把 Macmini 变成 24h 在线的 私人秘书，这篇就是保姆级喂饭教程，为什么选择mac mini来配置OpenClaw，因为OpenClaw是在unix开发的，而openclaw也是unix系统，所以搭配起来更方便

前期准备： 任何一家的大模型调用的 base url 和 key(附免费和低价方案) + 海外上网环境(否则很难安装与通讯) + UU远程(提供远程桌面)

在我写这篇文章的这个版本里，由于是全新机器，系统里还没有安装 Homebrew，安装脚本会先报错提示，并且提醒需要 sudo 权限来运行脚本。

我的做法是：先单独安装好 Homebrew，然后再执行上面的安装命令，而不是直接用 sudo 去跑 curl ... | bash。

一、Mac Mini 本地部署详解

Mac Mini 是运行 OpenClaw 的理想本地硬件方案——低功耗（20-40W）、高性能、零云端费用。

硬件选型推荐

方案硬件配置价格本地模型能力
预算方案Mac Mini M4 (24GB)约 800 美金运行 7B-13B 参数模型
推荐方案Mac Mini M4 Pro (64GB)约 2,000 美金运行 32B 参数模型，如 Qwen2.5-Coder-32B
旗舰方案Mac Studio M4 Max (128GB)约 3,500+ 美金运行 70B+ 参数模型

性能参考: GLM-4.7-Flash 在 24GB 系统上可达 15-20 tokens/秒；Qwen3-Coder-30B 在 32GB 模型上可达 10-15 tokens/秒。

二、安装依赖 OpenClaw 需要 Homebrew 和 Node.js 等工具。

安装OpenClaw

要想跑通本地 AI，你的系统得先有个强大的“后勤部长”。

在 Mac 系统里，这个部长叫 Homebrew。打开终端（Terminal），把这行咒语复制进去，一键回车：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

运行后如下图所示

安装好以后

在终端中输入以下命令，将Homebrew添加到你的PATH环境变量中：
执行命令：

eval "$(/opt/homebrew/bin/brew shellenv zsh)"

运行“brew help”以开始使用

安装 Node.js

这一步可以省略，安装openclaw都会自动安装

因为后续可以直接通过安装openclaw自动安装node.js，注意node.js版本>=22才可以

安装 Node.js 22+

环境配置好之后，咱们还得装个引擎组件 Node.js。继续在终端里敲：

brew install node@22 或者 brew install nodejs

验证 Node.js 版本

安装完成后，验证Node.js和NPM的版本：

node -v
npm -v

如果看到版本号，说明安装成功。

node --version # 应显示 v22.x.x 或更高

只要看到最新的数字版本号跳出来，恭喜你，地基打稳了。

升级NPM到最新版本

运行以下命令升级NPM：

npm install -g npm@latest

这一步其实可以省略，安装openclaw都会自动安装。

三、安装Claude Code

这一步暂时可以略过

这是我们最重要的一步，因为假如后面出现任何问题，我们都可以让 Claude Code 修复 OpenClaw

npm install -g @anthropic -ai/claude-code

然后直接导入 Claude Code 的环境变量

export ANTHROPIC_BASE_URL="你的提供商链接" export ANTHROPIC_AUTH_TOKEN="你的API密钥"

四、安装与配置OpenClaw

在终端中输入如下命令

curl -fsSL https://openclaw.ai/install.sh | bash

完成标准： 运行 openclaw --version 或 openclaw --help 能正常显示信息

安装脚本完成后，在终端继续运行：openclaw onboard

onboard 向导会做什么

openclaw onboard 会引导你完成：

  • Gateway 基本配置（端口、绑定方式、鉴权、daemon）
  • Workspace 初始化（默认在 ~/.openclaw/workspace，可改）
  • Model/Auth（API Key / OAuth / setup-token）
  • Channels（Telegram/Discord/WhatsApp/Google Chat/Signal/iMessage/…）
  • Skills（挑选/安装）

如果你不想一步到位：

跑向导时可以跳过某些步骤（例如 --skip-channels / --skip-skills）。

这里也是我们最重要的一步，有如下两个选择

1)假如你有下列模型的管订账号，直接选择跳转登录即可
2)假如你没有下列模型的官订账号，则进行如下配置： 我们跳过模型的秘钥选择(因为大部分人包括我都没有管订账号)，所以后面让Claude Code给我们自己配置第三方。

这时候，系统会让你选择底层的大模型。听好，这里有个天坑。

过去圈内人都喜欢闭眼选 Claude，但因为最近 Anthropic 搞起了极为严苛的风控（甚至给这个项目发了律师函），之前的配置经验已经彻底作废了。

现在的最优解，是直接选择 OpenAI。

强烈建议你在动手前，先搞定一个 ChatGPT Plus 会员。在终端界面选择 OpenAI 后，系统会自动跳转到浏览器，你只需要登录账号点个授权，这颗地表最强的大脑就正式接入了。

如下图，直接选择最后一步跳过。

后面的选择根据我们自己的需要，一步步配置即可。

openclaw配置说明

运行新手引导向导（并安装服务）

openclaw onboard --install-daemon

这条命令会启动配置向导，在命令行界面一步步提问。你可以通过键盘上下方向键选择，按回车确认，大部分场景跟着提示走就能完成初始配置。

如果第一次配置没选好，也不用紧张，后面可以随时重新配置，执行：

openclaw configure

如果这两种方式都改不了你想要的细节，那还有一招：手动修改配置文件：

~/.openclaw/openclaw.json

这种方式改完之后，需要重启 OpenClaw 的守护进程，配置才会真正生效。

接下来我挑选几个个人觉得比较关键的配置项展开说一下。

初始化配置

openclaw onboard

向导会引导你完成：

  • 选择 AI 模型提供商（OpenAI GPT / minimax/本地模型）
  • 输入 API Key
  • 选择消息平台（Telegram / Discord / WhatsApp 等）
  • 配置系统权限（建议先选择沙盒模式）

配置 API Key

如果你还没有 API Key，可以通过以下途径获取：

OpenAI GPT: platform.openai.com

API 聚合服务：apiyi.com

国内用户要求不是很高的话可以选择 minimax。

（支持多模型，新用户有免费额度）

实践任务 3：完成初始化

运行 openclaw onboard 并完成所有配置步骤。

完成标准：

成功配置 API Key

选择至少一个消息平台

完成权限设置（建议先选沙盒模式）

五、配置 Telegram 或 Discord

假如上一步我们没有选择模型，则直接将我们模型提供商的URL和Key给Claude Code，并发送下面的提示词：

“这是我的URL和Key，帮我配置OpenClaw”

openclaw会自动帮你配置好。

这里Telegram会简单一些，Discord则是比较麻烦。如果使用TG，大概配置需要花费3分钟，Discord则需要10分钟

这里我的选择是 Telegram，因为添加新龙虾很简便： 在搜索栏搜索

@BotFather

，然后点击开始对话，如下图所示 如果没有消息，则发送 /start ，开始对话。 然后进行下图的配置，直接抄作业即可 (第二步名称可以自定义，第三步必须是英文名，并且以_bot结尾)。

然后拿到如图所示的Token，直接发给Claude Code，附带如下提示词： “这是我的Telegram Bot 的 Token，帮我配置到 OpenClaw 中” 等待配置完成后，直接点击上图中下面返回的链接，就能够对话了。 到这里基本就配置完成可以对话了

第一次对话

启动 OpenClaw

# 启动 OpenClaw

# 或者启动 Dashboard（Web 界面）

openclaw dashboard

如果对话框中没有选择tg，可以如下设置配置tg到 OpenClaw:

openclaw config set channels.telegram.botToken "YOUR_BOT_TOKEN"
openclaw config set channels.telegram.enabled true

在 Telegram 中搜索你的机器人并开始对话

实践任务 4：第一次对话

与你的 OpenClaw 助手进行第一次对话，测试以下命令：

需要给他起个名字或让他自己选择一个名字

  • 你好，介绍一下你自己
  • 你能帮我做什么？
  • 现在几点了？

完成标准： 机器人能正常回复你的消息

六、理解核心概念

Gateway（网关）

Gateway 是 OpenClaw 与外部世界交互的方式：

  • 消息网关： Telegram、Discord、WhatsApp
  • API 网关： HTTP API 接口
  • CLI 网关： 命令行交互

Skills（技能）

Skills 是 OpenClaw 的能力扩展，类似于“插件”或“应用”：

  • 每个 Skill 定义了一组特定任务
  • 可以从 Clawhub 安装第三方 Skills
  • 也可以自己编写自定义 Skills

Memory（记忆）

OpenClaw 会记住：

  • 你的偏好和习惯
  • 之前的对话上下文
  • 重要的信息和任务

Sandbox（沙盒）

沙盒模式限制 OpenClaw 的系统访问权限，保护你的电脑安全：

  • Sandbox Mode: 限制文件系统、网络、Shell 访问
  • Full Access Mode: 完全权限（需谨慎使用）

实践任务 5：探索工作空间

# 查看 OpenClaw 的工作目录
ls ~/.openclaw
# 查看配置文件
openclaw config list
# 查看已安装的 Skills
openclaw skills list
# 运行安全审计
openclaw security audit

完成标准： 理解 OpenClaw 的文件结构和基本配置

七、注入灵魂，装配超级技能

光有脑子不行，咱们还得给它装上手脚。

在终端界面里，你会看到一堆花里胡哨的常用技能模块。记住这里的核心操作逻辑：上下键切换，空格键选中，回车键确认。

不知道怎么选的，直接抄我的满分作业：

选中 apple-notes（备忘录）、apple-reminders（日程管理）、github（代码库）、imsg（苹果信息）、model-usage（算力账单）、obsidian（神仙笔记软件）、summarize（长文总结）。

选完之后一路回车往下走。

最后到了 Enable hooks（启用钩子）这步，千万别手抖，一定要选上 command-logger 和 session-memory。这俩玩意儿能让你的 AI 拥有过目不忘的长期记忆，而不是聊两句就失忆的金鱼脑。

八、额外配置

配置1：网络代理 (假如上面配置完成后还不能对话)

这里还是使用你的外网软件，并且导入订阅链接后，打开TUN模式。 然后给Claude Code发送这段话： “帮我配置OpenClaw的环境，使其适配目前的网络代理” Claude Code 配置完成后，你的龙虾就能够正常使用了。

配置2：大模型

目前龙虾中最为强力的模型还是Claude(账号容易被关闭，现在推荐openai，国内用户使用minimax2.5更合适)的Sonnet和Opus，如果你是土豪，可以直接买中转站的原生Claude Max，但是大部分OpenClaw的用量其实一天有保底100美金。 所以这里推荐我的逆向半公益站和免费站AnyRouter，AnyRouter目前只能使用Linuxdo登录了，每天签到赠送25$，我的公益站提供逆向AWS的Claude Sonnet模型，便宜不稳定，15元100刀。 但是也有其他的选择，比如说GPT-5(来自Codex)、GLM-5、MiniMAX、Kimi等，效果会差一点

配置3：UU远程 下载UU远程，安装到Mac mini上，然后在我们经常用的电脑上也安装一个，如图所示

好处是：

1. 手机与电脑都能够操控Macmini远程桌面(不需要显示器了)

2. OpenClaw挂掉了，我们随时能够通过远程桌面的Claude Code来重启OpenClaw

看到这里了，相信大家都能顺利配置好OpenClaw。

常见问题及解决方案

Homebrew not found

苹果系统需要先安装Homebrew，在终端中输入如下命令即可：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

命令未找到（command not found）

  • 确保终端已重启或运行source ~/.zshrc（如果使用Zsh）。
  • 确保Homebrew和Node.js安装成功。

权限问题（EACCES错误）

运行以下命令修复权限：

sudo chown -R $USER /usr/local/lib/node_modules

镜像源失效

重置为官方源：

npm config set registry https://registry.npmjs.org

界面1008code问题

当然：4008、401的问题是不是很多人都遇到过；command not found 是不是也很多人都遇到过。

遇到4008、code1008解决办法：

# 生成新的 gateway token
openclaw doctor --generate-gateway-token
# 重启服务
systemctl --user restart openclaw-gateway
# 打开带 token 的 dashboard
openclaw dashboard

遇到401的解决办法

1、模型没有钱了，快去冲钱

2、minmax这个模型试了几个机器都不行，换个模型试试

命令不存在

windows建议安装顺序：

Powershell -> wsl ->nodejs ->openclaw

nodejs的win安装命令

apk update
apk add curl bash 
# 用 nvm 安装指定版本 
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash  
# 加载 
nvm source ~/.bashrc  
# 安装 Node.js 23 
nvm install 23

code 128的问题

解决办法

git config --global url."https://github.com/".insteadOf ssh://git@github.com/ git config --global url."https://github.com/".insteadOf git@github.com:

模型配置不成功的问题

去到用户目录，找到.openclaw/openclaw.json，配置你的模型

或者

openclaw config

 到此这篇关于苹果Macmini下OpenClaw保姆级配置教程(全网最简单)的文章就介绍到这了,更多相关Macmini配置OpenClaw内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

相关文章

最新评论

关注微信公众号

扫一扫