如何在 Mac 上安装 OpenClaw

OpenClaw 在 Mac 上有多种安装方式，具体取决于你偏好的使用和管理方式。在本指南中，你将找到不同安装方法的分步说明，以及帮助你顺畆运行 OpenClaw 的一些提示。

快速概览：在 Mac 上安装 OpenClaw 的三种方式

以下是这三种方法的并列对比。每种方式所需的手动设置程度各不相同。

使用 Kimi Claw，你可以在云端运行 OpenClaw，无需设置 Node.js、Homebrew 或 API key。几分钟内就能在浏览器中开始使用一个可正常工作的智能体。

如果你更倾向于本地部署，请继续阅读下一节。如果你想要更简单的方式，可以跳转到使用 Kimi Claw 在 Mac 上运行 OpenClaw一节，或点击下方按钮立即开始。

开始之前：必要的准备工作与安全事项

在 Mac 上本地安装 OpenClaw 之前，需要完成一些准备和安全方面的步骤。如果你打算使用 Kimi Claw，可以跳过本节，直接查看下方的设置说明。

• 依赖项：如有需要，一行命令安装脚本会自动安装 Node.js。如果你选择使用 Homebrew，则需要手动安装 Node.js（推荐 Node 24；Node 22 LTS 22.16+ 同样可用）。

• 防火墙与网络设置： macOS 防火墙默认通常是关闭的。你可以在系统设置 > 网络 > 防火墙中启用它。OpenClaw 会将网关绑定到 127.0.0.1（本机地址），因此网络中的其他设备无法直接连接到它。如果你需要移动端或远程访问，可以使用 Tailscale 或 SSH 隧道等工具。请不要通过路由器转发端口 18789。

使用一行命令脚本在 Mac 上安装 OpenClaw

这是在 Mac 上本地运行 OpenClaw 最快的方式。OpenClaw 通过终端运行，并提供基于浏览器的界面来管理你的智能体，而不是传统的图形界面应用。一条命令即可完成 CLI 安装、检查 Node.js 版本，并启动引导向导。

步骤 1：在终端中运行安装脚本

使用 Spotlight（⌘ + Space）打开终端，然后粘贴以下命令：

脚本会检测你的系统、安装 OpenClaw CLI，并检查你的 Node.js 版本。如果 Node.js 缺失或版本过旧，脚本会自动安装 Node 24（同样支持 Node 22 LTS 22.16+）。

步骤 2：设置 API key 并配置网关

安装完成后，引导向导会自动启动。选择 Moonshot AI（Kimi K2.5）作为你的大模型提供方，并在提示时粘贴你的 Kimi API key。网关端口和身份验证可以保持默认设置。如果你希望 OpenClaw 在 Mac 启动时自动运行，可以在引导过程中选择安装守护进程的选项。

步骤 3：验证网关并打开控制面板

运行以下命令以检查网关是否正在运行：

然后打开控制面板：

该命令会在浏览器中打开控制界面，地址为 http://127.0.0.1:18789。输入你的网关令牌以登录。登录后，你就可以开始与你的 OpenClaw 智能体互动了。

在 Mac 上使用 Homebrew 安装 OpenClaw

如果你习惯用 Homebrew 管理软件包，也可以用更手动的方式在 Mac 上安装 OpenClaw。这种方式能让你更好地控制依赖项，并融入你已有的 Homebrew 工作流。

步骤 1：安装 Homebrew

通过 Spotlight（⌘ + Space）打开终端。如果你还没有安装 Homebrew，请运行以下命令。Homebrew 是 macOS 上的一个软件包管理工具，可以让你在终端中安装和管理开发者工具，类似于应用商店安装应用的方式。

安装过程中，你可能会被要求输入 Mac 登录密码。注意，出于安全考虑，终端在你输入密码时不会显示任何字符。你还可能看到需要确认安装的提示，以及正在安装文件的相关信息。

安装完成后，你会在终端中看到成功提示以及后续操作步骤。

步骤 2：安装 Node.js

安装好 Homebrew 后，安装 Node.js：

安装完成后，确认版本号为 v24（推荐）或 v22.16 以上。

步骤 3：安装 OpenClaw CLI 并运行引导流程

使用 npm 全局安装 CLI，然后运行引导流程：

如果在执行 npm install -g 时出现 EACCES 权限错误，说明你的 npm 全局目录需要提升权限。你可以执行 sudo npm install -g openclaw@latest，也可以修改 npm 默认目录，以后就不必再使用 sudo。

--install-daemon 参数会将 OpenClaw 注册为 LaunchAgent，这样在你登录时网关会自动启动。在引导过程中，请选择 Moonshot AI（Kimi K2.5）作为提供方，并输入你的 Kimi API 密钥。

步骤 4：检查网关并打开控制面板

确认网关正在运行，并打开控制面板：

控制面板会在浏览器中打开。输入你的网关令牌即可开始使用。

使用 Kimi Claw 在 Mac 上运行 OpenClaw

Kimi Claw 是一款在线工具，让你无需本地配置即可在云端运行 OpenClaw。你的 Mac 上无需安装任何东西，也不需要使用终端或管理依赖项，一切都在浏览器中完成。你可以在几分钟内创建一个 OpenClaw 智能体。Kimi Claw 会负责网关、工作空间、存储和模型访问，让你的智能体全天候在线，即使合上 MacBook 也不受影响。

