OpenClaw 安装教程（WSL 版本）

前提条件

• Windows 10/11 系统
• 已启用 WSL 2 并安装 Ubuntu 发行版

步骤 1：检查 WSL 状态

首先确认 WSL 是否已正确安装并运行：

1. 打开 PowerShell
2. 运行命令：

   wsl --list --verbose

3. 确保看到类似输出：

   NAME STATE VERSION

   * Ubuntu-24.04 Running 2

步骤 2：更新 Ubuntu 系统

1. 进入 WSL Ubuntu 终端：

   PowerShell

   运行

   wsl -d Ubuntu-24.04

2. 更新系统包：

   Bash

   运行

   sudo apt update && sudo apt upgrade -y

步骤 3：安装 Node.js 22+

参考：Windows下WSL(Ubuntu24.04)安装Nodejs

步骤 4：安装 OpenClaw

1. 使用 npm 全局安装 OpenClaw：

   运行

   npm install -g openclaw@latest

步骤 5：运行 OpenClaw 向导

1. 启动 OpenClaw 安装向导：

   运行

   openclaw onboard --install-daemon

2. 按照向导提示完成以下步骤：
   • 配置工作区
   • 添加消息渠道（WhatsApp、Telegram 等）
   • 设置 AI 模型
   • 安装守护进程

步骤 6：启动 OpenClaw 网关

1. 启动 OpenClaw 网关：

   Bash

   运行

   openclaw gateway --port 18789 --verbose

步骤 7：测试 OpenClaw

1. 发送测试消息：

   Bash

   运行

   openclaw message send --to +1234567890 --message "Hello from OpenClaw"

2. 与 AI 助手对话：

   Bash

   运行

   openclaw agent --message "Hello, who are you?" --thinking high

常见问题解决

1. 网络问题：如果遇到镜像源连接超时，尝试更换 Ubuntu 镜像源
2. 权限问题：使用 sudo 命令获取管理员权限
3. Node.js 版本问题：确保安装的是 Node.js 22 或更高版本
4. 端口占用：如果 18789 端口被占用，使用其他端口启动网关

后续操作

• 查看文档：openclaw docs
• 检查状态：openclaw status
• 更新 OpenClaw：openclaw update

通过以上步骤，你应该能够成功在 WSL 中安装并运行 OpenClaw 个人 AI 助手。如果遇到任何问题，可以参考 OpenClaw 官方文档 或加入 Discord 社区 获取帮助。