如何在 macOS 上安装 OpenClaw：Mac Mini 完整设置指南

OpenClaw 是一个强大的开源、自托管 AI 代理框架，可作为完全自主的个人助手运行。在您的本地硬件上 24/7 运行，它连接到 Telegram、WhatsApp、Slack 和 iMessage 等流行消息平台，执行 shell 命令、浏览网络、管理文件，并与 Anthropic 的 Claude 和 OpenAI 的 GPT 系列等行业领先的 AI 模型无缝集成。

对于那些希望获得最大性能和可靠性而不依赖云的用户，专用 Mac Mini——特别是 Apple Silicon M 系列型号（M1 至 M4）——是最佳平台之一。这些机器安静、节能、始终在线，并与 macOS 深度集成，非常适合运行持久的 AI 代理。本指南将逐步指导您在 AlexHost Mac Mini 服务器上设置自己的 OpenClaw 助手。

> ⚠️ 安全警告：OpenClaw 以广泛的系统级权限运行。它可以自主读取文件、执行终端命令、发送消息和浏览网络。如果您的主要个人机器上同步了敏感数据——如 iCloud 文件、密码或个人照片——请勿在其上安装。本指南中所述的专用、隔离设备（如 Mac Mini 服务器）是强烈推荐的方法。

前置条件：开始前您需要的内容

在开始安装之前，请确保您具有以下条件：

• 一台 AlexHost Mac Mini 服务器（推荐 Apple Silicon M 系列）
• 对您的 Mac Mini 的 SSH 或远程访问（请参阅 AlexHost 的连接指南）
• 来自 console.anthropic.com 的 Anthropic API 密钥（或者如果您更喜欢 GPT 模型，可以使用 OpenAI API 密钥）
• Telegram 账户（可选，用于消息频道集成）
• 对终端和命令行操作的基本熟悉

如果您正在寻找可靠的、始终在线的托管环境（超出 Mac Mini 范围），AlexHost 还提供高性能 VPS 托管和 专用服务器，可以全天候运行 AI 代理工作负载。

第 1 步：连接到您的 Mac Mini 服务器

首先建立与您的 AlexHost Mac Mini 的远程连接。按照 AlexHost 的官方 Mac Mini 连接指南通过 SSH 或远程桌面访问您的服务器。一旦您在机器上有一个有效的终端会话，您就可以继续进行。

第 2 步：安装所需的依赖项

2.1 安装 Homebrew

Homebrew 是 macOS 的事实上的包管理器，是安装 Node.js 和其他依赖项所必需的。在您的 Mac Mini 上打开终端并运行以下命令：

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

按照屏幕上的提示进行操作，并等待安装完成。

仅限 Apple Silicon 用户（M1/M2/M3/M4）：安装后，您必须将 Homebrew 添加到 shell 的 PATH。运行这两个命令：

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

这确保从任何新的终端会话都可以访问 Homebrew 安装的二进制文件。

2.2 安装 Node.js（需要版本 22 或更新版本）

OpenClaw 需要 Node.js v22 或更高版本。通过 Homebrew 安装它：

brew install node

验证已安装的版本：

node --version

您应该看到类似 v22.x.x 或更高版本的输出。如果显示较旧的版本，请立即升级：

brew upgrade node

在确认 Node.js v22 或更新版本之前，请勿继续——较旧的版本将导致 OpenClaw 安装程序失败。

第 3 步：安装 OpenClaw

3.1 运行官方安装程序脚本

安装 Node.js 后，使用其官方一行安装程序安装 OpenClaw：

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

此脚本会自动：

• 检测您的操作系统和架构
• 确认兼容版本的 Node.js 可用
• 在您的系统上全局安装 OpenClaw CLI
• 准备运行时环境

等待直到您看到确认消息：

Installation finished successfully!

3.2 验证安装

确认 OpenClaw CLI 已正确安装且可访问：

openclaw --version

应该向终端打印一个版本号。如果您收到”command not found”错误，请完全关闭您的终端窗口，重新打开它，然后再次尝试该命令。这会刷新 shell 的 PATH，通常可以解决问题。

