如何安装 OpenClaw：分步设置指南

OpenClaw 是什么？

OpenClaw 是一款运行在您自己电脑上的个人 AI 助手。可以把它想象成拥有自己的私人聊天机器人，类似于 ChatGPT 或 Claude，只不过它运行在您自己的机器上，而非别人的服务器上。您的对话保存在本地，由您选择驱动它的 AI 模型。

它免费且开源，设置完成后您可以直接从电脑上与它交流，或将其连接到您已经在使用的聊天应用。幕后有几个组成部分（应用本身，以及一个保持其运行并连接 AI 的小型后台助手），但您无需了解这些就可以开始使用。本指南会为您处理好一切。

我们将在 Mac 上从头开始一步步安装 OpenClaw，并验证其是否正常工作。下面您看到的所有内容都来自 OpenClaw 2026.6.1 的真实安装过程：相同的命令，相同的界面。

为什么要自己运行它？

• 您的电脑，您的数据。 您的对话和设置保存在您自己的机器上，而非某家公司的服务器上。
• 使用您喜欢的任何 AI。 接入付费 AI（如 Claude 或 GPT），或在您电脑上本地运行的免费模型，随时切换，无需重新开始。
• 一个助手，随处可用。 设置一次，即可从您的电脑或手机访问同一个助手（且拥有相同的记忆）。
• 默认私密。 开箱即用，它只监听您自己的电脑；除非您主动开放，否则不会暴露到互联网上。

准备好发展您的业务了吗？

今天开始免费试用，几天内即可看到结果。

申请演示 登录

前提条件

开始前，请确保您具备：

• Node.js 24（推荐）或 Node 22.19+。使用 node --version 检查版本。如果低于 22.19，请先通过 nodejs.org 、Homebrew（brew install node）或 nvm 安装 Node 24。
• 支持的操作系统：macOS、Linux 或 Windows（原生或 WSL2）。
• 一个您熟悉操作的终端。
• 至少一个模型提供商的账户或 API 密钥（Anthropic、OpenAI、本地运行的 Ollama 等）。这将在引导配置时填入，安装时不需要。
• pnpm，仅当您打算从源码构建时才需要。脚本安装和 npm 安装均不需要。

安装 OpenClaw

有三种受支持的安装方式，选择其中一种。

方式 A：一行安装命令（推荐）

在 macOS、Linux 或 WSL2 上，最快捷的方式是使用官方安装脚本：

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

该脚本会检测您的平台，安装 CLI，并直接进入引导配置。如果您想先安装后配置，可以跳过向导：

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

方式 B：全局 npm 安装

如果您已经管理 Node 并偏向使用 npm，可以全局安装该包：

npm install -g openclaw@latest

在全新机器上，这只需几秒钟即可拉取 CLI 及其依赖项：

added 285 packages in 10s

macOS 提示： 如果安装过程中出现关于 sharp 的错误，请在命令前加上 SHARP_IGNORE_GLOBAL_LIBVIPS=1 后重新运行。

方式 C：从源码构建（仅限贡献者）

如果您想运行未发布的版本或对 OpenClaw 本身进行开发，请克隆 pnpm 工作区并进行构建。在仓库根目录使用普通的 npm install 不受支持；该仓库是一个包含捆绑插件的 pnpm 工作区。

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global

无论选择哪种方式，在继续操作前请确认 CLI 已在您的 PATH 中：

openclaw --version

OpenClaw 2026.6.1 (2e08f0f)

加入我们的新闻通讯

免费获取最新提示、趋势和优惠。

电子邮件地址

订阅

引导配置：openclaw onboard

安装 CLI 只是获得了二进制文件；引导配置才是真正的配置过程。这一步将刚安装好的命令变成一个可用的助手。运行：

openclaw onboard --install-daemon

--install-daemon 标志会安装一个后台服务，使网关自动启动：macOS 上为 LaunchAgent，Linux 上为 systemd。向导随后会逐步引导您完成所有配置。以下是完整流程，逐步说明。

第一步：阅读安全须知

