OpenClaw 2026-02 安装避坑指南（Windows + WSL2 权限错误终极解法）

问题：
在 Windows 上用 WSL2 安装 OpenClaw，执行 pip install openclaw 后运行 openclaw start，报错：

PermissionError: [Errno 13] Permission denied: '/home/yourname/.openclaw/config.yaml'

或者更隐蔽的情况：浏览器打不开、邮箱登录失败、touch test.txt 没反应——不是模型没加载，是 OpenClaw 根本没权限写配置、建临时目录、调用浏览器。

✅ 步骤 1：确认 WSL2 发行版和基础环境（别跳！）

用管理员权限打开 PowerShell，检查 WSL 状态：

wsl -l -v
# 输出应类似：
# NAME            STATE           VERSION
# Ubuntu-22.04    Running         2

如果版本是 1，或未安装 Ubuntu-22.04：

wsl --update
wsl --install --distribution Ubuntu-22.04

OpenClaw 2026-02 依赖 Python 3.11+ 和 dbus。Ubuntu 22.04 自带兼容内核和 dbus-daemon；WSL1 不支持 dbus，Ubuntu 20.04 缺少 GTK 相关库，会导致浏览器调用静默失败。

✅ 步骤 2：修复 WSL2 权限根目录（关键！）

WSL2 的 /home/xxx 是 ext4，但 /mnt/c/... 是 NTFS，权限模型不互通。OpenClaw 若把配置写到 /mnt/c/Users/...，必然 PermissionDenied。

必须把所有 OpenClaw 数据锁定在 /home 下：

# 进入 WSL2 Ubuntu
wsl ~

# 创建专属工作目录（确保路径在 /home 内）
mkdir -p ~/openclaw-workspace

# 设置环境变量（永久生效）
echo 'export OPENCLAW_HOME="$HOME/openclaw-workspace"' >> ~/.bashrc
echo 'export PATH="$OPENCLAW_HOME/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 验证
echo $OPENCLAW_HOME  # 应输出 /home/你的用户名/openclaw-workspace

OPENCLAW_HOME 是 OpenClaw 查找 config.yaml、日志、浏览器 profile 的根路径。设成 /mnt/c/... 会因 NTFS 权限映射失效，连 config.yaml 都生成不了，后续全部卡死。

✅ 步骤 3：安装官方镜像 + 兼容依赖

OpenClaw 2026-02 已停更 PyPI 包（二进制依赖太多），只认官方 wheel：

# 升级 pip 和 setuptools（避免 wheel 构建失败）
python3 -m pip install -U pip setuptools

# 下载并安装官方 wheel（含预编译 chromedriver + dbus binding）
curl -L https://github.com/openclaw/openclaw/releases/download/v2026.02/openclaw-2026.02-py311-none-manylinux_2_35_x86_64.whl -o openclaw.whl
pip install ./openclaw.whl

# 安装 WSL2 必需的系统依赖
sudo apt update && sudo apt install -y dbus-x11 xvfb

dbus-x11 让 OpenClaw 能发系统通知、控制浏览器；xvfb 提供虚拟显示缓冲，让无 GUI 的 WSL2 也能启动 Chromium——否则 openclaw browse 会直接 hang 住。

✅ 步骤 4：首次运行 & 验证真实能力

# 启动（自动生成 config.yaml 并弹出配置向导）
openclaw start

⚠️ 第一次会调用 Windows 主机上的 Chrome 浏览器。按提示输入邮箱（Outlook/Gmail 均可）、授权日历、允许文件读写。完成后关闭浏览器，在终端按 Ctrl+C 停止。

验证三件事（逐条执行）：

# ① 写文件（真写进 WSL2 的 home 目录）
openclaw run "echo 'Hello from AI colleague' > ~/test_claw.txt"

# ② 查日历（需已在向导中授权）
openclaw run "list calendar today"

# ③ 开浏览器并截图（验证 GUI 链路）
openclaw browse --screenshot https://yitb.com
# → 截图保存在 ~/openclaw-workspace/screenshots/

你会看到 test_claw.txt 出现在 wsl ~ 下；日历返回你今天会议；ls ~/openclaw-workspace/screenshots/ 能列出 PNG 文件。这才是 OpenClaw 在你本地真正跑起来的手感。

❗常见问题速查

• Q：openclaw start 启动后浏览器空白？
  A：WSL2 默认不转发 X11。在 Windows 安装 VcXsrv，启动时勾选 Disable access control，然后在 WSL2 中执行 export DISPLAY=:0，再运行命令。
• Q：Gmail 授权失败，提示 “app not verified”？
  A：优先用 Outlook 邮箱（微软已白名单 OpenClaw）。若坚持用 Gmail，需在 Google Cloud Console 启用 Gmail API 并配置 OAuth 同意屏幕（教程见 yitb.com/gmail-oauth）。
• Q：openclaw run ls / 返回空？
  A：检查是否在 Windows PowerShell 或 CMD 里执行了该命令——OpenClaw 所有 run/browse/start 命令必须在 WSL2 终端中运行。

下一步

你现在有一个能读写文件、调日历、发邮件、开浏览器的本地 AI 同事。试试这些：

→ 学习《OpenClaw 自定义工具链：3 行代码接入公司内部 API》
→ 实战《用 OpenClaw 每天自动归档微信聊天记录到 Notion》
→ 进阶《给 OpenClaw 加上 Ollama 本地模型，彻底离线运行》

动手试一句：openclaw run 'date >> ~/log.txt'，看时间戳落进你 WSL2 的硬盘——这就是 AI 在你机器上真正开工的第一声。