适用环境： 全新 Windows 10/11 系统，无任何开发工具
预计耗时： 30–45 分钟
最后更新： 2026 年 3 月

目录

1. OpenClaw 简介
2. 系统要求与准备
3. 第一阶段：安装 WSL2 + Ubuntu
4. 第二阶段：启用 systemd
5. 第三阶段：安装 Node.js
6. 第四阶段：安装 OpenClaw
7. 第五阶段：运行 Onboarding 向导
8. 第六阶段：验证与访问控制面板
9. 第七阶段：连接聊天渠道（可选）
10. 常见问题排查
11. 安全建议
12. 进阶：局域网端口转发

1. OpenClaw 简介

OpenClaw（原名 Clawdbot / Moltbot）是一个开源的本地优先 AI 个人助手。它在你自己的机器上运行一个 Gateway 进程，连接到你日常使用的聊天平台（WhatsApp、Telegram、Discord、Slack、飞书等），并接入主流大模型（Claude、GPT、Gemini、通义千问、智谱等）来完成各种任务。

核心架构： Gateway 守护进程 + Agent 代理 + Skills 技能插件 + Channels 聊天渠道

2. 系统要求与准备

你还需要准备一个 LLM API Key（以下任选其一）：

• Anthropic API Key
  （推荐）：前往 https://console.anthropic.com 注册并创建
• OpenAI API Key
  ：前往 https://platform.openai.com 获取
• 国内模型
  ：智谱 Z.AI（glm 系列）、通义千问（DashScope）等，在各自平台获取 Key

⚠️ 重要安全提示： OpenClaw 是实验性软件，官方建议不要在包含个人敏感数据的主力机器上安装。最佳做法是使用虚拟机、WSL 隔离环境或专用 VPS。

3. 第一阶段：安装 WSL2 + Ubuntu

OpenClaw 官方推荐在 Windows 上通过 WSL2（Windows Subsystem for Linux）运行。原生 Windows 安装（PowerShell）虽然可行但不够稳定，WSL2 能获得完整的 Linux 体验。

3.1 打开 PowerShell（管理员模式）

1. 按 Win 键，输入 PowerShell
2. 右键点击 Windows PowerShell，选择 "以管理员身份运行"

3.2 安装 WSL2

在 PowerShell 中输入：

wsl --install

这条命令会自动完成以下操作：

• 启用 WSL2 功能
• 安装默认的 Ubuntu 发行版

如果你想指定 Ubuntu 版本：

# 查看可用发行版
wsl --list --online

# 安装指定版本（推荐 Ubuntu 24.04）
wsl --install -d Ubuntu-24.04

3.3 重启电脑

安装完成后，系统会提示重启。请务必重启。

3.4 初始化 Ubuntu

重启后，系统会自动打开 Ubuntu 终端窗口（如果没有自动打开，从开始菜单搜索 Ubuntu 启动）。

按提示设置：

• 用户名
  ：输入一个用户名（小写英文，如 flowbywind）
• 密码
  ：设置密码（输入时不会显示，这是正常的）

💡 记住这个用户名和密码，后续操作会用到。

3.5 验证 WSL2 安装成功

回到 PowerShell（管理员），执行：

wsl --status

确认输出中包含 默认版本: 2 或 Default Version: 2。

4. 第二阶段：启用 systemd

OpenClaw 的 Gateway 守护进程依赖 systemd 服务管理。WSL2 默认未启用 systemd，需要手动开启。

4.1 在 Ubuntu 终端中执行

打开 Ubuntu 终端（从开始菜单搜索 Ubuntu），输入：

sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

输入你之前设置的密码确认。

4.2 重启 WSL

回到 PowerShell（管理员），执行：

wsl --shutdown

等待几秒钟，然后重新打开 Ubuntu 终端。

4.3 验证 systemd 已启用

在 Ubuntu 终端中执行：

systemctl --user status

如果没有报错，说明 systemd 已成功启用。

5. 第三阶段：安装 Node.js