OpenClaw 启动时会显示其横幅和一段简短的安全免责声明。由于它是一个能够读取文件并在您的机器上执行操作的强大智能体，在进一步操作之前需要您确认已了解这一点。输入 Yes 继续。

第二步：选择设置模式

选择快速启动（推荐）。它为后续所有步骤使用合理的默认值，约一分钟即可完成配置并开始运行。如果您之后想要完全控制，可以选择手动设置或导入。

第三步：确认网关设置并选择 AI

快速启动显示网关默认设置（端口 18789，绑定回环地址 / 127.0.0.1，令牌认证），然后询问使用哪个 AI 提供商。选择 Anthropic，然后选择登录方式。这里我们复用了本地的 Claude 登录信息，但您也可以粘贴 API 密钥。

第四步：确认模型

向导设置您的默认模型（这里为 claude-opus-4-8）并进入渠道配置。

第五步：选择渠道（或跳过）

渠道让您可以从 Telegram、Slack 或 WhatsApp 等应用与助手交流。现在接入，或直接选择暂时跳过，稍后再添加。

第六步：网络搜索和技能

接下来提供网络搜索提供商（DuckDuckGo 无需密钥即可使用），并显示您的技能状态。选择是以设置技能。

第七步：安装入门技能

选择要启用的技能以及用于安装的包管理器（选 npm 即可）。

第八步：依赖项安装完成

OpenClaw 拉取其技能所需的依赖项。您可以放心拒绝它询问的可选 API 密钥；任何需要密钥的技能在您添加之前只是处于休眠状态。向导还会在此提供 hooks（钩子） 配置，我跳过了，然后安装完成。

什么是钩子？ 钩子让 OpenClaw 在某个命令或事件发生时自动执行操作，无需手动干预。一个很好的例子（向导所展示的）是在您每次用 /new 或 /reset 开启新对话时将当前对话保存到记忆中，确保没有有用的信息丢失。其他实用场景包括：长任务完成时给自己发通知，或记录每条命令以便审计。不过这些都是纯粹的可选项，完全可以像我一样选择暂时跳过，等到您知道想自动化哪些内容后再开启。这是最后一个问题，之后引导配置便完成了。

提示： 在服务器上或脚本中运行？openclaw onboard 可以通过标志传入所有答案，实现无交互运行。运行 openclaw onboard --help 查看所有可用标志。

验证安装

以下三个命令可确认所有配置已正确连接。按顺序运行。

1. 确认 CLI 可用

openclaw --version

如果此命令打印出版本号（这里为 OpenClaw 2026.6.1 (2e08f0f)），则说明二进制文件已安装并在您的 PATH 中。

2. 使用 doctor 审计配置

openclaw doctor

doctor 是 OpenClaw 的自检工具。它审计网关、模型认证、命令所有者、状态目录和安全状态，然后准确告诉您需要修复哪些内容（如有）。在全新安装完成引导配置后，您应该看到它报告 0 个插件错误，插件已加载，以及一份包含非阻塞性待处理事项的简短列表（如下所示）。

这些事项不会阻止您使用 OpenClaw；它们是您有空时需要整理的事情（设置命令所有者，在令牌过期前重新认证）。doctor 运行正常是判断安装是否健康的最快方式。

3. 检查网关是否正在运行

openclaw gateway status

此命令报告后台网关服务是否已加载并可访问。在健康的安装中，您会看到它正在运行，并附有成功的连接探测结果（如下所示）。

守护进程运行后，您还可以访问仪表板：一个完整的浏览器控制面板，用于与助手聊天、浏览会话和工作区文件，以及更改设置。最简单的打开方式是：

openclaw dashboard

这会在您的浏览器中打开仪表板并自动登录，您可以立即开始使用。（您也可以直接访问 http://127.0.0.1:18789/，但它会要求您先用网关令牌登录，所以使用 openclaw dashboard 可以省去这一步。）

首次运行：与您的助手交流

网关启动后，打开本地终端聊天：

openclaw chat

首次启动时，您的助手会启动、自我介绍，并询问几个问题来建立自己的身份：名字、您的时区以及您希望它具备的个性。这次初始交流是认证、网关和提供商协同工作的真正验证。

