workbuddy无全局一键唤醒，需配置后台常驻才能秒启：windows用户可将快捷方式放入shell:startup文件夹实现开机自启；macos首次启动须手动在“隐私与安全性”中允许应用；调试模式按ctrl+shift+d（win）或cmd+shift+d（macos）查看真实运行状态；微信远程指令生效前提为客户端进程存活且claw连接成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 没有全局“一键唤醒”式快捷启动入口，它的启动行为取决于你是否已配置后台常驻机制——没配，就只能双击图标；配了，才能实现真正意义上的“秒启可用”。
Windows 下用 shell:startup 文件夹实现静默开机自启
这是最轻量、最稳妥的启动方式，适合绝大多数普通用户。它不修改注册表，不依赖任务计划程序的复杂配置，且只对当前用户生效。
- 按
Win + R，输入shell:startup回车，打开当前用户的启动文件夹 - 确保 WorkBuddy 安装目录下有
WorkBuddy.exe（典型路径如C:\Program Files\WorkBuddy\WorkBuddy.exe） - 右键该 exe → 【发送到】→ 【桌面快捷方式】，再把生成的快捷方式复制进刚打开的启动文件夹
- 重启电脑验证：登录后任务栏应立刻出现 WorkBuddy 图标，且托盘常驻
注意：若快捷方式指向错误（比如目标路径含空格但未加引号），会导致启动失败且无提示；建议右键快捷方式 → 【属性】→ 检查“目标”字段是否为完整带引号路径，例如："C:\Program Files\WorkBuddy\WorkBuddy.exe"
macOS 首次启动必须手动绕过“无法验证开发者”拦截
Mac 版 WorkBuddy 默认被系统阻止运行，这不是安装失败，而是 macOS Gatekeeper 的正常防护。跳过这步，后续所有快捷操作（包括 Claws 设置、剪贴板响应）都会失效。
- 双击
WorkBuddy.app启动，遇到红色警告弹窗时点【取消】 - 进入【系统设置】→【隐私与安全性】→下滑到【通用】区域
- 在“允许从以下位置下载的应用”下方找到 WorkBuddy 条目，点击右侧【允许】
- 重新从 Launchpad 或 Applications 文件夹中启动，确认菜单栏出现
WorkBuddy字样
如果跳过这步直接尝试绑定微信或启用剪贴板监听，你会看到权限开关始终灰显，且 Claw 设置 里“文件系统权限检测”显示红色失败——这是 macOS 级别的硬性拦截，不是软件 Bug。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
调试模式下按 Ctrl+Shift+D 才能暴露真实启动状态
当 WorkBuddy 启动后图标闪烁几下就消失，或托盘无响应，别急着重装。先用调试面板确认它是否真“挂了”，还是只是界面未加载完成。
- 确保主程序进程已在后台运行（可在任务管理器 / Activity Monitor 中搜索
WorkBuddy） - 按
Ctrl + Shift + D（Windows）或Cmd + Shift + D（macOS）唤出调试面板 - 观察右下角滑出窗口中的日志流：若持续输出
Claw connected和File system ready，说明核心服务已就绪，只是 UI 渲染延迟 - 若日志卡在
security check failed或permission denied on /Users/xxx/Documents，说明文件权限未授全，需回退到 macOS 的「完全磁盘访问」设置补授权
这个组合键是唯一能绕过图形界面、直连底层服务状态的通道。很多“启动失败”的案例，其实只是用户没等完初始化过程，就误判为崩溃。
微信远程指令触发不了？先检查本地守护进程是否存活
微信发 /debug on 没反应，大概率不是网络问题，而是本地 WorkBuddy 的后台守护进程根本没跑起来——特别是 Windows 用户禁用了开机自启，又没手动启动客户端时。
- 在 Windows 任务管理器中查看是否有
WorkBuddy.exe进程；macOS 则在 Activity Monitor 中搜索同名进程 - 如果没有，说明微信指令根本没有接收端，所有消息都会被丢弃
- 此时必须先手动启动客户端，再等待右下角出现“Claw 已连接”提示（非托盘图标常驻即可，需看到连接成功浮窗）
- 只有守护进程在线，微信发来的
/run 周报生成这类指令才会被解析并转发到本地执行引擎
远程控制功能的“启动”本质是两个动作：客户端进程存活 + Claw 通信链路建立。少一个，微信就只是在单向发消息，收不到任何回执。