OpenClaw 基于 Node.js 运行，要求 Node 22.16+ 或 Node 24（推荐 Node 24）。

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

在 Ubuntu 终端中执行：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

安装完成后，关闭并重新打开 Ubuntu 终端，或者执行：

source ~/.bashrc

5.2 安装 Node.js 24

nvm install 24
nvm use 24
nvm alias default 24

5.3 验证安装

node --version    # 应显示 v24.x.x
npm --version     # 应显示 10.x.x 或更高

6. 第四阶段：安装 OpenClaw

有两种安装方式，推荐使用一键安装脚本。

方式 A：一键安装脚本（推荐）

在 Ubuntu 终端中执行：

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

脚本会自动检测环境、安装 OpenClaw CLI，并启动 onboarding 向导。

如果你只想安装不启动向导，可以加参数：

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

方式 B：通过 npm 手动安装

如果一键脚本遇到网络问题，可以手动安装：

npm install -g openclaw@latest

如果 sharp 模块构建失败，尝试：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

方式 C：从源码构建（高级用户）

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install -g pnpm    # 需要 pnpm
pnpm install
pnpm ui:build          # 构建 Web UI
pnpm build
pnpm link --global

验证安装

openclaw --version

如果提示 openclaw: command not found，执行以下修复：

# 检查全局包路径
npm prefix -g

# 将全局 bin 目录加入 PATH
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 再次验证
openclaw --version

7. 第五阶段：运行 Onboarding 向导

如果你使用了一键脚本，向导会自动启动。如果没有，手动执行：

openclaw onboard --install-daemon

向导会引导你完成以下配置（约 2 分钟）：

7.1 安全确认

首先会出现安全风险提示。用方向键选择 "Yes"（我理解这是实验性软件），按回车确认。

7.2 选择安装类型

• QuickStart
  ：快速安装，适合大多数用户（推荐）
• Advanced
  ：自定义安装

7.3 选择 LLM 模型提供商

OpenClaw 支持多种模型提供商：

选择你的提供商后，按提示输入 API Key。

💡 国内用户提示： 如果选择国内模型，在认证方式处选择 "CN" 区域。

7.4 选择 Gateway 绑定地址

推荐选择 Loopback (127.0.0.1)，只允许本机访问，更安全。

7.5 Skills（技能插件）

首次安装可以先选 "No" 跳过，后续再配置。

7.6 Hooks（钩子）

可以选择启用以下 Hooks：

• Shell completions
  ：命令行自动补全
• 其他
  ：按需选择，或选 "Skip for now"

7.7 Gateway Daemon 安装

选择 "Yes" 安装 Gateway 守护进程。这会将 OpenClaw 注册为 systemd 服务，开机自动启动。

7.8 完成配置

向导最后会提示是否重启服务。选择 "Restart"。

安装完成后，终端会显示：

• Gateway 状态
  ：Online
• Web UI 地址
  ：http://127.0.0.1:18789
• Access Token
  ：一串令牌字符串

⚠️ 请复制并保存这个 Access Token，访问 Web UI 时需要用到。

8. 第六阶段：验证与访问控制面板

8.1 检查 Gateway 状态

在 Ubuntu 终端中：

openclaw gateway status

应显示 Gateway 正在运行，监听端口 18789。

8.2 运行健康检查

openclaw doctor

这会检查配置是否有问题，并给出修复建议。

8.3 访问 Web 控制面板

1. 打开 Windows 浏览器（Chrome/Edge 均可）
2. 访问 http://127.0.0.1:18789
3. 在设置中粘贴你之前保存的 Access Token
4. 连接成功后，你会看到 OpenClaw 的 Web UI 界面

8.4 发送第一条消息

在 Web UI 的聊天框中输入任意消息（如 "你好，你能做什么？"），如果收到 AI 回复，说明一切正常！

8.5 用 CLI 打开面板（可选）

也可以直接在终端执行：

openclaw dashboard

这会自动在默认浏览器中打开控制面板。