用自然语言回答，助手会完成自身设置，选择一个名字，并将其身份信息写入您的工作区，随时准备为您提供帮助。

您也可以通过仪表板的网页界面进行聊天，或者，如果您在引导配置时连接了消息渠道，可以从该渠道配对您的账户，从手机访问同一个助手。

记忆功能：OpenClaw 如何记住（并"做梦"）

让 OpenClaw 感觉不像一个无状态聊天机器人的功能是其记忆子系统，作为内置插件 memory-core 提供。在安装后立即了解这一点很有价值，因为正是它将零散的对话转变为一个真正能随时间积累您相关背景知识的助手。

您可以随时通过以下命令查看：

openclaw memory status

在全新安装的机器上，在引导配置或对话之前，状态如实显示为空（如下所示）。

以下是该功能的工作原理，以通俗的语言说明：

提升过程刻意保守（事实必须反复出现几次才会固化），做梦功能默认关闭，因此不会在您不知情的情况下在后台积累长期记忆。

以下几个命令让您可以查看或管理记忆：

您无需操作这些即可使用 OpenClaw，但了解助手的长期知识保存在 ~/.openclaw 下——在您自己的磁盘上，完全由您掌控——是很有益的。

OpenClaw 与 FlowHunt 的对比

两者都运行 AI 智能体，但面向截然不同的用户群体。在经历上述安装过程之后，这种对比值得深入理解。

OpenClaw 是一款自托管的单用户助手。正如本指南所展示的，让它运行起来需要：终端安装、引导向导、需要定期重新认证的模型授权、需要保持运行的网关，以及一份需要自行加固的 doctor 待办清单。这就是自托管的代价：完全控制，但基础设施（更新、运行时间、安全性、令牌轮换）永远是您的责任。这是一个很棒的个人项目，但并非为承载团队工作负载而设计。

FlowHunt 是云托管的、面向工作场景的无代码 AI 智能体和工作流构建运行平台，它去除了您刚才经历的每一个维护步骤。无需安装任何内容，无需保持任何服务运行。您在可视化拖拽编辑器中构建多步骤流程和协作智能体团队（“Crews”），几次点击即可接入 60 多种集成（持续增加）和 MCP 服务器，附加实时知识源（网站、文档、PDF、视频），将聊天机器人部署到您的网站、LinkedIn 或 Slack，安排所有任务无人值守运行，并在内置分析中查看投资回报。而且您很少从空白画布开始：FlowHunt 内置了近 500 个预构建智能体（其中约 30 个涵盖了大多数日常工作），因此大多数工作流程是选择一个现成的智能体并稍作调整，而非从头构建。在 OpenClaw 中需要终端、守护进程和嵌入密钥才能半成品配置的功能，在 FlowHunt 中是完全托管的特性。

该选择哪个？ 如果 OpenClaw 对您来说是一个周末项目（在您自己掌控的硬件上拥有一个私人助手，且不介意照看它），那它确实很有趣。但如果您真正需要 AI 把工作做好——可重复的工作流程、聊天机器人、以及团队能够构建和信赖的智能体而无需任何人运行服务器——FlowHunt 是更快、维护成本更低的选择，您今天就可以上线运行。 它甚至与 OpenClaw 使用相同的 MCP 服务器和模型，因此将编排和运维工作交给 FlowHunt 处理不会损失任何东西。

总结

安装 OpenClaw 确实只需几分钟：一条安装命令、一个引导向导、三个验证检查。安装过程将 openclaw CLI 添加到您的 PATH；openclaw onboard --install-daemon 配置好模型提供商、回环网关、工作区和后台服务；而 doctor 加上 gateway status 在您打开仪表板之前确认一切正常运行。

从这里开始，助手就属于您了，可以自由扩展：连接更多渠道、启用更多技能、切换到其他模型，或者当您需要它与其他工具一起执行定时多步骤任务时，从 FlowHunt 进行编排。您刚刚完成的设置是基础；之后的一切都是配置，而非安装。