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

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

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

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

一、Mac Mini 本地部署详解

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

硬件选型推荐

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

二、安装Homebrew 

安装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”以开始使用

三、安装与配置OpenClaw

在浏览器打开 openclaw.ai，可以看到官网提供了多种安装方式。最推荐的是 One-liner 一键安装：

在终端中输入如下命令

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

官网承诺：自动安装 Node.js 和所有依赖，支持 macOS / Windows / Linux。

打开终端（Terminal），粘贴命令并回车。

安装程序会自动检测环境：

• ✅ Detected: macOS
• ✅ Homebrew already installed
• ✅ Node.js v22.22.0 found
• ✅ Git already installed

然后开始下载安装包…

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

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

安装完成后会自动运行 openclaw-onboard 引导程序。

⚠️ 重要：先阅读安全警告

OpenClaw 很强大，但也有风险。它会执行你给的命令，包括可能危险的指令。

选项：

• 输入 Yes 继续
• 按 Ctrl+C 中止

推荐选择 QuickStart 模式，后续再详细配置。

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）。

四、选择 AI 模型提供商

引导程序会让你选择 AI 模型，支持：

• OpenAI
• Anthropic (Claude)
• MiniMax (M2.5) ✅ 推荐
• Google
• Ollama
• 本地模型
• 等等…

回车继续后会让你填入miniMax的API Key，如果没有可以选择 Skip for now

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

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

注意

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

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

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

过去圈内人都喜欢闭眼选 Claude，但因为最近 Anthropic 搞起了极为严苛的风控（而且明确说明了不给openclaw使用），之前的配置经验已经彻底作废了。

现在的最优解，是直接选择 OpenAI。国内用户可以选择minimax2.5 这也是openclaw推荐的搭配

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

五、openclaw配置说明

OpenClaw配置。

知道风险吗？-》Yes。

QuickStart。

选择Model Provider：Z.AI->Coding-Plan-CN（方法类似）

跳过Channel配置(这步很重要，否则后面就会陷入先有鸡还是先有蛋的配置循环)

跳过Skill配置

Google那些全No

Hook全选

这样就完成了初步配置。

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

openclaw onboard --install-daemon

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

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

openclaw configure

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

~/.openclaw/openclaw.json

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

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

初始化配置

openclaw onboard --install-daemon

1. 确认安装方式

出现下面这句提示时：
I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
这里选择 YES，然后按回车，可以使用键盘方向键进行选择。

选择 YES

2. 选择安装模式：QuickStart

3. 选择 AI 模型提供商（OpenAI GPT / minimax/本地模型）

输入 API Key

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

OpenAI GPT: platform.openai.com

API 聚合服务：apiyi.com

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

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

实践任务 3：完成初始化

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

完成标准：

成功配置 API Key

4. 选择消息平台（Telegram / Discord / WhatsApp 等）

聊天渠道这里选择：Telegram然后选择：Enter Telegram bot token接着输入你的 Telegram Bot Token，如果没有的申请的同学可以通过下面的步骤

具体步骤如下

• 1、在 Telegram 中搜索 @BotFather（官方 Bot 创建工具）
• 2、发送命令：/newbot
• 3、按提示设置 bot 名称和用户名
  机器人显示名：用户看到的名字
  机器人用户名：用于搜索
  机器人用户名规则：只能使用 英文字母、数字、下划线，必须以 bot 结尾
  例如：my_xiaoc752_bot 或 Myxiaoc752Bot
• 4、获得 Bot Token（格式：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

5. 配置系统权限（建议先选择沙盒模式）

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

六、配置 Telegram 或 Discord

聊天渠道这里选择：Telegram
然后选择：Enter Telegram bot token
接着输入你前面保存好的 Telegram Bot Token

选择：Telegram

选择：Enter Telegram bot token

接着输入你前面保存好的 Telegram Bot Token

启用 Telegram 插件

如果之前跳过了这个配置，可以通过下面的方法设置

在终端中执行（插件默认是关闭的）：

openclaw plugins enable telegram

配置 Bot Token

在终端中执行：

openclaw config set channels.telegram.botToken "你的Bot_Token"

将 你的Bot_Token 替换为第一步获取的 Token。

启动 Gateway

openclaw gateway run

如果报错，可以先尝试停止：

openclaw gateway stop
openclaw gateway run

配对验证

在 Telegram 中找到你的 bot
发送任意消息
Bot 会返回一个验证码（6位数字）
在终端中执行：

openclaw pairing approve telegram 你的验证码

配对成功后，你就可以和 Bot 对话了！

第一次对话

启动 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 助手进行第一次对话，测试以下命令：

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

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

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

七、安装skill

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

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

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

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

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

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

Hooks 是自动化工具，可以帮你执行一些预设任务。

可以选择：

No - 跳过，后续再配置

Yes - 现在配置

我选了 No，先跑起来再说。

默认会启用 3 个有用的钩子：

🚀 boot-md - 启动时读取配置

📝 command-logger - 记录命令日志

💾 session-memory - 保持会话记忆

八、给 OpenClaw 开启完整权限+设置白名单

1.打开网页版控制台，如果之前没有打开，可以在 Ubuntu 中输入：

openclaw dashboard

2. 进入配置页面进入控制台后：选择 配置点击 All Settings在下方选择 Raw

点击红框标注的地方

3. 修改工具权限把原来的：

"tools": {
"profile": "messaging"
}

换为：

"tools": {
"profile": "full",
"exec": {
"host": "gateway",
"security": "full",
"ask": "off"
},
"web": {
"fetch": {
"enabled": true
}
}
},

替换后点Save保存

保存后即可生效。

点击Tools这边出现Full就是设置完成了

这表示把工具配置从仅消息模式改成完整模式，并把本机执行权限开到最高，同时关闭逐次确认。

4.给 Telegram 机器人设置白名单

为了防止别人随意使用你的机器人，建议开启白名单功能
开启后，只有被添加到白名单里的 Telegram 用户，才能给机器人发送指令并正常使用
设置方法打开 OpenClaw 控制台点击 频道找到 Allow From点击 Add添加你自己的 Telegram 用户 ID滑到最下方点Save 保存设置设置完成后，只有这个 Telegram ID 对应的账号可以使用该机器人。
注意：这里填写的是 Telegram 用户 ID（纯数字），不是用户名

给 Telegram 机器人设置白名单

九、理解核心概念

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 的文件结构和基本配置

十、额外配置

配置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内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

最新评论