OpenClaw完整安装指南：从环境准备到首次运行

说实话，我第一次听说OpenClaw的时候，心里是有点犯嘀咕的。又是一个AI工具？安装会不会很麻烦？要不要折腾一堆环境配置？结果装完之后发现，整个过程比我想象的顺滑多了。

这篇文章就是想把我的安装经验分享给你，特别是那些和我一样，对命令行不太熟悉，但又想尝鲜的朋友。不管你用的是Mac、Linux还是Windows，跟着这个指南，基本上不会踩什么大坑。

OpenClaw到底是什么？

在开始安装之前，咱们先聊聊OpenClaw是个啥。简单来说，它是一个开源的AI助手平台，可以把像ChatGPT、Claude这样的大语言模型连接到你常用的聊天工具上，比如Telegram或者WhatsApp。

你可能会问，为什么要在本地装这个？直接用网页版的AI不香吗？

其实各有各的好处。本地安装的话，你可以：

自己掌控数据和隐私
自定义各种功能和技能
把AI接入到自己的工作流中
如果愿意折腾，甚至可以用本地模型，完全不依赖云服务

对我来说，最吸引我的是可以把AI接到Telegram上，这样平时聊天就能直接调用，不用来回切换应用。

准备工作：检查你的系统

老实讲，OpenClaw对系统要求还挺友好的。不过在开始之前，还是得确认几个事情。

操作系统兼容性

OpenClaw原生支持macOS和Linux。如果你用的是Windows，也没问题，但需要先装个WSL2（Windows Subsystem for Linux）。

WSL2其实就是在Windows里跑一个轻量级的Linux环境。听起来复杂，但微软已经把它做得很简单了。打开PowerShell，运行一条命令就能装好：

wsl --install

装完记得重启电脑，然后再打开PowerShell输入wsl就能进入Linux环境了。

硬件要求

说到硬件，OpenClaw真的不挑食。官方建议是：

内存：8GB够用，16GB更好
存储：至少留20GB空间（建议用SSD，体验会好很多）

基本上，只要你的电脑能流畅跑个浏览器，运行OpenClaw就没啥问题。我用的是一台8GB内存的老MacBook，跑起来也挺顺的。

Node.js环境

这是最关键的一步。OpenClaw是基于Node.js开发的，所以必须先装Node.js。而且版本要求是22或更高。

如果你想开发自定义技能（skills），官方推荐装Node.js 24+，因为新版本支持一些更先进的JavaScript特性。

macOS安装Node.js

Mac用户最简单的方法是用Homebrew：

# 如果还没装Homebrew，先装这个
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 然后安装Node.js
brew install node

Linux安装Node.js

Linux的话，我推荐用nvm（Node Version Manager），这样可以轻松切换不同的Node.js版本：

# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 重启终端后，安装Node.js 22
nvm install 22
nvm use 22

Windows (WSL2)安装Node.js

在WSL2里，和Linux的方法一样，用nvm就行。

安装完之后，验证一下版本：

node --version

只要显示v22.x.x或更高，就OK了。

包管理器：npm还是pnpm？

Node.js装好之后，会自带npm（Node Package Manager）。OpenClaw用npm完全没问题。

不过如果你听说过pnpm，也可以用它。pnpm相比npm有几个优势：

安装速度更快
占用磁盘空间更少
依赖管理更严格

对于普通用户来说，用哪个都行。我自己习惯用pnpm，不过这完全看个人喜好。

如果想装pnpm：

npm install -g pnpm

开始安装OpenClaw

准备工作做完，咱们就可以正式开始了。OpenClaw提供了好几种安装方式，我按推荐程度给你讲讲。

方法一：官方安装脚本（最推荐）

这是最简单的方法，一行命令搞定：

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

这个脚本会自动帮你：

检查系统环境
安装必要的依赖
下载并安装OpenClaw CLI
提示你运行初始配置

整个过程大概需要1-2分钟，取决于你的网速。我第一次装的时候，看着终端里刷刷刷地输出日志，还挺有成就感的。

方法二：npm全局安装

如果你更喜欢用包管理器，可以直接用npm：

npm install -g openclaw@latest

@latest确保你装的是最新版本。装完之后，终端里就可以直接用openclaw命令了。

方法三：pnpm全局安装

用pnpm的话：

pnpm add -g openclaw@latest

效果和npm一样，只是用的工具不同。

方法四：从源码安装（进阶）

如果你想折腾，或者打算给OpenClaw贡献代码，可以从GitHub克隆源码：

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git

# 进入目录
cd openclaw

# 安装依赖
pnpm install

# 构建
pnpm ui:build

这种方法适合开发者，普通用户不推荐。

初始配置：让OpenClaw跑起来

装好OpenClaw之后，还不能直接用，需要先跑一遍配置向导。这一步很重要，但也很简单。

运行onboard向导

在终端里输入：

openclaw onboard --install-daemon

这个命令会启动一个交互式的配置向导。--install-daemon参数的意思是把OpenClaw安装为系统服务，这样开机就能自动运行，不用每次手动启动。

接下来，向导会一步步问你几个问题：

1. 选择运行模式

通常选择**本地模式（Local gateway）**就行，除非你想部署到远程服务器。

2. 配置AI模型

这里需要选择你想用的AI提供商。目前支持：

OpenAI（GPT-4、GPT-3.5等）
Anthropic（Claude系列）
本地模型（需要额外配置）

如果你有OpenAI或Anthropic的API密钥，在这里输入。没有的话，可以先跳过，后面再配。

获取API密钥的方法：

OpenAI：去platform.openai.com注册账号，在API keys页面生成
Anthropic：去console.anthropic.com注册，同样在API设置里生成

3. 设置工作目录

