OpenClaw 保姆级安装流程

什么是 OpenClaw？

OpenClaw 是一个开源的智能助手平台，它运行在您的计算机上，并可与您常用的聊天应用配合使用。无论您身在何处，WhatsApp、Telegram、Discord、Slack 还是 Teams，您的 AI 助手都会伴您左右。

你的助手。你的机器。你的规则。

与数据存储在他人服务器上的 SaaS 助手不同，OpenClaw 可以运行在您选择的任何地方——笔记本电脑、家庭实验室或 VPS。您的基础设施。您的密钥。您的数据。

废话不多说，切入正题

安装前准备工作

在开始安装之前，需要确保你的系统满足以下基本要求，以及网络需要高效，最好是美国。OpenClaw 主要为类 Unix 环境设计，但在 Windows 上可以通过 WSL2 (Windows Subsystem for Linux 2) 完美运行。

系统要求

●Node.js: 版本需要大于或等于 22。Node.js 是 OpenClaw 的运行环境。

●操作系统: macOS, Linux, 或 Windows (通过 WSL2)。

●包管理器: 如果选择从源码编译，需要安装 pnpm。对于大多数用户，推荐使用 npm，它会随 Node.js 一起安装。

1.提一嘴，MacOS, 如果没有 Xcode Command Line Tools ，需要先在终端安装Xcode Command Line Tools，

验证是否安装；打开终端 (Terminal)，输入：xcode-select -p

●如果返回：/Library/Developer/CommandLineTools，说明你已经装过了。

●如果返回：error: unable to locate working directory 或者报错，说明确实没装。

需要安装 Xcode Command Line Tools ；在终端输入：xcode-select --install

然后点击弹窗中的“安装”，接受协议，等待下载完成即可。

2.Node.js : Google 浏览器搜索下载 https://nodejs.org/zh-cn/download

验证是否安装成功，在终端输入：node -v

如果显示 v24.x.x，恭喜你，成功了！

如果版本低于V22.0.0，或提示命令未找到，请先访问 Node.js 官网进行安装或升级。

开始安装 OpenClaw

OpenClaw 提供了多种安装方式，以适应不同用户的需求。对于初学者，官方推荐使用一键安装脚本，它能自动处理大部分环境配置。

快速安装 (推荐)

这是最简单、最快捷的安装方式。它会自动检测你的操作系统，安装必要的依赖，并将 openclaw命令部署到全局。

对于 macOS 或 Linux 系统，请在终端中执行以下命令：

curl -fsSL https://openclaw.bot/install.sh | bas

对于使用 PowerShell 的 Windows 用户，请执行以下命令：

iwr-useb https://openclaw.ai/install.ps1 |iex

安装脚本执行完成后，会自动进入一个名为 onboard的交互式设置向导，引导你完成初始配置。如果因为某些原因中断了向导，可以随时通过以下命令重新启动：

openclaw onboard --install-daemon

安装方式概览（可选）

除了推荐的快速安装脚本，OpenClaw 还支持其他几种安装方式。了解它们的区别可以帮助你根据自己的技术背景和使用场景做出更合适的选择。

手动安装与故障排查（可选）

如果你更倾向于手动控制安装过程，或者在安装时遇到了问题，可以参考以下步骤。

首先，确保你的 Node.js 和 npm 环境已就绪。然后执行全局安装命令：

npm install -g openclaw@latest 

在某些系统环境下，尤其是在 macOS 上通过 Homebrew 安装了 libvips库时，可能会遇到 sharp模块的安装错误。sharp是一个用于图像处理的库。此时，可以尝试使用以下命令强制安装预编译的二进制文件，绕过本地编译：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest 

安装完成后，一个常见的问题是终端提示 openclaw: command not found。这通常是因为 npm 全局安装目录没有被添加到系统的 PATH环境变量中。

可以通过以下命令找到 npm 的全局路径：

npm prefix -g 

假设输出的路径是 /usr/local，那么二进制文件的路径就是 /usr/local/bin。需要将这个路径添加到你的 Shell 配置文件中（如 ~/.zshrc或 ~/.bashrc）：

exportPATH="$(npm prefix -g)/bin:$PATH"

