macOS、Linux 和 Windows 的 OpenClaw 安装指南

OpenClaw 是一款本地工具，能让你的 AI 智能体连接到 Telegram、WhatsApp 等应用并执行操作，例如发送消息或处理任务。一旦理解了流程，设置起来就很简单。本指南涵盖了在 macOS、Linux 和 Windows 上的安装方法。

OpenClaw 安装方式速览

根据自己的需求选择安装方式。在本地运行 OpenClaw 可以将所有内容保留在自己的设备上，但需要安装 npm 等依赖，或使用自动化脚本。如果你想跳过环境配置，像 Kimi Claw 这样的全托管平台会帮你处理好环境，让你可以直接开始使用。

如何在 macOS 和 Linux 上安装 OpenClaw

macOS 和 Linux 使用相同的安装程序和命令。除特别说明外，以下操作步骤对两个系统均适用。

以下是快速安装指南。如需带截图的完整分步教程，请参阅如何在 macOS 上安装 OpenClaw。

方法一：使用一键安装脚本

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

运行官方安装脚本来设置 OpenClaw。该脚本会检查是否已安装 Node.js 22 或更高版本。如果未安装或版本过旧，将自动安装 Node.js 24。随后它会安装 OpenClaw CLI 并启动引导向导。

第 2 步：完成引导向导

按照引导向导设置你的智能体环境，包括选择模型提供商（例如 Kimi API）、输入 API 密钥、选择渠道以及配置基本设置。

第 3 步：检查安装情况

运行以下命令以确认你的 OpenClaw 版本。

第 4 步：验证网关并完成设置

运行以下命令，检查 OpenClaw 网关是否已启动。

安装程序还会在 macOS 上注册一个 LaunchAgent，或在 Linux 上注册一个 systemd 服务，让 OpenClaw 持续在后台运行。设置完成后，你的智能体就可以使用了。你可以开始对话、连接工具，或根据需要配置工作流。

方法 2：使用 Homebrew 安装

第 1 步：安装或升级 Node.js

在终端中运行以下命令，使用 Homebrew 安装 Node.js。如果已安装 Node.js，请改用升级命令，以确保使用的是最新版本。

第 2 步：安装 OpenClaw CLI

运行以下命令，全局安装 OpenClaw CLI。

第 3 步：运行引导设置并配置守护进程

运行以下命令，启动引导向导并注册后台守护进程。按照向导配置你的智能体环境，包括选择模型提供方（例如 Kimi API）、输入 API key，以及连接消息渠道。设置完成后，你的智能体就可以使用了。你可以开始对话、连接工具，或根据需要配置工作流。

方法 3：使用 npm 安装

第 1 步：检查运行环境版本

运行以下命令，确认系统上已安装 Node.js 22.14 或更高版本。如果版本已是最新，即可继续安装。

第 2 步：安装 OpenClaw CLI

运行以下命令，全局安装 OpenClaw CLI。

第 3 步：运行引导设置并启用持久化

运行以下命令，启动引导向导并注册后台守护进程。按照向导配置你的智能体环境，包括选择模型提供方（例如 Kimi API）、输入 API key，以及选择消息渠道。设置完成后，你的智能体就可以使用了。你可以开始与它交互、连接工具，或根据需要构建工作流。

平台说明： OpenClaw 同时支持 Intel 和 Apple Silicon Mac。如果安装被 Gatekeeper 拦截，可以在系统设置的“隐私与安全性”中允许安装。

如何在 Windows 上安装 OpenClaw

在 Windows 上安装 OpenClaw 主要有三种方式：使用 PowerShell 安装程序快速原生安装，使用 WSL2 获得完整的 Linux 环境，或使用 npm 手动安装。

以下是快速安装指南。如需带截图的完整分步教程，请参阅如何在 Windows 上安装 OpenClaw。

方法 1：使用 PowerShell 安装程序（Windows 原生）

第 1 步：在 PowerShell 中运行安装脚本

以管理员身份打开 PowerShell，运行官方的一行式脚本来安装 OpenClaw。

第 2 步：完成引导向导

按照引导步骤配置你的智能体环境，包括选择模型提供方（例如 Kimi API）、输入 API key，以及选择消息渠道。

第 3 步：验证安装

运行以下命令，确认 OpenClaw 已正确安装且网关处于活动状态。

第 4 步：开始使用你的智能体

设置完成后，你的智能体就可以使用了。你可以开始与它交互、连接工具，或根据需要配置工作流。

方法 2：使用 WSL2 安装

第 1 步：设置 Linux 环境

以管理员身份打开 PowerShell，运行以下命令启用并初始化 WSL2。

第 2 步：在 Linux 中运行安装程序

打开 Linux 终端，运行标准安装脚本来安装 OpenClaw。

第 3 步：完成引导向导

