需依次完成五步验证:一、托盘图标、在线状态及文件列表响应;二、企微发“ping”收“pong+时间戳+主机名”;三、远程指令生成test-verify.txt并内容匹配;四、切换模型后“你是谁?”回复体现对应风格;五、终端确认workbuddy main、claw gateway、mcp server进程及8080端口监听正常。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您已完成WorkBuddy安装,但不确定各核心组件是否已正确加载并处于可工作状态,则需通过多维度本地验证确认其运行就绪。以下是验证此问题的步骤:
一、本地基础功能验证
该步骤用于确认 WorkBuddy 桌面客户端已正常启动、模型加载就绪、本地文件系统权限已授予,是后续远程调用与任务执行的前提条件。
1、启动 WorkBuddy 应用程序,观察右下角系统托盘是否出现蓝色鲸鱼图标。
2、点击托盘图标,确认主界面左上角显示“在线”状态及当前激活的模型名称(如混元、DeepSeek、wb-small-2024等)。
3、在主界面输入框中键入:“列出桌面最近3个文件”,按下回车,观察是否立即返回带时间戳和路径的真实文件列表。
4、若返回结果为空或提示“权限错误”,则需前往系统设置 → 安全性与隐私 → 文件访问权限,手动开启 WorkBuddy 对桌面、文档等目录的完全访问权限。
二、Claw 通道连通性验证
该步骤用于验证手机端通讯工具(企业微信/微信/飞书等)与本地 WorkBuddy 之间的双向通信链路是否建立成功,即 URL 回调能否被正确接收并响应。
1、打开企业微信(或微信/飞书/QQ/钉钉),进入已绑定的 WorkBuddy 机器人聊天窗口。
2、发送纯文本指令:“ping”(不带引号,全部小写)。
3、等待5秒内,检查是否收到含“pong + 时间戳 + 本地主机名”的结构化回复,例如:“pong 2026-04-12T11:28:05 workbuddy-win11”。
4、若超时无响应,需检查 Claw 设置中「企微 AIBot 集成」模块的Token 与 Encoding-AESKey是否与后台创建机器人时生成的一致,且 Webhook URL 已保存生效。
三、任务执行闭环验证
该步骤用于验证从自然语言理解、任务规划、沙箱执行到结果交付的完整 Agent 工作流是否可用,是部署成功的最终标志。
1、在企业微信/微信机器人对话中发送指令:“新建一个记事本文件,内容为‘验证成功’,保存到桌面,命名为test-verify.txt”。
2、观察 WorkBuddy 托盘图标是否短暂变为旋转状态,表示任务已进入执行队列。
3、10秒内检查桌面是否真实生成该文件,双击打开确认内容完全匹配。
4、若文件未生成,但收到“已计划执行”类提示,则说明MCP 服务未运行,需重启 WorkBuddy 并查看启动日志中是否包含“MCP server started on port 8080”字样。
四、多模型切换响应验证
该步骤用于确认内置多模型切换机制已加载就绪,避免因默认模型异常导致指令失败却误判为部署问题。
1、在 WorkBuddy 主界面左下角点击齿轮图标,进入「本地模型设置」。
2、在模型列表中依次点击不同模型(如 wb-small-2024、Qwen3.5、Gemma 4)右侧的“设为默认”按钮。
3、每次切换后,在输入框中键入:“你是谁?”,观察回复是否体现对应模型的语义风格与标识信息。
4、若某模型始终返回空响应或报错,检查其状态栏是否显示“下载中”或“加载失败”,必要时点击重新下载或清除模型缓存目录。
五、核心服务进程状态查询
该步骤用于直接检查 WorkBuddy 后台关键服务进程是否存在、端口是否监听、资源占用是否异常,适用于高级排障场景。
1、打开终端(macOS/Linux)或 PowerShell(Windows),执行命令:ps aux | grep -i workbuddy(macOS/Linux)或Get-Process | Where-Object {$_.ProcessName -like "*workbuddy*"} (Windows)。
2、确认输出中至少包含三个关键进程:WorkBuddy Main、Claw Gateway、MCP Server。
3、进一步验证端口监听状态:执行lsof -i :8080(macOS/Linux)或netstat -ano | findstr :8080(Windows),确认 PID 对应进程为MCP Server。
4、若任一进程缺失,尝试在 WorkBuddy 设置中关闭再启用「离线推理」或「Claw 远程控制」开关,触发服务重载。











