WorkBuddy 日志可通过文件系统、CLI 命令、GUI 面板及 OpenClaw 兼容模式四类方式查看：一、macOS 路径 ~/Library/Logs/WorkBuddy/，Windows 路径 %APPDATA%\WorkBuddy\logs\；二、CLI 执行 workbuddy log tail 实时监听；三、GUI 设置中「开发者选项→日志查看器」检索；四、OpenClaw 模式下访问 gateway 子目录专项日志。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 WorkBuddy 过程中遇到功能异常、任务失败或连接中断等问题，日志是定位根本原因的关键依据。WorkBuddy 将运行时关键事件、错误堆栈、技能执行详情等统一写入本地日志文件，可通过标准路径直接访问或配合命令行工具快速提取。以下是查看与分析 WorkBuddy 日志的具体方法：
一、通过文件系统直接访问日志目录
WorkBuddy 在 macOS 和 Windows 上均采用固定路径存储结构化日志，无需额外工具即可用文本编辑器打开查阅。该方式适用于快速浏览最近报错、确认服务启动状态或检查权限拒绝记录。
1、macOS 系统：打开访达（Finder），在菜单栏点击「前往」→「前往文件夹」，粘贴路径：~/Library/Logs/WorkBuddy/
2、Windows 系统：在文件资源管理器地址栏中直接输入：%APPDATA%\WorkBuddy\logs\
3、进入目录后，查找以日期命名的 .log 文件（如 2026-03-14.log）或名为 main.log 的主运行日志
4、双击用系统默认文本编辑器打开，按 Cmd+F（macOS）或 Ctrl+F（Windows）搜索关键词，例如 ERROR、failed、timeout
二、使用内置 CLI 命令实时查看日志流
WorkBuddy 提供命令行接口（CLI）支持动态监听日志输出，可避免手动刷新文件，特别适合调试企业微信连接、技能包加载或 Gateway 启动过程中的瞬时问题。
1、确保已安装并配置好 WorkBuddy CLI 工具（通常随主程序自动注册）
2、打开终端（macOS/Linux）或 PowerShell（Windows），执行：workbuddy log tail
3、如需仅显示错误级别日志，追加参数：workbuddy log tail --level error
4、若需查看最近 100 行历史日志而非实时流，执行：workbuddy log show --lines 100
监控 OpenClaw GitHub 版本更新，获取最新版本发布说明，翻译成中文， 并推送到 Telegram 和 Feishu。用于：(1) 定时检查版本更新 (2) 推送版本更新通知 (3) 生成中文版发布说明
三、通过 GUI 内置日志面板快速检索
WorkBuddy 桌面客户端集成了轻量级日志查看器，支持关键词高亮、时间筛选与导出功能，无需切换外部工具即可完成初步排查。
1、点击主界面左下角齿轮图标，进入「设置」
2、在左侧导航栏选择「开发者选项」→「日志查看器」
3、点击「刷新日志列表」按钮，加载当前可用日志文件
4、在搜索框中输入目标关键词（如 Feishu、openclaw health、skill install），匹配结果将自动高亮显示
5、勾选「仅显示错误」复选框，过滤掉 info 和 debug 级别日志，聚焦异常上下文
四、结合 OpenClaw 兼容模式查看网关专项日志
当 WorkBuddy 作为 OpenClaw 兼容网关运行时，部分底层通信、频道连接及模型调用细节会单独写入 Gateway 子目录，需针对性访问以定位集成类故障。
1、在 macOS 上，进入：~/Library/Logs/WorkBuddy/gateway/
2、在 Windows 上，进入：%APPDATA%\WorkBuddy\logs\gateway\
3、查找包含 gateway.log 或 channel-feishu.log 等命名的文件
4、重点检查日志末尾是否存在 Connection refused、Invalid App ID、Webhook timeout 等典型错误标识
