WorkBuddy QQ消息未同步需依次完成五步操作：一、安装QQ Desktop插件；二、绑定本地已登录QQ并扫码授权；三、在Message Sync Rules中开启对应会话类型与内容权限；四、启动Message Listener并授予权限；五、通过搜索、时间轴及健康检查验证同步状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy过程中发现QQ消息未自动同步至工作台，可能是由于QQ通讯模块未启用或配置未完成。以下是开启WorkBuddy QQ消息同步功能的具体操作步骤：
一、检查并安装QQ通讯插件
WorkBuddy需通过独立通讯插件接入QQ生态，该插件不随主程序默认安装，必须手动启用。若未安装，消息同步功能将完全不可用。
1、打开WorkBuddy桌面客户端，点击右上角个人头像。
2、在下拉菜单中选择Claw Settings（爪设置）。
3、在左侧导航栏找到Connectors（连接器）选项卡。
4、在可用列表中定位QQ Desktop，点击右侧Install按钮。
5、等待插件下载完成，状态显示为Installed & Ready后继续下一步。
二、绑定本地QQ客户端
WorkBuddy通过注入方式与已运行的QQ桌面版建立通信通道，必须确保本地QQ处于登录且前台运行状态，否则无法获取消息流。
1、确认电脑已安装QQ最新正式版（v9.9.15及以上），并已完成登录。
2、保持QQ主窗口最小化或置于后台，但不得退出进程（任务管理器中应可见QQ.exe）。
3、返回WorkBuddy Claw Settings → Connectors → QQ Desktop，点击Link to QQ按钮。
4、弹出二维码窗口后，在手机QQ中点击“扫一扫”，扫描该二维码。
5、手机端确认授权，并勾选允许同步聊天记录与新消息提醒选项。
三、配置消息同步范围与权限
为保障隐私与性能，WorkBuddy默认仅同步指定会话类型，需手动开启群聊、私聊、文件消息等子类权限。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
1、进入Claw Settings → QQ Desktop → Message Sync Rules。
2、在Sync Scope区域，勾选需要同步的消息来源：包括我的好友、我的群聊、QQ频道。
3、在Content Types区域，分别开启文字消息、图片/截图、文件（≤50MB）的同步开关。
4、关闭语音消息自动转文字（该功能需额外调用本地ASR模型，首次启用将触发约120MB缓存下载）。
四、启动实时消息监听服务
WorkBuddy采用事件驱动架构监听QQ客户端IPC通信端口，需手动触发监听初始化，否则即使配置完成也无法接收新消息。
1、返回Claw Settings → QQ Desktop主界面，找到Start Message Listener按钮。
2、点击后系统将弹出Windows/macOS系统级权限请求（需允许辅助功能访问）。
3、在系统弹窗中点击允许，随后WorkBuddy底部状态栏将显示QQ Listener: Active。
4、此时发送一条测试消息至任意已授权QQ会话，观察WorkBuddy主界面右下角是否弹出新消息通知卡片。
五、验证同步结果与故障排查
同步状态需通过多维度交叉验证，避免因缓存延迟或UI渲染异常造成误判。
1、在WorkBuddy主界面左上角搜索框输入qq:（英文冒号），查看是否列出最近同步的QQ会话条目。
2、点击任一会话条目，确认历史消息时间轴是否完整呈现，且最后一条消息时间距当前不超过90秒。
3、若消息仍不出现，打开Claw Settings → Diagnostics → QQ Connector，点击Run Health Check。
4、检查诊断报告中是否提示IPC Port Conflict (Error Code 0x8A3F)；如出现，需关闭腾讯会议、TIM等同源QQ系软件后再重试。
