前提规则

  1. WSL 必须处于启动状态(PowerShell 输入wsl启动 Ubuntu),\\wsl$路径才可以被 Windows 挂载访问。
  2. 只能修改 WSL Linux 原生 ext4 磁盘里的文件(路径:/home/robin/下的 openclaw 项目);禁止把项目放在/mnt/c,/mnt/c 是 Windows NTFS 磁盘,跨系统读写性能差、权限极易错乱。

一、三种编辑方式(按推荐优先级排序)

方式 1:资源管理器 UNC 路径编辑(记事本、Notepad++、Typora 修改六份 MD 文件,最常用)

  1. Win+E 打开 Windows 文件资源管理器,地址栏输入二选一:

plaintext

\\wsl$

新版 Win11 推荐写法:

plaintext

\\wsl.localhost\Ubuntu-24.04
  1. 点开Ubuntu‑24.04homerobinopenclaw\workspace,直接编辑 IDENTITY.md、AGENTS.md、MEMORY.md 等配置文件,保存后 WSL 实时生效。

完整 Windows 访问路径示例: \\wsl$\Ubuntu-24.04\home\robin\openclaw\workspace

方式 2:WSL 终端一键唤起 Windows 文件夹(效率最高)

  1. WSL 终端进入项目目录:

bash

运行

cd /home/robin/openclaw/workspace
  1. 执行命令直接打开当前目录:

bash

运行

explorer.exe .

自动跳转至\\wsl$对应文件夹,直接修改文件。

方式 3:VS‑Code Remote‑WSL 插件(开发最优方案,解决权限问题)

  1. Windows 安装 VS‑Code,安装 Remote‑WSL 插件;
  2. WSL 终端输入code .,直接在 Windows 的 VS‑Code 打开 WSL 项目;
  3. 底层运行在 WSL 环境,不会破坏 Linux 文件权限、属主,编辑后不会出现脚本无法执行、权限拒绝 (Permission denied) 问题,专门用来长期维护 OpenClaw 配置文件。

二、常见问题:Windows 修改后 WSL 权限异常(核心坑点)

现象

Windows 编辑文件后,文件所有者变成 root,OpenClaw 读取报错、脚本执行失败。

修复命令(WSL 终端执行)

  1. 将文件归属权切回你的 robin 用户:

bash

运行

sudo chown -R $USER:$USER /home/robin/openclaw
  1. 修复目录、文件标准权限:

bash

运行

find /home/robin/openclaw -type d -exec chmod 755 {} \;
find /home/robin/openclaw -type f -exec chmod 644 {} \;

永久优化配置(写入 /etc/wsl.conf)

ini

[automount]
options = "metadata,umask=022"
mountFsTab=false
[user]
default=robin

保存后执行wsl --terminate Ubuntu-24.04重启 WSL,后续 Windows 修改文件时权限更稳定Microsoft ...。

三、必须区分的两套目录(OpenClaw 部署核心)

  1. /home/robin/:WSL 原生 Linux 文件,通过\\wsl$在 Windows 编辑,读写速度快,OpenClaw 项目必须放在这里
  2. /mnt/c/:挂载的 WindowsC 盘,Linux 读写 NTFS 磁盘性能差,权限不稳定,不能存放 OpenClaw 程序,仅用来读取 Windows 资料。

四、对比 VMware‑Workstation

  1. WSL:通过\\wsl$互通,Windows 直接修改 md 文件,开发调试效率高;缺点不适合 7×24 不间断运行。
  2. VMware 虚拟机:Linux 文件存储在 vmdk 虚拟磁盘,Windows 只能通过共享文件夹读写,权限问题更多,仅用于正式上线交付。

五、极简总结(实操口诀)

  1. 启动 WSL;
  2. Windows 访问\\wsl$\Ubuntu‑24.04\home\robin\openclaw
  3. 直接修改 md 配置;权限错乱就执行 chown 命令修复。
Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