解决 Windows 系统下 WorkBuddy 无法连接网络的问题

最常见的原因是agent.exe未真正运行，需通过任务管理器“详细信息”页搜索确认进程是否存在，并用sc query WorkBuddyAgent检查服务状态是否为RUNNING；若失败，需排查服务注册路径、防火墙拦截、DNS解析异常或WinHTTP代理冲突。

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

WorkBuddy Agent 进程没起来，但系统没报错

Windows 下 WorkBuddy 无法连接，最常见的原因是 agent.exe 没有真正运行——它可能启动后几秒就静默退出，任务管理器里看不到，服务列表里也查不到。这不是网络问题，是进程托管失效。

检查方法：打开任务管理器 → 切换到「详细信息」页签 → 搜索 agent.exe；若无结果，说明进程未存活。

• 先确认是否已按官方方式注册为服务：执行 sc query WorkBuddyAgent，返回 STATE: 4 RUNNING 才算正常；若为 STOPPED 或报 1060 错误，说明服务未创建成功或路径错误
• 手动启动失败时，别直接双击 agent.exe——它不是 GUI 程序，必须以服务方式或带 --daemon 参数运行（但 Windows 不推荐后者）
• 注册服务时 binPath= 值里不能有空格未转义，例如 "C:\Program Files\WorkBuddy\agent.exe" 必须写成 "\"C:\Program Files\WorkBuddy\agent.exe\""，否则 sc create 会 silently 截断路径

防火墙/杀软拦截了 agent.exe 的出站连接

WorkBuddy Agent 默认使用 HTTPS 连接 workbuddy.codebuddy.cn，但 Windows Defender 防火墙或第三方安全软件可能把它当成未知程序，默认阻止出站流量，且不弹提示。

现象是：ping workbuddy.qq.com 能通，nslookup workbuddy.codebuddy.cn 也能解析，但 Agent 日志卡在 “connecting to gateway…” 无后续。

• 临时关闭 Windows Defender 防火墙测试：执行 netsh advfirewall set allprofiles state off，再启动服务看是否恢复（测试完记得开回来）
• 更稳妥做法：在「高级安全 Windows Defender 防火墙」中新建出站规则，针对 C:\Program Files\WorkBuddy\agent.exe 允许所有连接
• 某些国产杀软（如 360、腾讯电脑管家）会深度 hook 网络调用，即使加了白名单也可能拦截；可尝试右键杀软图标 → 「退出防护」再试

DNS 解析异常导致 agent 连不上认证网关

WorkBuddy 登录流程依赖多个域名：前端页面走 workbuddy.qq.com，后端通信走 workbuddy.codebuddy.cn，飞书集成还涉及 open.feishu.cn。任一环节 DNS 解析失败，都会表现为“无法连接”，但错误日志里往往只显示超时，不提 DNS。

Axiom

Axiom是一个浏览器扩展，用于自动化重复任务和web抓取。

下载

典型表现：nslookup workbuddy.codebuddy.cn 返回 *** Can't find workbuddy.codebuddy.cn: No response from server，而其他域名正常。

• 优先换 DNS 测试：执行 netsh interface ip set dns "以太网" static 119.29.29.29（换成腾讯 DNS），再试 nslookup
• 若仅 codebuddy.cn 域名解析失败，可能是本地 hosts 被污染，检查 C:\Windows\System32\drivers\etc\hosts 是否有该域名的错误映射行
• 注意：ipconfig /flushdns 对这种系统级 DNS 缓存无效，需配合 netsh interface ip delete arpcache 清 ARP 表，并重启 WorkBuddy 服务

代理设置冲突让 agent 绕不过企业网络策略

很多企业环境强制启用系统级 HTTP 代理（比如通过组策略下发 PAC 文件），而 WorkBuddy Agent 并不读取 Windows 的 IE 代理设置，也不会自动走系统代理——它会直连，结果被网关丢弃。

现象是：浏览器能登录 WorkBuddy 网页版，但桌面客户端/Agent 始终连不上；抓包发现 agent.exe 发出的 TLS 握手包根本没发出，或发出去后无响应。

• 检查当前代理状态：执行 netsh winhttp show proxy，若返回非 Direct access (no proxy server)，说明 WinHTTP 层有代理配置，而 agent 正是基于 WinHTTP 实现的
• 临时清除代理：执行 netsh winhttp reset proxy，然后 sc stop WorkBuddyAgent & sc start WorkBuddyAgent
• 若企业策略不允许清除代理，需联系 IT 部门将 *codebuddy.cn 和 *feishu.cn 加入代理豁免列表（Bypass list）

WorkBuddy 在 Windows 上的连接问题，90% 都卡在「进程没活下来」或「连出去的第一步就被拦住」。DNS 和代理这两项最容易被忽略——因为它们不影响浏览器，却足以让后台 agent 彻底失联。调试时别急着改配置，先用 sc query 和 netsh winhttp show proxy 看清真实状态。