2026年OpenClaw 个人AI助手完整安装教程（Windows／Linux）

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

OpenClaw 是一个自托管的个人AI助手，通过一个本地网关连接你常用的聊天渠道（WhatsApp、Telegram、Slack、Discord、iMessage等），并支持语音交互、实时画布、浏览器控制、设备节点（macOS/iOS/Android）等强大功能。你可以把它想象成一个开源版的“钢铁侠JARVIS”。

官方推荐在 WSL2（Windows Subsystem for Linux） 上运行，以获得**体验。本教程以 Ubuntu 22.04（WSL2）为例，同时适用于原生Linux系统。

2.1 系统要求

操作系统：Windows ¹⁰⁄₁₁（启用WSL2）或 Linux（Ubuntu 20.04+）
内存：至少4GB（推荐8GB+）
磁盘空间：至少2GB（用于代码和依赖）
网络：能够访问GitHub和npm registry

2.2 安装WSL2（Windows用户）

以管理员身份打开 PowerShell，执行：

该命令会自动安装默认的 Ubuntu 发行版并启用WSL2。安装完成后重启电脑。

重启后，打开开始菜单找到 Ubuntu 图标，首次启动会提示创建用户名和密码（请记好，后续sudo会用到）。

2.3 更新系统包（WSL2/Linux通用）

在Ubuntu终端中执行：

2.4 安装nvm（Node版本管理器）

nvm可以让你轻松安装和管理多个Node版本，避免权限问题。

安装完成后，重新加载配置文件：

验证nvm是否安装成功：

如果显示版本号（如0.39.7），说明成功。

⚠️ 如果命令找不到，请关闭当前终端，重新打开一个新终端，或者手动执行和加载。

2.5 安装Node.js 22

使用nvm安装并设为默认：

检查版本：

2.6 安装pnpm

pnpm是高性能的包管理器，OpenClaw项目依赖它。

验证安装：

在用户主目录下（或你喜欢的位置）克隆项目：

执行pnpm安装，这会根据下载所有依赖包：

安装过程中可能会看到一些下载警告，属于正常现象。耐心等待，最终应显示类似下面的成功信息：

可能遇到的警告

如果你需要使用 Discord语音 或 Tlon集成，可以运行以下命令允许它们执行构建脚本：

然后根据提示选择允许即可。否则可以忽略，不影响核心功能。

构建过程会生成目录，并将TypeScript编译为JavaScript。如果一切顺利，终端最后会显示类似信息。

6.1 运行向导（首次配置，推荐）

向导会帮助你：

设置网关（控制平面）
配置聊天渠道（如WhatsApp、Telegram）
安装后台服务（确保网关常驻）

6.2 直接启动网关（手动模式）

网关默认监听在，打开浏览器访问即可看到控制界面。

6.3 测试发送消息

打开另一个终端，进入项目目录，发送测试消息（请替换为真实号码）：

如果一切正常，目标号码会收到消息（需要先配置对应渠道）。

Q1: 安装pnpm时提示

原因：系统自带的Node安装在，普通用户无写入权限。
解决：使用nvm安装Node（已在教程中覆盖），全局包会安装在用户目录下，无需sudo。

Q2: 运行时提示 Node 版本过低

错误示例：

原因：系统Node版本低于22.12.0。
解决：执行和切换到高版本。

Q3: 构建时出现语法错误

错误示例：

原因：Node版本过低（<20），不支持语法。
解决：升级Node到22+（步骤见2.5）。

Q4: 下载依赖速度极慢

原因：npm官方源在国内访问较慢。
解决：可以临时使用淘宝镜像：

安装完成后可以恢复官方源：

Q5: 运行命令找不到

原因：pnpm的bin目录可能不在PATH中。
解决：使用而不是直接。或者将pnpm bin目录加入PATH：

然后就可以直接运行了。

Q6: 安装过程中卡住（长时间无响应）

按终止，然后尝试强制重新安装：

或者针对特定包重试：

8.1 常用命令

启动网关：
查看帮助：
运行健康检查：
更新到最新版本：

8.2 添加聊天渠道

配置渠道需要修改配置文件，或者再次运行向导：

具体渠道的配置参数请参考官方文档：Channels

8.3 启动开发模式（修改代码后自动重载）

代码变更后会重新编译并重启网关。

至此，你已经成功在本地安装了OpenClaw个人AI助手。你可以通过Web界面、命令行或已配置的聊天渠道与它互动。OpenClaw的强大之处在于它的可扩展性——你可以编写自己的“技能”（Skills），让它自动化处理各种任务。

如果在安装过程中遇到其他问题，欢迎查阅官方文档或在GitHub提交Issue。祝玩得开心！

附录：WSL2与Windows文件互访

在WSL2中，Windows的C盘挂载在
在Windows资源管理器中，输入即可访问WSL2的文件系统