OpenClaw Windows 系统完整安装教程（2026 最新版）

共计 2524 个字符，预计需要花费 7 分钟才能阅读完成。

[目录] 系统要求

[开始] 安装方法选择

方法一：PowerShell 一键安装（推荐新手）

适合：不想配置 WSL2 的用户，快速体验

# 以管理员身份打开 PowerShell，执行以下命令：iwr -useb https://openclaw.ai/install.ps1 | iex

方法二：WSL2 安装（推荐）

适合：生产环境、长期使用、需要更好性能

# 1. 安装 WSL2（如果尚未安装）wsl --install

# 2. 重启电脑后，打开 WSL 终端（Ubuntu）# 3. 在 WSL 中执行安装命令：curl -fsSL https://openclaw.ai/install.sh | bash

📝 PowerShell 安装详细步骤

步骤 1：检查 Node.js

安装脚本会自动检测并安装 Node.js，但您也可以手动检查：

node --version

如果显示版本低于 22，安装脚本会自动升级。

步骤 2：运行安装脚本

# 打开 PowerShell（建议以管理员身份运行）iwr -useb https://openclaw.ai/install.ps1 | iex

安装脚本会自动执行以下操作：

• [OK] 检测并安装 Node.js 22+
• [OK] 安装 OpenClaw CLI
• [OK] 启动配置向导

步骤 3：运行配置向导

openclaw onboard --install-daemon

向导会引导您配置：

• AI 模型提供商（OpenAI、阿里云等）
• API 密钥
• 网关设置
• 通讯渠道（飞书、Telegram 等）

[WSL] WSL2 安装详细步骤

步骤 1：安装 WSL2

# 以管理员身份打开 PowerShell
wsl --install

# 查看已安装的发行版
wsl --list --verbose

步骤 2：更新 WSL

wsl --update

步骤 3：在 WSL 中安装 OpenClaw

# 打开 WSL 终端（如 Ubuntu）# 执行安装命令：curl -fsSL https://openclaw.ai/install.sh | bash

# 运行配置向导
openclaw onboard --install-daemon

[OK] 验证安装

检查网关状态

openclaw gateway status

打开控制面板

openclaw dashboard

浏览器会自动打开 http://127.0.0.1:18789/

运行诊断

openclaw doctor

[修复] 常见问题解决

问题 1：找不到 openclaw 命令

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

# 将输出路径添加到系统 PATH 环境变量

解决方法：

1. 打开 ” 系统属性 ” → “ 环境变量 ”
2. 在 ” 系统变量 ” 中找到 ”Path”
3. 添加：C:\Users\ 你的用户名 \AppData\Roaming\npm
4. 重启 PowerShell

问题 2：PowerShell 执行策略限制

# 临时允许执行脚本
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

问题 3：WSL2 无法访问网络

# 在 WSL 中检查网络
ping 8.8.8.8

# 如果无法 ping 通，在 PowerShell 中执行：wsl --shutdown
wsl

问题 4：sharp 模块安装失败

# 强制使用预编译二进制
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

[配置] 配置飞书渠道

步骤 1：创建飞书应用

1. 访问 飞书开放平台
2. 创建企业应用
3. 复制 App ID 和 App Secret

步骤 2：配置权限

在飞书开放平台添加以下权限：

• im:message – 发送和接收消息
• im:message.group_at_msg:readonly – 读取群聊 @消息
• im:chat.access_event.bot_p2p_chat:readonly – 私聊权限

步骤 3：在 OpenClaw 中配置

# 编辑配置文件
notepad %USERPROFILE%\.openclaw\openclaw.json

添加飞书配置：

{
  "channels": {
    "feishu": {
      "appId": "cli_xxx",
      "appSecret": "xxx",
      "enabled": true
    }
  }
}

[更新] 更新与卸载

更新 OpenClaw

openclaw update

卸载 OpenClaw

# PowerShell
npm uninstall -g openclaw

# 删除配置目录（可选）Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw

[参考] 快速参考

[注意] 安全提示

• 不要在公共网络暴露网关端口（默认 18789）
• 妥善保管 API 密钥和飞书 App Secret
• 定期更新 OpenClaw 以获取安全补丁
• 使用防火墙限制访问来源

[学习] 学习资源

• 官方文档：https://docs.openclaw.ai
• GitHub：https://github.com/openclaw/openclaw
• 社区论坛：https://discord.com/invite/clawd
• 技能市场：https://clawhub.ai