在 Mac mini 上部署 OpenClaw（原 Clawdbot/Moltbot）非常简单，推荐用官方一键脚本，全程约 5–15 分钟即可完成。下面是完整步骤与常见问题处理。

一、系统与硬件要求

  • macOS 版本：macOS 12+（推荐 Ventura/Sonoma）open-claw.me

  • 内存：16GB+ 最佳，8GB 可跑但复杂任务易卡顿

  • Node.js：v22.0.0+（一键脚本会自动安装）

  • 磁盘：预留 20GB+ 空间

  • 网络：可访问大模型 API（OpenAI、Claude、MiniMax、GLM 等）

二、一键部署（推荐）

1. 打开终端

启动台 → 其他 → 终端

2. 执行官方安装脚本

bash

运行

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

  • 测试版（含新功能，可能有 Bug）：

bash

运行

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

3. 初始化配置（Onboarding）

安装完成后，终端会自动进入配置向导：

  1. 同意风险提示：输入 yes 并回车

  2. 选择模式：QuickStart（快速入门）

  3. 模型配置：

    • 国际模型：直接输入 API Key（OpenAI、Claude 等）

    • 国产模型（MiniMax、GLM、Kimi）：先跳过，后续在 Web UI 改 Base URL

  4. 通信渠道：初次使用可 Skip for now（跳过），先在 Web UI 体验

  5. 后台服务：选择安装 launchd 守护进程，实现开机自启

4. 访问管理界面

安装成功后，终端会显示：

plaintext

✅ OpenClaw 部署成功！
管理界面：http://localhost:18789
默认账号：admin
默认密码：查看安装日志 / 终端提示

在浏览器打开 http://localhost:18789，登录即可使用。

三、手动安装（进阶）

1. 安装 Homebrew（如未装）

bash

运行

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

2. 安装 Node.js 22+

bash

运行

brew install node@22
node -v  # 确认版本 ≥22.0.0

3. 全局安装 OpenClaw

bash

运行

npm install -g openclaw@latest

4. 初始化并安装后台服务

bash

运行

openclaw onboard --install-daemon

四、国产模型配置（国内用户必做）

OpenClaw 默认模型地址为国际版，国内需手动修改 Base URL：

  1. 登录 Web UI → 左侧 Config → Settings → Models

  2. 找到对应模型（如 MiniMax）→ 切换到 Inference 标签页

  3. 修改 Base URL：

    • MiniMax：https://api.minimaxi.com/v2

    • GLM-4：https://open.bigmodel.cn/api/paas/v4/

    • Kimi：https://api.moonshot.cn/v1

  4. 填入你的 API Key，保存并重启服务

五、常用命令与管理

1. 启动 / 停止 / 重启

bash

运行

openclaw gateway start  # 启动
openclaw gateway stop   # 停止
openclaw gateway restart# 重启
openclaw status         # 查看状态

2. 查看日志

bash

运行

openclaw logs -f

3. 开机自启（已在 Onboarding 时配置）

  • 守护进程文件：~/Library/LaunchAgents/ai.openclaw.gateway.plist

  • 手动加载 / 卸载：

bash

运行

launchctl load ~/Library/LaunchAgents/ai.openclaw.gateway.plist
launchctl unload ~/Library/LaunchAgents/ai.openclaw.gateway.plist

六、常见问题

1. openclaw: command not found

原因：环境变量未加载

解决：

bash

运行

# 临时生效
export PATH="$HOME/.openclaw/bin:$PATH"
# 永久生效（zsh）
echo 'export PATH="$HOME/.openclaw/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# bash 用户
echo 'export PATH="$HOME/.openclaw/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile

2. 安装卡住 / 依赖失败

  • 确保网络稳定，关闭代理或切换网络

  • 重试安装脚本

  • 手动安装依赖：brew install vips pkg-config

3. Web UI 无法访问

  • 检查服务是否启动：openclaw status

  • 确认端口 18789 未被占用

  • 关闭防火墙或放行 18789 端口

七、Mac mini 性能建议

  • M1/M2/M4 芯片：最适合，低功耗、安静、24 小时稳定运行

  • 内存：24GB 可流畅跑 7B–13B 模型；64GB 可跑 32B 模型

  • 存储：建议用 SSD，预留 50GB+ 空间

八、下一步

部署完成后，你可以：

  1. 在 Web UI 配置 飞书 / 钉钉 / 企业微信 机器人，实现消息交互

  2. 安装 浏览器自动化、文件处理、代码生成 等技能

  3. 接入本地模型（Ollama）实现完全离线运行