win11启用wsa后需手动开启文件共享功能，否则无法双向访问本地文件；须确保版本≥2305.40000.2.0，启用“共享用户文件夹”并勾选文档、图片等默认目录，重启wsa生效，家庭版用户还需先开启开发者模式。
在Win11中启用WSA后，系统默认不开放Windows文件访问权限，导致无法直接读取文档、图片等本地文件夹，也无法将WSA内生成的截图、下载内容保存回电脑。必须手动开启双向共享并正确配置路径与权限，否则拖拽、粘贴、文件管理器访问均会失败。
确认WSA已安装且版本支持共享功能
打开“开始菜单”→搜索“Windows Subsystem for Android”，点击启动；等待界面加载完成（进度条走完），右上角显示“设置”图标后，点击进入。若设置页中无“文件共享”选项卡或提示“此功能不可用”，说明当前WSA版本低于2305.40000.2.0——该功能自2305预览版起正式引入，旧版需升级。可前往store.rg-adguard.net粘贴微软商店链接，选择Slow通道下载最新.msixbundle重装。
在WSA设置中启用用户文件夹共享
第一步：在WSA设置界面左侧导航栏点击【文件共享】；
第二步：右侧开关滑块向右拨动，启用“共享用户文件夹”；
第三步：勾选下方列出的默认目录：【文档、图片、下载、音乐、视频】——这五项对应C:\Users\你的用户名\下的同名文件夹；
第四步：点击右下角“应用”按钮，等待状态变为“已启用”；
第五步：关闭设置页，重启WSA（完全退出后重新启动，非仅刷新）。
⚠️注意：若勾选后仍无法访问，请检查是否已安装2305或更高版本；家庭版用户若此前未启用开发者模式，此处可能灰显，需先在“设置→隐私和安全性→开发者选项”中开启开发人员模式。
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
验证Windows端共享路径是否可被WSA识别
打开WSA内置的“文件管理器”应用（如未安装，可在Amazon Appstore中搜索“Solid Explorer”或“FX File Explorer”并安装）；
进入“内部存储”→点击左上角三条横线菜单→选择“Windows”；
此时应出现一个名为“Windows”的根级目录，点开后可见Documents、Pictures等文件夹图标；
若显示“拒绝访问”或为空白，说明Windows侧未完成SMB共享基础配置——此时需返回Windows资源管理器，右键C:\Users\你的用户名，选择“属性→共享→高级共享”，勾选“共享此文件夹”，再点“权限”，确认“你的账户”拥有“读取”权限；
【关键前提】：你的登录账户必须设置密码，空密码账户无法通过SMB协议被WSA认证访问。
通过拖拽实现Windows ↔ WSA文件互传
方法一：在Windows资源管理器中选中文件→按住鼠标左键不放→拖入WSA窗口任意位置（如桌面、文件管理器窗口内）；
方法二：在WSA内长按文件→点击“分享”→选择“Windows剪贴板”→回到Windows中Ctrl+V粘贴（仅限文本与小图）；
方法三：在WSA文件管理器中进入Windows→Documents文件夹→右键空白处→选择“新建文件夹”或“粘贴”，可直接写入；
⚠️提示：拖拽大文件（＞500MB）时可能出现中断，建议改用复制→切换窗口→粘贴方式；首次拖拽失败后，不要反复重试，先关闭WSA再重启一次即可恢复通信链路。
手动添加自定义共享路径（如D:\Project）
WSA默认只挂载C:\Users\下的标准库文件夹，若需共享D盘项目目录，需手动注册：
① 以管理员身份运行Windows终端，执行：icacls "D:\Project" /grant "ALL APPLICATION PACKAGES:(OI)(CI)R"；
② 打开WSA设置→文件共享→点击右下角“添加文件夹”按钮；
③ 在弹出窗口中输入路径：D:\Project（不能带引号，也不能用中文路径）；
④ 点击“确定”，该路径将出现在共享列表底部，勾选后点“应用”；
⑤ 重启WSA，再次打开文件管理器→Windows→即可看到新增的Project文件夹。
⚠️注意：路径中含中文、空格或特殊符号（如&、#）会导致注册失败，且不会报错，只会静默忽略。
