需统一工作区路径、node.js工具链、gateway网络配置、文件编码规范及权限模型：将workspace设为跨系统共用目录，wsl2挂载windows路径并强制指定；通过符号链接复用windows node/npm，全局安装openclaw；gateway绑定0.0.0.0并配置防火墙与端口转发；用.editorconfig和dos2unix统一换行符；按系统特性分别定义permissions.yml权限集并通过环境变量加载。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在Windows和Linux双系统环境中统一管理OpenClaw配置与工作状态，但发现配置文件不互通、环境变量不一致或服务无法跨平台复用，则可能是由于系统路径差异、权限模型不同及默认工作目录隔离所致。以下是实现OpenClaw跨Windows和Linux通用设置的具体方法：
一、统一工作区路径与文件同步
OpenClaw的Workspace（配置目录）默认分散在各系统独立路径下，导致AGENTS.md、SOUL.md等核心配置无法共享。需将工作区设为跨系统可访问的共用位置，并确保文件格式兼容。
1、在Windows中创建共用工作目录，例如：D:\openclaw-shared；
2、在Linux中通过WSL2挂载该目录：执行sudo mkdir -p /mnt/d/openclaw-shared，确认/mnt/d已自动挂载Windows D盘；
3、在Linux终端中验证挂载：运行ls /mnt/d/openclaw-shared，应能列出空目录；
4、初始化时强制指定该路径：在Windows PowerShell和Linux WSL终端中均执行openclaw init --workspace /mnt/d/openclaw-shared（Windows需先切换至D:再用openclaw init --workspace D:\openclaw-shared）；
5、后续所有操作（如openclaw gateway start）均需显式添加--workspace参数指向该路径，避免读取默认~/.openclaw/workspace或%USERPROFILE%\.openclaw\workspace。
二、Node.js与全局命令一致性配置
Windows原生环境与WSL2 Linux子系统各自维护独立的Node.js安装与npm全局路径，导致openclaw命令在两环境间不可互认。需统一全局工具链并修正PATH解析逻辑。
1、在Windows中安装Node.js v24.x LTS（推荐node-v24.13.0-win-x64.msi），安装时勾选Add to PATH；
2、在WSL2中禁用本地Node.js，改用Windows版二进制：执行sudo ln -sf /mnt/c/Program\ Files/nodejs/node.exe /usr/local/bin/node及sudo ln -sf /mnt/c/Program\ Files/nodejs/npm.cmd /usr/local/bin/npm；
3、验证一致性：在WSL2中运行node -v与npm -v，输出应与Windows PowerShell中完全相同；
4、全局安装OpenClaw仅在Windows中执行一次：npm install -g openclaw@latest；
5、在WSL2中运行source ~/.bashrc后，确认openclaw --version可正常返回版本号，若提示“command not found”，则手动将Windows npm全局bin路径加入WSL2的PATH：export PATH="/mnt/c/Users/$USER/AppData/Roaming/npm:$PATH"，并写入~/.bashrc持久化。
三、Gateway服务端口与网络互通配置
OpenClaw Gateway默认绑定127.0.0.1:18789，该地址在WSL2中仅对Linux子系统可见，Windows主机无法直连；反之Windows启动的Gateway也无法被WSL2访问。需启用跨系统网络可达性。
1、在Windows中启动Gateway时显式绑定到0.0.0.0：openclaw gateway start --host 0.0.0.0 --port 18789；
2、在Windows防火墙中放行TCP端口18789：以管理员身份运行PowerShell，执行New-NetFirewallRule -DisplayName "OpenClaw-WSL-Access" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 18789；
OpenClaw 部署前安全检查清单：聚焦合规导向的部署前检查，覆盖防火墙、SSH、API 密钥管理、数据出境合规及多场景验证。清单式检查，逐项打勾并生成报告，适用于个人 Mac、VPS、Docker及企业部署。
3、在WSL2中测试连接Windows Gateway：curl -v http://$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):18789/health，返回HTTP 200表示通路正常；
4、如需从Windows访问WSL2中运行的Gateway，则在WSL2中启动时使用--host 0.0.0.0，并在Windows中添加端口转发规则：netsh interface portproxy add v4tov4 listenport=18789 listenaddress=127.0.0.1 connectport=18789 connectaddress=$(wsl hostname -I | awk '{print $1}')；
5、每次WSL2重启后IP可能变化，建议将上述netsh命令保存为批处理脚本，在WSL2启动后自动执行。
四、配置文件编码与换行符标准化
Windows默认使用CRLF（\r\n）换行，Linux使用LF（\n），混合编辑可能导致OpenClaw解析Markdown配置失败或技能脚本执行异常。必须统一文本格式规范。
1、在Windows中使用VS Code打开共用工作目录，安装扩展“EditorConfig for VS Code”，根目录下创建.editorconfig文件，内容为：root = true [*] end_of_line = lf insert_final_newline = true charset = utf-8 trim_trailing_whitespace = true；
2、在WSL2中安装dos2unix工具：sudo apt install -y dos2unix；
3、首次同步后批量转换：执行find /mnt/d/openclaw-shared -name "*.md" -exec dos2unix {} \;；
4、Git仓库中强制LF：在共用工作目录执行git config core.autocrlf input（Linux）与git config core.autocrlf false（Windows），避免Git自动转换干扰；
5、所有技能脚本（如skills/*.js）须在Linux环境下编辑保存，确保Shebang行（如#!/usr/bin/env node）可执行且无BOM头。
五、权限模型与安全模式适配
Windows UAC与Linux sudo机制差异导致OpenClaw在full权限模式下行为不一致，例如文件写入、系统命令执行可能在一个系统成功而在另一系统拒绝。需按系统特性分别约束权限边界。
1、禁止在Windows中启用full模式：因UAC无法细粒度控制进程权限，易触发系统拦截，改用custom模式并仅启用messaging与file-read；
2、在WSL2中启用full模式前，先配置sudo免密：执行sudo visudo，添加$USER ALL=(ALL) NOPASSWD: /usr/bin/openclaw；
3、创建跨系统权限白名单文件PERMISSIONS.yml置于共用工作目录，内容示例：win_allowed: ["messaging", "file-read"] linux_allowed: ["messaging", "file-read", "system-exec", "browser-control"]；
4、在Windows启动脚本中加入环境变量：set OPENCLAW_PERMISSION_PROFILE=win_allowed；
5、在WSL2启动脚本中加入：export OPENCLAW_PERMISSION_PROFILE=linux_allowed；
6、OpenClaw启动时自动读取该变量并加载对应权限集，确保同一套配置在不同系统下自动适配最小必要权限。