第 4 步：入职和配置

此步骤将 OpenClaw 配置为使用 Anthropic 的 Claude 作为其 AI 后端，并设置后台服务守护程序。

4.1 运行入职向导

openclaw onboard --install-daemon

--install-daemon 标志很重要——它将 OpenClaw 注册为在每次系统启动时自动启动的后台服务，确保您的 AI 助手始终可用，无需手动干预。

交互式向导将指导您完成三个配置区域：

a) 身份验证 — API 密钥设置

当系统提示您输入 API 密钥时，从 console.anthropic.com 粘贴您的 Anthropic API 密钥。OpenClaw 将使用此密钥与 Claude 通信。

> 💡 计费说明：Anthropic 按令牌使用量收费。对于积极使用的个人助手，根据查询量和模型选择，预计每天成本在几美元范围内。

b) 网关设置 — 端口配置

除非您有特定原因使用不同的端口，否则接受默认网关设置。默认网关端口是 18989。这是 OpenClaw 的 Web UI 和消息集成通信的端口。

c) 频道设置 — 消息集成

在此阶段，您可以连接消息应用程序（在第 5 步中详细介绍）或跳过此步骤，改为使用基于网络的仪表板。如果您想先测试 Web UI，请选择“暂时跳过”。

4.2 验证网关正在运行

入职后，确认 OpenClaw 网关服务处于活动状态：

openclaw gateway status

输出应该确认网关正在运行。如果它没有运行，请手动启动它：

openclaw gateway --port 18789

4.3 打开 Web 仪表板

在您的浏览器中启动 OpenClaw 控制界面：

openclaw dashboard

这会在以下位置打开基于网络的仪表板：

http://127.0.0.1:18789/

如果仪表板成功加载，您的网关已完全运行。您可以立即开始直接从浏览器与 OpenClaw 聊天——此阶段不需要消息应用程序配置。

第 5 步：连接 Telegram 消息频道（可选）

将 OpenClaw 连接到 Telegram 允许您从世界上任何地方使用 Telegram 应用与您的 AI 助手交互。

5.1 通过 BotFather 创建 Telegram 机器人

1. 打开 Telegram 并搜索 @BotFather
2. 开始对话并发送命令：/newbot
3. 按照 BotFather 的提示进行操作——您将为您的机器人选择显示名称和用户名
4. BotFather 将生成并发送给您一个 机器人 API 令牌——立即复制此令牌并妥善保管

5.2 向 OpenClaw 注册机器人令牌

返回您的 Mac Mini 终端并运行：

openclaw onboard

当系统提示您选择消息频道时，选择 Telegram 并在询问时粘贴您的机器人 API 令牌。

5.3 开始聊天

打开 Telegram，按其用户名找到您新创建的机器人，并向其发送消息。OpenClaw 将通过 Telegram 界面响应，为您提供直接在应用中的完整 AI 助手功能。

常见问题故障排除

为什么在专用硬件上运行 OpenClaw？

在专用机器上运行 OpenClaw——而不是您的个人笔记本电脑或台式机——提供了显著的优势：

• 隔离：您的个人文件、密码和敏感数据对代理不可访问
• 始终在线可用性：助手 24/7 运行，不会中断您的主要工作流
• 性能：Apple Silicon M 系列芯片以低功耗高效处理 AI 工作负载
• 稳定性：专用服务器环境避免与个人软件和系统更新的冲突

对于需要更多计算能力来处理 AI 工作负载的团队或开发人员，AlexHost 的 GPU 托管解决方案提供为 AI 和机器学习任务专门构建的专用 GPU 资源。或者，如果您需要具有完全 root 访问权限的可扩展基于 Linux 的环境，请考虑 AlexHost 的 VPS 托管计划。

保护您的 OpenClaw 安装

由于 OpenClaw 具有广泛的系统权限，加强您的服务器环境至关重要：

• 使用强 SSH 密钥进行远程访问——禁用基于密码的 SSH 身份验证
• 保持 Node.js 和 Open