如何使用 Kimi Claw？

步骤 1：打开 Kimi Claw

进入 Kimi Claw 页面，点击 创建 开始部署你的 OpenClaw 环境。

步骤 2：自动部署 OpenClaw

在弹出窗口中确认部署。随后 Kimi Claw 会为你搭建好 OpenClaw 环境，包括网关、工作空间和工具。这个过程通常在几分钟内完成。

步骤 3：开始使用 OpenClaw

部署完成后，你的工作空间会在控制面板中打开。你可以直接在浏览器中与智能体对话、设置技能、安排任务并管理文件。

Kimi Claw 与本地运行 OpenClaw 的区别

Kimi Claw 提供了一种更简单的方式来运行 OpenClaw，无需本地配置。你不必安装依赖项或维护本地环境，而是可以直接在浏览器中运行智能体，底层的搭建和基础设施都由 Kimi Claw 负责处理。

• 无需本地配置： 运行 OpenClaw 无需安装 Node.js 或使用终端。一切都可以直接在浏览器中完成，让你更快上手，避免环境配置问题。

• 即时使用 5,000+ 技能：无需手动安装工具，Kimi Claw 可以从庞大的工具库中自动为你的任务调用所需技能，从而减少配置时间和兼容性问题。

• 全天候自动化与任务调度：本地智能体会在 Mac 休眠时停止运行，而 Kimi Claw 在云端全天候运行，适合用于定时任务和长时间运行的工作流。

• 40GB 云端存储与持久记忆：本地环境中的文件通常绑定在单一设备上，而 Kimi Claw 提供 40GB 存储空间，让你的报告和研究成果可以在任意浏览器中访问。它还会跨会话记住你的偏好和工作背景，方便你随时接续之前的工作。

• 内置 Kimi K2.5 模型与专业级搜索： Kimi Claw 内置了 Kimi K2.5 及高级搜索能力，无需自行管理 API 密钥或搭建外部服务。它可以自动获取金融、科技、新闻等领域的最新信息，让调研和任务执行更加顺畅。

让 OpenClaw 在 Mac 上 7×24 小时运行

大多数用户把 AI 当作传统的桌面应用来使用：坐在电脑前用它，用完就关掉。但对于一些有价值的自动化场景，比如整夜监控全球市场，或是每天早上 8 点前把研究报告准备好放进邮箱，你的 agent 需要全天候保持运行。由于 macOS 在系统休眠时会自动暂停本地进程，要实现这一点需要一些特定的方法。本节将介绍两种保持持续连接的方式：

方案 A：专用 Mac 硬件

一种方式是让一台 Mac（比如 Mac mini）一直保持运行。你可以使用 sudo pmset -a sleep 0 关闭休眠，并在“系统设置”中开启“唤醒以进行网络访问”。如需远程访问，可以使用 Tailscale 或 SSH 隧道等工具。

这种方式可以让 OpenClaw 在你自己的硬件上运行，但需要让设备持续开机，并自行处理维护、更新和重启等事宜。

方案 B：由 Kimi Claw 自动处理

如果你使用 Kimi Claw 运行 agent，7×24 小时运行是内置能力。你的 agent 独立于本地设备运行，即使 Mac 关闭或离线，它也会继续工作。无需调整休眠设置，也不必让设备一直开机。

修复 Mac 上 OpenClaw 的常见安装错误

即使配置简单，安装过程中也可能遇到一些问题。以下是一些常见问题及其解决方法。

OpenClaw command not found 错误

• 原因： npm 全局 bin 目录不在 shell 的 PATH 中。

• 解决方法： 运行 source ~/.zshrc 重新加载 shell 配置。如果你使用的是 Bash 而不是 Zsh，请把 ~/.zshrc 替换为 ~/.bash_profile。如果问题仍未解决，找到你的 npm prefix 并将其添加到 PATH 中：

重启后 OpenClaw 无法启动

• 原因： 在引导设置过程中未安装 LaunchAgent。

• 解决方法： 使用 daemon 参数重新运行引导设置命令：

这会注册一个 LaunchAgent，使 OpenClaw 网关在你登录时自动启动。要验证它是否处于活动状态：

端口 18789 已被占用

• 原因： 另一个进程正在占用网关端口。

• 解决方法： 找到并停止发生冲突的进程：

安装技能时出现 Xcode Command Line Tools 错误

• 原因： 某些 npm 包需要进行原生编译，而 Xcode Command Line Tools 缺失或版本过旧。

• 解决方法： 安装或更新相关工具：

安装完成后，重新尝试安装该技能。

Node.js 版本过旧

• 原因： 你的 Mac 上安装的 Node.js 版本低于 22.16。OpenClaw 需要 Node 24（推荐）或 Node 22 LTS 22.16 及以上版本。

• 解决方法： 如果你使用的是 Homebrew：

如果你使用的是一行式安装脚本，请重新运行它。脚本会检测到过旧的版本并进行更新。

结语

OpenClaw 可以通过一行式安装脚本或 Homebrew 在你的 Mac 上本地运行，也可以通过 Kimi Claw 在浏览器中运行，无需本地配置。这两种方式最终都能得到一个可用的 agent，但所需的手动操作程度不同。如果你想要更快的配置方式，并且内置 7×24 小时运行能力，可以从 Kimi Claw 开始，几分钟内即可让你的 agent 运行起来。