ToClaw字幕缺失或不同步需五步排查：一、启用内置字幕自动下载并设语言；二、绑定授权视频平台账号；三、截图+指令手动触发下载与校准；四、清理subcache_缓存目录（保留index.db）；五、强制指定字幕源（如YouTube AI或B站API）。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在使用ToClaw观看视频时发现缺少字幕，或字幕未自动加载、不同步、语言不匹配，则可能是由于字幕源未启用、视频平台限制、本地缓存干扰或ToClaw字幕策略未触发所致。以下是解决此问题的步骤：

一、启用ToClaw内置字幕自动下载功能

该功能依赖ToClaw对主流视频平台（如B站、YouTube、腾讯视频等）的协议解析能力，需手动开启字幕抓取开关并指定语言偏好，确保AI在识别播放行为后主动调用字幕服务。

1、打开ToClaw主界面，点击右上角“设置”齿轮图标。

2、进入“媒体增强”选项卡，找到“视频字幕自动获取”开关并开启。

3、在“默认字幕语言”下拉菜单中选择中文（简体）或所需语种。

4、勾选“优先下载嵌入式字幕轨道”与“备用调用第三方字幕API”两项。

5、点击“保存并重启ToClaw服务”使配置生效。

二、绑定并授权视频平台账号

ToClaw需通过已登录的平台账号访问受权限保护的字幕资源（例如B站会员专享字幕、YouTube自动生成字幕），未绑定将导致仅能获取公开字幕或完全无响应。

1、在ToClaw设置中切换至“账号联动”页签。

2、点击“添加视频平台账号”，选择目标平台（如哔哩哔哩、YouTube）。

3、按引导完成扫码或OAuth授权流程，确保状态栏显示已验证且在线。

4、返回视频播放页，刷新页面或重新加载视频链接以触发字幕重载。

三、手动触发字幕下载与同步校准

当自动机制未响应时，可通过截图+自然语言指令方式强制调用字幕模块，ToClaw将基于当前画面帧识别视频ID，并从多源匹配最优字幕文件进行下载与时间轴对齐。

1、在视频播放界面暂停于任意关键帧，按下快捷键 Ctrl+Shift+S（Windows）或 Cmd+Shift+S（macOS）截取当前画面。

2、在ToClaw聊天框中输入指令：“下载当前视频的中文字幕并校准时间轴”。

3、等待ToClaw返回“字幕已就绪”提示，点击弹出的.srt文件预览按钮确认内容与播放进度一致。

4、若存在偏移，使用滑块微调延迟值，拖动至-200ms～+300ms区间内实时预览效果。

四、检查并清理字幕缓存目录

ToClaw将下载的字幕文件本地缓存于固定路径，若缓存损坏或版本冲突，可能导致重复下载失败、字幕错乱或无法加载。

1、在ToClaw设置中进入“存储管理”页签，点击“打开字幕缓存目录”。

2、定位到子文件夹名称含“subcache_”的目录，确认其路径为：%AppData%\ToDesk\ToClaw\subcache_（Windows）或 ~/Library/Application Support/ToDesk/ToClaw/subcache_（macOS）。

3、删除该目录下所有以“.srt”、“.vtt”结尾的文件，但保留“index.db”文件不删。

4、重启ToClaw客户端，再次播放同一视频，观察是否重新生成并加载新字幕。

五、切换字幕源优先级策略

ToClaw默认按“平台内建字幕 > AI语音转录 > 第三方字幕站”顺序回退，若某环节失效，可手动指定首选源以绕过故障链路。

1、在视频播放状态下，右键点击ToClaw任务栏图标，选择“高级字幕控制”。

2、在弹出面板中关闭“自动源协商”，启用“强制指定字幕源”。

3、从下拉列表中选择YouTube AI生成字幕（适用于YouTube视频）或Bilibili官方字幕API（适用于B站视频）。

4、点击“立即重试”，ToClaw将跳过其他路径，直连所选源获取字幕流。