Windows 版 YouClaw 首次安装后多个工具不可用,疑似 sdk-cache/vendor 依赖未完整初始化
问题概述
在 Windows 环境中,从官网下载并安装 YouClaw 后,发现多个内置工具不可用。经过本地排查,问题更像是运行时缓存目录 sdk-cache 初始化不完整,导致依赖文件缺失,而不是安装在 D: 盘引起的。安装以及初始化时开启或不开启科学上网都尝试过了。
环境信息
- 操作系统:
Windows 11 家庭中文版
- 测试日期:
2026-03-24
- 安装目录:
D:\software\YouClaw
- 用户数据目录:
C:\Users\xxx\AppData\Roaming\com.youclaw.app
- 可执行文件:
D:\software\YouClaw\youclaw.exe
D:\software\YouClaw\youclaw-server.exe
前置条件
- 通过官网下载YouClaw_0.0.158_x64-setup.exe并安装
- 已开启开发者模式
- 已关闭防火墙
- 已关闭杀毒软件
问题描述
启动 YouClaw 后,多个内置工具不可用或表现异常。
可正常使用的工具
Bash
Read
Write
Edit
TodoWrite
Agent
AskUserQuestion
Skill
- IPC 定时任务文件写入
不可用或异常的工具
Glob
Grep
TaskOutput
WebFetch
mcp__minimax__understand_image
关键报错
Glob 和 Grep 都报出了同一类错误,指向同一个缺失文件:
ENOENT: no such file or directory, uv_spawn 'C:\Users\44841\AppData\Roaming\com.youclaw.app\sdk-cache\vendor\ripgrep\x64-win32\rg.exe'
实际排查结果
当前目录:
C:\Users\44841\AppData\Roaming\com.youclaw.app\sdk-cache
实际只看到以下文件:
按报错推断,预期应存在但实际缺失的路径为:
C:\Users\44841\AppData\Roaming\com.youclaw.app\sdk-cache\vendor\ripgrep\x64-win32\rg.exe
这说明 vendor 目录很可能没有被完整下载、解压或初始化。
复现步骤
- 从官网下载安装YouClaw_0.0.158_x64-setup.exe 版 YouClaw。
- 启动程序。
- 调用
Glob 或 Grep。
- 观察到工具报错,提示缺少
rg.exe。
预期结果
- 首次启动后,
sdk-cache/vendor 应自动完成初始化。
Glob、Grep 等内置工具应可直接使用,无需手动干预。
实际结果
sdk-cache/vendor 内容缺失或不完整。
- 多个工具启动即失败,或表现异常。
原因分析
目前看,这不像是因为程序安装在 D: 盘导致的问题。
原因如下:
- 安装目录
D:\software\YouClaw 本身看起来正常。
- 缺失依赖和工具报错都指向用户缓存/数据目录:
C:\Users\xxx\AppData\Roaming\com.youclaw.app\...
因此更像是以下问题之一:
- 首次启动时缓存初始化失败
- 依赖下载失败
- 依赖解压失败
- 运行时引导流程中某个错误被静默忽略
希望确认的问题
- Windows 版本是否依赖首次启动时下载或解压
vendor 资源?
- 如果初始化失败,当前是否有自动重试或修复机制?尝试关闭youclaw并删除`sdk-cache文件夹后重启youclaw还是一样。
- 是否可以在界面中提供“重建工具缓存”或“修复依赖”的入口?
- 是否可以在日志或界面中更明确提示
sdk-cache/vendor 缺失,而不是只表现为工具不可用?
建议排查方向
- Windows 首次启动时
sdk-cache 的初始化流程
vendor 依赖的下载与解压逻辑
- 初始化失败后是否被静默忽略
TaskOutput、WebFetch、图像工具异常是否与同一条初始化链路有关
补充说明
一开始我怀疑问题可能与安装在 D: 盘而不是 C: 盘有关,但从实际报错路径和目录检查结果来看,这个问题更像是 AppData 下缓存/bootstrap 流程异常,而不是安装盘符导致。
Windows 版 YouClaw 首次安装后多个工具不可用,疑似
sdk-cache/vendor依赖未完整初始化问题概述
在 Windows 环境中,从官网下载并安装 YouClaw 后,发现多个内置工具不可用。经过本地排查,问题更像是运行时缓存目录
sdk-cache初始化不完整,导致依赖文件缺失,而不是安装在D:盘引起的。安装以及初始化时开启或不开启科学上网都尝试过了。环境信息
Windows 11 家庭中文版2026-03-24D:\software\YouClawC:\Users\xxx\AppData\Roaming\com.youclaw.appD:\software\YouClaw\youclaw.exeD:\software\YouClaw\youclaw-server.exe前置条件
问题描述
启动 YouClaw 后,多个内置工具不可用或表现异常。
可正常使用的工具
BashReadWriteEditTodoWriteAgentAskUserQuestionSkill不可用或异常的工具
GlobGrepTaskOutputWebFetchmcp__minimax__understand_image关键报错
Glob和Grep都报出了同一类错误,指向同一个缺失文件:实际排查结果
当前目录:
C:\Users\44841\AppData\Roaming\com.youclaw.app\sdk-cache实际只看到以下文件:
cli.jspackage.json按报错推断,预期应存在但实际缺失的路径为:
C:\Users\44841\AppData\Roaming\com.youclaw.app\sdk-cache\vendor\ripgrep\x64-win32\rg.exe这说明
vendor目录很可能没有被完整下载、解压或初始化。复现步骤
Glob或Grep。rg.exe。预期结果
sdk-cache/vendor应自动完成初始化。Glob、Grep等内置工具应可直接使用,无需手动干预。实际结果
sdk-cache/vendor内容缺失或不完整。原因分析
目前看,这不像是因为程序安装在
D:盘导致的问题。原因如下:
D:\software\YouClaw本身看起来正常。C:\Users\xxx\AppData\Roaming\com.youclaw.app\...因此更像是以下问题之一:
希望确认的问题
vendor资源?sdk-cache/vendor缺失,而不是只表现为工具不可用?建议排查方向
sdk-cache的初始化流程vendor依赖的下载与解压逻辑TaskOutput、WebFetch、图像工具异常是否与同一条初始化链路有关补充说明
一开始我怀疑问题可能与安装在
D:盘而不是C:盘有关,但从实际报错路径和目录检查结果来看,这个问题更像是AppData下缓存/bootstrap 流程异常,而不是安装盘符导致。