按照引导步骤配置你的智能体环境，包括选择模型提供方（例如 Kimi API）、输入 API key，以及选择消息渠道。

设置完成后，你的智能体就准备好了。你可以开始与它交互，连接工具，或根据需求配置工作流。

方法 3：在 Windows 上通过 npm 安装

第 1 步：检查 Node.js 版本

运行以下命令，确认 Node.js 已安装且版本是最新的。

第 2 步：安装 OpenClaw CLI

运行以下命令，全局安装 OpenClaw CLI。

第 3 步：运行引导设置并启用持久化

运行以下命令，启动引导设置向导并注册后台守护进程。

按照引导步骤配置你的智能体环境，包括选择模型提供方（例如 Kimi API）、输入 API key，以及选择消息渠道。

设置完成后，你的智能体就准备好了。你可以开始与它交互，连接工具，或根据需求配置工作流。

如何使用 Kimi Claw 在线运行 OpenClaw

上述方法需要终端、受支持的 Node.js 版本，以及一台保持开机的机器。Kimi Claw 提供完全托管的方案，让你无需安装或维护本地环境即可运行 OpenClaw。

第 1 步：打开 Kimi Claw 并创建实例

前往 Kimi Claw 页面，点击创建开始。

第 2 步：确认部署

在弹出窗口中确认部署。Kimi Claw 会自动搭建好你的 OpenClaw 环境，包括网关和工作区，无需任何本地配置。

第 3 步：开始使用你的工作区

部署完成后，你的工作区会在仪表盘中打开。你可以直接在浏览器中与智能体交互、设置技能、配置定时任务并管理文件。

Kimi Claw 的主要特性

• 云端托管： Kimi Claw 在云端运行你的网关，即使本地机器离线，你的智能体也能保持可用。

• 自动维护： 更新和补丁在后台自动处理，无需手动设置或重启。

• 内置能力： 包含任务调度、持久化存储，以及基于提示词的动态技能加载，并支持跨设备无缝访问。

排查常见的 OpenClaw 安装错误

大多数 OpenClaw 安装问题都属于几种常见类别，比如 PATH 配置、依赖缺失或端口冲突。以下内容可帮助你在 macOS、Windows 和 Linux 上快速识别并解决最常见的问题。

安装后出现 “openclaw: command not found”

OpenClaw 不在你系统的 PATH 中。

• 解决方法： 将 npm 的全局 bin 目录添加到 PATH 中。

然后重新加载你的 shell（例如运行 source ~/.zshrc）或重启终端。在 Windows 上，将该路径添加到环境变量中并重启 PowerShell。

macOS 上出现 Sharp 构建错误

这通常是因为全局安装的 libvips 与 Sharp 库发生冲突。

• 解决方法： 在运行安装命令时加上此环境变量。

如果出现 node-gyp 错误，请安装 Xcode Command Line Tools：

重启后 OpenClaw 无法启动

在引导设置过程中未安装后台守护进程。

• 解决方法： 加上守护进程标志重新运行引导设置。

然后验证该服务：

网关无响应或显示“0 tokens used”

网关进程可能已停止，或 API 身份验证失败。

• 解决方法： 重启网关。

运行健康检查：

查看调试日志：

同时请确认你的 API 密钥有效。

18789 端口已被占用

另一个进程正在占用 OpenClaw 网关端口。

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

然后重启网关：

EACCES 权限错误

这通常表示 npm 全局目录的权限设置不正确。

• 解决方法： 更新目录所有权。

在 Windows 上，以管理员身份运行 PowerShell，或设置自定义的 npm prefix：

对于 Docker 环境，修复卷权限：

“spawn git ENOENT” 错误

Git 未安装，或未添加到 PATH 中。

• 解决方法： 从 git-scm.com 安装 Git，重启终端后重新安装。

WSL2 中 systemd 无法工作

WSL 配置中未启用 systemd。

• 解决方法： 编辑 /etc/wsl.conf，添加以下内容。

然后重启 WSL：

重新打开 Linux 终端并验证：

在 VPS 上执行 npm install 时内存不足

低内存的 VPS 实例在安装包时可能会失败。

• 解决方法： 创建一个交换文件（swap file）。

然后重新运行安装。

连接消息平台时出现“Access not configured”

你的账户尚未通过 OpenClaw 授权。

• 解决方法： 使用配对码批准你的账户。

同时请确认你的机器人凭据（令牌、Webhook、权限）配置正确。

结语

在 macOS、Linux 和 Windows 上安装 OpenClaw 都很简单。你可以根据自己的环境选择一键脚本、PowerShell、WSL2 或 npm 进行安装。引导向导会带你完成模型选择、API 配置和消息渠道设置。如果你不想管理本地环境，Kimi Claw 也提供完全托管的方案，让你直接在云端运行 OpenClaw。