夜雨聆风小白版 · 从零开始 · 三种方法
OpenClaw 是一个自托管的 AI 网关，可以把 Discord、Telegram、WhatsApp 等聊天软件连到 AI 助手。本教程面向 Windows 用户，从零开始，手把手教你装好。
📋 目录
1️⃣ 安装前准备
2️⃣ 方法一：Windows Hub（最简单，推荐小白）
3️⃣ 方法二：PowerShell 命令行安装
4️⃣ 方法三：WSL2 安装（最稳定，推荐进阶用户）
5️⃣ 安装后配置
6️⃣ 常见问题 & 解决方案
7️⃣ 下一步
————————————
1. 安装前准备
你需要准备什么
🪟 Windows 版本Windows 10 (20H2 或更新) 或 Windows 11
🔑 AI API 密钥（注册即可获取）• Anthropic Claude — 推荐• OpenAI GPT• Google Gemini• 小米 MiMo 等国产模型
🌐 网络能正常访问 GitHub 和 npmjs.com（可能需要科学上网）
💡 怎么查看自己的 Windows 版本？按 Win + R，输入 winver，回车，看弹出的窗口。
————————————
2. 方法一：Windows Hub
⭐ 最简单 · 推荐小白 · 全程图形界面
第 1 步：下载安装包
打开浏览器，访问 GitHub Releases 页面：
👉 github.com/openclaw/openclaw/releases/latest
找到安装文件，下载跟你电脑匹配的那个：
• 大多数电脑（Intel/AMD）→ 下载 OpenClawCompanion-Setup-x64.exe
• ARM 芯片（如骁龙）→ 下载 OpenClawCompanion-Setup-arm64.exe
💡 不确定自己是什么架构？99% 的人下载 x64 就对了。
第 2 步：安装
1. 双击下载的 .exe 文件
2. 不需要管理员权限，按提示一路点下去
3. 安装完成后，从开始菜单找到 OpenClaw Companion 打开
第 3 步：首次启动配置
1. 第一次打开会弹出设置页面
2. 点 「Set up locally」（本地设置）
3. 程序会自动创建 WSL 环境、安装 Gateway、完成配对
4. 等进度条跑完，托盘图标变绿 ✅ 就是成功了
第 4 步：开始聊天
1. 从托盘图标或开始菜单打开 Chat
2. 输入你的 API 密钥（按提示操作）
3. 发送第一条消息，收到 AI 回复就一切正常 🎉
————————————
3. 方法二：PowerShell 命令行安装
⌨️ 适合喜欢命令行 · 或 Hub 安装失败的用户
第 1 步：安装 Node.js
OpenClaw 需要 Node.js 22.19 或更新版本（推荐 Node 24）。
方法 A：用 winget 安装（最简单）
winget install OpenJS.NodeJS.LTS
⚠️ 安装完记得 关闭终端，重新打开一个新的
方法 B：手动下载
打开 nodejs.org，下载 LTS 版本，双击安装。
验证是否装好：
node --version
应该显示 v22.x.x 或 v24.x.x
第 2 步：安装 OpenClaw
iwr -useb https://openclaw.ai/install.ps1 | iex
💡 这条命令会自动检测 Node → 安装 OpenClaw → 准备好一切
第 3 步：运行引导设置
openclaw onboard --install-daemon
向导会问你：
1. 选模型提供商 — 选你有 API 密钥的那个
2. 输入 API 密钥 — 粘贴你的密钥
3. 其他设置 — 一路回车用默认值就行
第 4 步：检查 & 聊天
# 检查网关状态openclaw gateway status# 打开聊天界面openclaw dashboard
————————————
4. 方法三：WSL2 安装
🐧 最稳定 · 推荐进阶用户 · 社区方案最全
第 1 步：开启 WSL2
1. 按 Win + X，选择「终端（管理员）」
2. 运行：
wsl --install
3. 重启电脑
4. 重启后弹出 Ubuntu 窗口，设置用户名和密码
第 2 步：进入 WSL 并安装
# 进入 WSLwsl# 安装 OpenClawcurl -fsSL https://openclaw.ai/install.sh | bash# 运行引导设置openclaw onboard --install-daemon# 检查状态openclaw gateway status# 打开聊天openclaw dashboard
可选：开机自启
# WSL 里运行sudo loginctl enable-linger "$(whoami)"openclaw gateway install# PowerShell（管理员）里运行schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec /bin/true" /sc onstart /ru SYSTEM
————————————
5. 安装后配置
连接聊天软件
⭐ Web 聊天 — 已经自带，openclaw dashboard 就能用
⭐⭐ Telegram — 只需要一个 Bot Token（找 @BotFather 创建）
⭐⭐ Discord — 需要创建一个 Bot
⭐⭐⭐ Signal — 需要一个手机号
⭐⭐⭐ WhatsApp — 需要扫码配对
常用命令速查
openclaw --version # 查看版本openclaw gateway status # 查看网关状态openclaw gateway restart # 重启网关openclaw dashboard # 打开聊天界面openclaw configure # 重新配置openclaw doctor # 自检诊断openclaw update # 更新到最新版
————————————
6. 常见问题 & 解决方案
❌ "openclaw 不是内部或外部命令"
原因：安装路径没加到 PATH 环境变量
解决：
npm config get prefix
记住输出的路径 → 按 Win 搜索「环境变量」→ 编辑 Path → 新建 → 粘贴路径 → 重新打开终端
❌ 安装时网络超时 / 下载失败
原因：国内网络访问 npmjs.com 或 GitHub 可能很慢
解决：先设置淘宝镜像源
npm config set registry https://registry.npmmirror.com
然后重新运行安装命令
❌ "npm error spawn git ENOENT"
原因：缺少 Git
解决：
winget install Git.Git
安装完重新打开终端再试
❌ WSL 安装后打不开 / 报错
解决：
1. 确保 BIOS 里开启了虚拟化（VT-x / AMD-V）
2. 控制面板 → 程序 → 启用或关闭 Windows 功能
3. 勾选「适用于 Linux 的 Windows 子系统」和「虚拟机平台」
4. 重启电脑
❌ API 密钥输入了但聊天没反应
检查：
1. 密钥有没有多余空格
2. 账户里有没有余额/额度
3. 运行 openclaw gateway status 确认网关在运行
4. 运行 openclaw doctor 做全面检查
❌ 怎么更新 / 卸载？
# 更新openclaw update# 卸载npm uninstall -g openclaw
Windows Hub 可从「设置 → 应用」里卸载
————————————
7. 下一步
📖 官方文档 — 最全的参考资料
💬 Discord 社区 — 遇到问题来问
🔧 配置指南 — 进阶配置
📱 连接 Telegram — 最快上手的聊天渠道
🤖 连接 Discord — 社区常用
