WorkBuddy技能数据未刷新是因缓存TTL未正确配置,需通过四步解决:一、在manifest.json中设置cache_ttl_seconds;二、在技能高级配置中禁用运行时缓存;三、手动清除skills目录下缓存;四、设置全局环境变量WORKBUDDY_CACHE_TTL_SECONDS。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在WorkBuddy中成功导入新技能,但其关联的数据(如知识库索引、任务状态、外部API响应缓存)未能及时刷新,导致界面显示陈旧结果或执行逻辑仍调用旧版本数据,则很可能是技能运行时默认启用的缓存TTL(Time-To-Live)策略未被正确覆盖或失效。以下是调整缓存TTL失效策略的具体操作:
一、修改技能级缓存TTL配置项
每个OpenClaw技能包支持在manifest.json中声明独立的缓存生存周期,覆盖全局默认值。若未显式设置,系统将沿用默认300秒(5分钟)TTL,造成数据更新延迟。
1、定位已导入技能所在的本地目录,路径示例为:%APPDATA%\WorkBuddy\skills\web_search(Windows)或~/Library/Application Support/WorkBuddy/skills/pdf_analyzer(macOS)。
2、用文本编辑器打开该目录下的manifest.json文件。
3、在根对象中添加或修改"cache_ttl_seconds": 60字段,数值单位为秒,建议设为60–120之间以平衡性能与实时性。
4、保存文件后,在WorkBuddy主界面执行指令:/reload_skills,强制重载该技能配置。
二、禁用特定技能的缓存机制
对于需强实时性的技能(如监控告警、即时行情解析),可完全关闭其缓存行为,确保每次调用均触发全新数据拉取与计算,绕过所有TTL控制逻辑。
1、进入WorkBuddy「Claw 设置」→「技能管理」,找到目标技能条目。
2、点击技能右侧的「…」按钮,选择「编辑高级配置」。
3、在弹出面板中勾选“禁用运行时缓存”开关。
4、点击「保存并热重载」,系统将移除该技能所有本地缓存键,并在后续执行中跳过缓存校验步骤。
自动备份 OpenClaw 整体配置到远程存储(支持任意 rclone 后端:COS、S3、FTP、SFTP、WebDAV等)。 触发场景: - 创建/配置自动备份任务 - 设置备份周期、保留份数、目标目录 - 手动触发备份 - 查看/恢复备份 - OpenClaw 运行异常时的提醒
三、手动清除技能专属缓存键
WorkBuddy为每个技能维护独立的缓存命名空间(namespace),即使TTL已过期,部分缓存条目可能因哈希冲突或写入异常滞留。主动清空可立即生效,无需等待后台GC。
1、关闭WorkBuddy主程序,确保无workbuddy.exe或WorkBuddy进程残留。
2、打开终端(PowerShell/Terminal),执行以下命令切换至缓存根目录:
Windows:cd %LOCALAPPDATA%\WorkBuddy\cache
macOS:cd ~/Library/Caches/WorkBuddy
3、执行清理命令:
Windows:Remove-Item -Path ".\skills\*" -Recurse -Force
macOS/Linux:rm -rf ./skills/*
4、重新启动WorkBuddy,进入「技能中心」,对已导入技能执行一次手动触发(如点击测试按钮或发送测试指令),验证数据是否即时更新。
四、覆盖全局缓存TTL环境变量
当多个技能需统一缩短缓存周期,且无法逐个修改manifest时,可通过启动参数强制设定全局TTL上限,该值优先级高于技能级配置,适用于调试与临时应急场景。
1、退出所有WorkBuddy进程。
2、在终端中设置环境变量:
Windows:$env:WORKBUDDY_CACHE_TTL_SECONDS="90"
macOS/Linux:export WORKBUDDY_CACHE_TTL_SECONDS=90
3、随后通过终端启动WorkBuddy:
Windows:Start-Process WorkBuddySetup.exe
macOS:open -a "WorkBuddy"
4、启动后进入「设置」→「关于」→「运行时信息」,确认Cache TTL Override字段显示为90。
