9. 第七阶段：连接聊天渠道（可选）

OpenClaw 支持多种聊天平台，你可以从手机直接和 AI 助手对话。

Telegram（最容易配置）

1. 在 Telegram 中搜索 @BotFather，创建一个新 Bot，获取 Bot Token
2. 在 Ubuntu 终端中配置：

   openclaw configure --section channels.telegram
   

3. 输入 Bot Token
4. 向你的 Bot 发消息，它会返回配对码，完成绑定

WhatsApp

openclaw channels login

终端会显示一个二维码，用 WhatsApp → 设置 → 已关联设备 扫描即可。

Discord

1. 前往 https://discord.com/developers/applications 创建应用
2. 创建 Bot 并获取 Token
3. 在 OpenClaw 中配置：

   openclaw configure --section channels.discord
   

飞书 (Feishu)

OpenClaw 支持飞书的 WebSocket 长连接模式，需要在飞书开发者平台创建机器人应用，获取 App ID 和 App Secret 后在 OpenClaw 中配置。

10. 常见问题排查

Q: openclaw 命令找不到

# 检查 Node 是否安装
node -v

# 检查全局包目录
npm prefix -g

# 确认 PATH 包含全局 bin 目录
echo $PATH

# 修复：将全局目录加入 PATH
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Q: Gateway 无法启动

# 查看 Gateway 日志
openclaw logs gateway

# 重启 WSL
# 在 PowerShell 中执行：
wsl --shutdown
# 然后重新打开 Ubuntu 终端

# 重新启动 Gateway
openclaw gateway install

Q: WSL2 中网络不通

# 测试网络
ping -c 3 google.com

# 如果不通，尝试重启 WSL
# PowerShell (管理员)：
wsl --shutdown

# 检查 DNS 配置
cat /etc/resolv.conf

Q: npm install 报权限错误

# 不要用 sudo 运行 npm install -g
# 而是修复 npm 全局目录权限
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Q: 如何更新 OpenClaw

npm install -g openclaw@latest
openclaw gateway restart

Q: 如何完全卸载

openclaw gateway uninstall    # 移除守护进程
npm uninstall -g openclaw     # 卸载 CLI
rm -rf ~/.openclaw             # 删除配置文件

11. 安全建议

1. 绑定 localhost
   ：确保 openclaw.json 中 Gateway 地址为 127.0.0.1 而非 0.0.0.0
2. 不要以 root 运行
   ：始终使用普通用户安装和运行 OpenClaw
3. 审查社区插件
   ：安装第三方 Skills 前仔细检查，避免恶意代码
4. 启用审批机制
   ：对 terminal、filesystem_delete 等危险工具启用 exec_approval
5. 定期更新
   ：保持 OpenClaw 为最新版本以获取安全修复
6. 配合防火墙
   ：如果部署在服务器上，配置 UFW 规则限制入站访问

12. 进阶：局域网端口转发

如果你需要从局域网内其他设备访问 WSL2 中的 OpenClaw，需要配置端口转发。

在 PowerShell（管理员）中执行：

# 获取 WSL IP 地址
$WslIp = (wsl -- hostname -I).Trim().Split(" ")[0]
Write-Host "WSL IP: $WslIp"

# 添加端口转发规则
netsh interface portproxy add v4tov4 `
  listenaddress=0.0.0.0 listenport=18789 `
  connectaddress=$WslIp connectport=18789

# 添加防火墙规则（仅需执行一次）
New-NetFirewallRule -DisplayName "OpenClaw Gateway" `
  -Direction Inbound -Protocol TCP `
  -LocalPort 18789 -Action Allow

⚠️ 注意： WSL 的 IP 地址在每次重启后会变化，需要重新执行端口转发命令。可以创建一个计划任务在登录时自动刷新。

快速参考卡片

📚 官方文档： https://docs.openclaw.ai
💬 社区 Discord： https://discord.com/invite/clawd
🐙 GitHub 仓库： https://github.com/openclaw/openclaw