OpenClaw · Mac Mini 完全指南

彻底卸载 OpenClaw

最简单的方式（CLI 还能用时）

如果你在终端里还能执行 openclaw 命令，一条命令搞定：

openclaw uninstall --all --yes --non-interactive

手动彻底清理（CLI 已经没了）

如果你已经先跑了 npm uninstall -g openclaw，CLI 没了但残留还在，按以下步骤逐步清理：

1. 停止并移除后台服务

   OpenClaw 会注册 macOS LaunchAgent 开机自启。历史版本有多种名称，全部删掉：

   # 停止服务
   launchctl bootout gui/$UID/ai.openclaw.gateway 2>/dev/null
   
   # 删除所有版本的 plist（含旧名称）
   rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
   rm -f ~/Library/LaunchAgents/com.openclaw.gateway.plist
   rm -f ~/Library/LaunchAgents/com.clawdbot.gateway.plist
   rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist

2. 删除所有数据和配置

   OpenClaw 曾多次更名（ClawdBot → MoltBot → OpenClaw），每个版本都可能留下目录：

   rm -rf ~/.openclaw
   rm -rf ~/.clawdbot
   rm -rf ~/.moltbot
   rm -rf ~/.molthub

3. 卸载 npm 全局包

   npm rm -g openclaw

4. 删除桌面 App（如果装了的话）

   rm -rf /Applications/OpenClaw.app

5. 清理环境变量

   # 检查是否有残留
   grep OPENCLAW_CONFIG_PATH ~/.zshrc ~/.bash_profile 2>/dev/null

   如果有输出，编辑对应文件，删除那行 export OPENCLAW_CONFIG_PATH=...，然后 source ~/.zshrc。

6. 验证卸载干净

   which openclaw                      # → "not found" ✓
   ls ~/.openclaw 2>&1                  # → "No such file" ✓
   launchctl list | grep -i claw       # → 无输出 ✓

前置环境：安装 Homebrew + Node.js

对，安装 OpenClaw 之前必须先装好这两样东西。简单说：Homebrew 是 Mac 的软件包管理器（类似手机上的应用商店），Node.js 是 OpenClaw 运行所需的底层引擎。

第一步：安装 Homebrew

打开终端（Spotlight 搜索 "Terminal" 或在启动台 → 其他 → 终端），粘贴这条命令后回车：

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

安装完成后，终端底部会提示你运行两条命令把 Homebrew 加入系统路径。请务必复制执行（Apple Silicon Mac 通常是这样）：

echo >> ~/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

验证：

brew --version    # 看到版本号就说明成功了

第二步：安装 Node.js

brew install node@22

如果终端提示 node@22 is keg-only，需要手动加入 PATH：

echo 'export PATH="/opt/homebrew/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

验证：

node -v    # → v22.x.x ✓
npm -v     # → 10.x.x 或更高 ✓

安装 OpenClaw

方式 A：官方一键脚本（推荐新手）

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

脚本执行完会自动进入交互式向导，依次引导你完成：

方式 B：npm 手动安装

npm install -g openclaw@latest

然后手动运行设置向导：

openclaw onboard

启动 Gateway

openclaw gateway

首次启动后会自动注册为 macOS LaunchAgent，以后开机会自动运行。

打开浏览器管理面板

openclaw dashboard

终端会输出一个带 token 的网址，在浏览器中打开即可。

配对 WhatsApp

原理很简单：和你用电脑打开 WhatsApp Web 一样——扫个二维码，把 OpenClaw 作为你 WhatsApp 的一个「关联设备」。

1. 在终端生成 QR 码

   openclaw channels login --channel whatsapp

   终端会显示一个 QR 码，准备好手机。

2. 在手机上扫码

   打开 WhatsApp → 设置 → 关联设备 → 关联新设备 → 对准终端的 QR 码扫描。

   成功后终端会显示 device linked / session saved。

3. 设置谁能给 AI 发消息

   编辑配置文件 ~/.openclaw/openclaw.json：

   {
     "channels": {
       "whatsapp": {
         "dmPolicy": "pairing",
         "allowFrom": ["+86138xxxxxxxx"]
       }
     }
   }

4. 审批首次配对请求

   当有人首次给你的 AI 发消息时，OpenClaw 会生成配对码，你需要在终端里审批：

   openclaw pairing list whatsapp
   openclaw pairing approve whatsapp <配对码>

   注意

   配对请求 1 小时后过期，最多同时 3 个待审批。

配对码找不到？四种常见原因

发消息没反应？逐项排查

WhatsApp 配对成功了，但发消息 AI 没反应——这是最常见的问题。按下面的顺序一项项检查：

• Gateway 是否在运行？
  运行 openclaw gateway status。没在运行就 openclaw gateway start。
  这是最最最常见的原因——WhatsApp 关联了但 Gateway 没跑起来，消息根本不会被处理。
• 联系人是否已批准？
  如果 dmPolicy 是 pairing（默认值），新联系人的消息需要你先 approve：
  openclaw pairing list whatsapp → openclaw pairing approve whatsapp <CODE>
  或者直接把号码加入 allowFrom 列表。
• 工具配置是否正确？
  OpenClaw 可能处于 messaging 模式（只发消息不执行工具）。检查配置里的 "tools": {"profile": "full"}，改完重启 Gateway。
• WhatsApp 会话是否断开了？
  查日志 openclaw logs --tail 50。如果看到 ENOTFOUND web.whatsapp.com 之类的错误，说明连接断了，需要重新 openclaw channels login --channel whatsapp。
• 是否用同一个系统用户？
  如果用不同用户做 login 和跑 Gateway，凭证会找不到。始终用同一个用户操作。
• 是 Node 还是 Bun 在跑？
  WhatsApp 渠道在 Bun 下不稳定（官方明确说明了）。确认用 node -v 检查是 Node.js 22+。

常用命令速查表