修改配置文件后，需要重启终端，或者执行 source ~/.zshrc(或对应的文件名) 使其生效。之后，openclaw命令应该就可以正常使用了。

初始化与配置

安装完成后，下一步是进行初始化配置，让 OpenClaw 连接到大语言模型 (LLM) 并设置好通信渠道。

运行 Onboarding 向导

onboard向导是完成初始配置最简单的方式。它会一步步引导你设置所有必需的选项。

openclaw onboard --install-daemon

这个向导会询问你以下关键信息：

●AI 模型配置: 你需要提供一个大语言模型服务的 API Key，例如 Anthropic Claude、OpenAI GPT 或其他兼容的服务。OpenClaw 依靠这些模型来理解指令和生成回应（笔者这里用的是 Google Gemini CLI 授权，选择 Google 然后登录后选模型就行）。

通信渠道: 设置你希望通过哪个聊天软件与 OpenClaw 交流，比如 Telegram 或 WhatsApp。向导会引导你完成配对。Telegram是即使通讯，需要用到美国IP跟美国手机号，不好操作的也可以不选Telegram，选择Skip for now。

选择Telegram的，需要下载Telegram软件（电脑/手机）地址：https://telegram.org/

登录后，在软件搜索里@BotFather，进入BotFather界面；在聊天框里输入/newbot

他会让您给机器人取个名称，如：AI助手；2.再取个用户名，需要以bot结尾，如：My_Monster_1234_bot

他会给你发一串HTTP API后面那串数字，你把API Token发到终端，并保存好这串Token，以后打开网页，这串Token会是密钥。

电脑端Telegram（电脑端跟手机端可任选一个，获取机器人）

手机版Telegram，设置的机器人名称、用户名以及API密钥，并将API密钥发送到终端

后面会问你要不要 skills，无脑选 Yes 就行（先按空格键再按 Enter 回车键），或者直接跳过。Hooks 的话推荐安装。

完成后，应该就会启动一个 UI 界面，访问它试试，然后在里面开始对话

在 Dashboard 中，你可以：

●直接与 AI 助理聊天。

●管理和配置各种“技能”（Skills）。

●设置定时任务（Cron Jobs），让助理在特定时间自动执行操作。

●查看实时日志，方便排查问题。

●编辑 OpenClaw 的所有配置文件。

●安装和更新 OpenClaw 自身。

使用终端界面 (TUI)

对于更喜欢在终端中工作的用户，OpenClaw 提供了一个纯文本的终端用户界面（TUI）。

首先确保 Gateway 服务正在运行，然后执行：

openclaw tui 

这会启动一个全屏的终端应用，界面清晰地分为聊天记录区、状态栏和输入框。

在 TUI 中，你可以像在普通聊天软件中一样发送消息。此外，它还支持一系列便捷的“斜杠命令”，例如：

●/status: 查看当前状态。

●/session <key>: 切换到不同的聊天会话。

●/model <name>: 临时为当前会话切换使用的大语言模型。

●/help: 查看所有可用的命令。

TUI 提供了一种专注、无干扰的交互体验，非常适合开发者和命令行爱好者。

常用 CLI 命令

除了图形化界面，openclaw的命令行工具本身也极其强大，是自动化和高级配置的关键。

以下是一些在日常使用中非常实用的命令：

openclaw models status用于检查已配置的 AI 模型及其 API Key 的状态，包括是否有效或即将过期。确保模型可用是助理正常工作的前提。

openclaw models status 

openclaw channels list可以列出所有已配置的通信渠道及其当前状态。

openclaw channels list 

openclaw memory search是一个非常强大的功能，它允许你对 AI 助理的长期记忆进行语义搜索。你之前告诉它的所有信息，都可以通过这个命令快速找回。

openclaw memory search "我上次提到的那个项目叫什么名字"

最后，如果想深入了解某个命令或功能的更多用法，openclaw docs命令可以帮助你快速搜索官方文档。

openclaw docs "how to create a new skill"

通过这篇教程，你应该已经成功安装并运行了你的第一个 OpenClaw 实例。这只是一个开始。OpenClaw 的真正魅力在于其高度的可扩展性。你可以教它新的技能，将它接入更多服务，甚至让它自己编写代码来改进自己。欢迎来到个人 AI 助理的新时代。