向导会问你把OpenClaw的配置和数据放在哪里。默认是~/.openclaw/，一般直接回车用默认的就行。

4. 连接消息渠道

这一步是选择你想用哪个聊天平台来和AI对话。目前支持：

Telegram：需要先在Telegram里找@BotFather创建一个bot，拿到token
WhatsApp：会生成一个二维码，用手机WhatsApp扫码关联
跳过：如果你只想用Web界面，可以暂时跳过

我自己选的是Telegram，配置过程很简单：

在Telegram搜索@BotFather
发送/newbot命令
按提示给bot起名字
复制生成的token
粘贴到OpenClaw的配置里

5. 安装守护进程

最后，向导会问你要不要安装守护进程。选”是”的话，OpenClaw会在后台持续运行，你关闭终端也不影响。

整个配置过程大概5-10分钟，主要时间花在获取API密钥和配置聊天渠道上。

手动配置（可选）

如果你想微调配置，可以编辑配置文件：

nano ~/.openclaw/openclaw.json

这个文件是JSON格式，包含了所有的配置项。不过对于大部分用户，用向导配置就够了，不需要手动改。

首次运行：验证一切正常

配置完成后，就可以启动OpenClaw了。

启动Gateway

如果你刚才没有安装守护进程，需要手动启动：

openclaw gateway --port 18789

18789是默认端口，你可以改成其他的。启动成功的话，会看到类似这样的输出：

✓ OpenClaw Gateway started on http://localhost:18789

访问Web界面

打开浏览器，访问：

http://localhost:18789

你应该能看到OpenClaw的控制界面。界面很简洁，主要有几个部分：

Chat：聊天测试区
Agents：管理你的AI代理
Skills：配置各种技能插件
Settings：系统设置

测试对话

在Chat页面，试着发送一条消息，比如”你好”或者”介绍一下你自己”。

如果一切配置正确，AI应该会回复你。第一次看到回复的时候，还是挺激动的——这就是你自己搭建的AI助手了！

常见问题排查

装软件嘛，难免会遇到些小问题。我把常见的坑列出来，方便你排查。

Node.js版本不对

症状：运行openclaw命令时报错，提示Node版本不兼容

解决：检查Node.js版本，确保是22+

node --version

如果版本太低，重新安装或升级Node.js。

WSL2配置问题（Windows用户）

症状：在Windows上安装时各种报错

解决：确认WSL2已正确安装并更新到最新版

wsl --update

API密钥无效

症状：配置了API密钥，但AI不回复或报错

解决：

检查密钥是否正确复制（前后没有多余空格）
确认API账户有余额（OpenAI和Anthropic都需要充值）
重新生成密钥试试

端口被占用

症状：启动Gateway时提示端口18789已被占用

解决：换个端口，或者找出占用端口的进程并关闭

# 查看谁在用18789端口
lsof -i :18789

# 换个端口启动
openclaw gateway --port 18790

权限问题

症状：安装时提示权限不足

解决：Linux/Mac用户可能需要用sudo，或者检查目录权限

# 确保有写入权限
chmod -R 755 ~/.openclaw

安全提醒

OpenClaw装好之后，有几个安全方面的事项要注意：

不要暴露端口：18789端口默认只监听localhost，千万别把它暴露到公网，否则任何人都能访问你的AI
保护API密钥：配置文件里的API密钥很敏感，不要分享给别人，也不要提交到Git仓库
远程访问用SSH隧道：如果你想从其他设备访问，用SSH隧道，不要直接开放端口

# 从另一台电脑通过SSH访问
ssh -L 18789:localhost:18789 user@your-server

写在最后

好了，到这里你应该已经成功装好OpenClaw了。回顾一下整个流程：

OpenClaw快速安装流程

从零开始安装并配置OpenClaw的步骤

⏱️ 预计耗时: 10 分钟

1
步骤1: 环境准备
安装Node.js 22+ (Mac用Brew, Linux/Windows用nvm)。确认系统满足要求。
2
步骤2: 安装核心
运行官方推荐脚本安装OpenClaw：
curl -fsSL https://openclaw.ai/install.sh | bash
3
步骤3: 初始化配置
执行 onbard 向导配置API和渠道：
openclaw onboard --install-daemon
4
步骤4: 启动服务
如果未安装守护进程请手动启动：
openclaw gateway
访问 http://localhost:18789 验证安装。

下一步，你可以：

探索Skills功能，给AI添加各种能力
尝试连接Telegram或WhatsApp，在聊天软件里调用AI
如果有兴趣，研究一下如何开发自定义技能
看看官方文档，了解更多高级功能

说实话，OpenClaw虽然是开源项目，但体验已经做得很不错了。如果你在安装过程中遇到什么问题，可以去GitHub的Issues页面看看，社区还挺活跃的。

最后提醒一句：第一次接触这类工具可能会觉得有点复杂，但装过一次之后，你会发现其实也就那么回事。慢慢来，遇到问题多搜搜，基本都能解决。

祝你玩得开心！

参考来源：

常见问题

Node.js版本不对怎么办？

使用 node -v 检查，必须22+。推荐用 nvm 管理版本：
nvm install 22
nvm use 22

Windows安装报错？

确保已安装WSL2（wsl --install）并更新（wsl --update）。
请在WSL终端（Ubuntu等）中执行安装命令，而不是在Windows CMD或PowerShell中。

API Key无法使用？

1. 检查密钥无多余空格
2. 确认账户有余额（OpenClaw本身免费，但调用OpenAI/Claude API需要付费）
3. 尝试重新生成Key

端口18789被占用？

使用 lsof -i :18789 查进程。
或者启动时指定端口：openclaw gateway --port 18790

10 分钟阅读 · 发布于: 2026年2月5日 · 修改于: 2026年2月5日

Easton

AI与智能