定位模型异常需分四层查日志：① ClawEngine底层日志（claw-engine.log）查CUDA或模型损坏；② WorkBuddy主进程日志（RemoteAgentDeployerUpdater_Log.txt）查调度失败；③ Docker容器内模型服务日志查路径或显存问题；④ API调用获取结构化错误事件用于批量分析。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在WorkBuddy中遇到模型加载失败、推理卡顿或返回UnknownError等异常时，必须定位到模型运行阶段产生的错误日志才能判断是ClawEngine崩溃、CUDA版本不匹配，还是模型文件损坏。这些日志分散在多个位置，需按执行层级逐层排查。
查看ClawEngine底层引擎日志
模型实际由ClawEngine加载和执行，其独立进程的日志不经过WorkBuddy主程序上报，必须直接读取。
第一步：打开终端（Windows用PowerShell，macOS/Linux用Terminal），执行ps aux | grep ClawEngine（macOS/Linux）或tasklist /fi "imagename eq ClawEngine.exe"（Windows），确认进程正在运行。
第二步：进入WorkBuddy安装目录下的engine/子目录，找到claw-engine.log文件——该文件记录GPU初始化、模型解析、Tensor内存分配等底层动作，【UnknownError几乎总在此文件中出现第一行堆栈】。
第三步：若文件为空或不存在，说明ClawEngine未成功启动。此时需手动运行ClawEngine --health-check，观察控制台是否输出JSON健康状态；若报错“CUDA driver version is insufficient”，则跳转至GPU驱动检查步骤。
定位WorkBuddy主进程中的模型相关日志
WorkBuddy自身会记录模型调度请求、参数传递、超时重试等外围行为，适用于判断是否调用失败而非模型内部错误。
方法一：通过GUI快捷入口
点击右上角头像 →「系统设置」→「诊断与日志」页签 → 点击「打开日志目录」→ 在弹出文件夹中查找RemoteAgentDeployerUpdater_Log.txt → 用VS Code或记事本打开 → 按Ctrl+F搜索model_load、inference_timeout或任务ID。
方法二：使用CLI实时过滤
在终端中执行：workbuddy log tail --pattern "model.*fail|load.*error|inference.*exception" → 日志流将高亮匹配行，避免人工扫视海量INFO日志。
注意：此方式仅捕获WorkBuddy主线程发出的指令日志，无法反映ClawEngine内部OOM或CUDA kernel launch失败。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
检查容器内模型服务日志（Docker部署场景）
若WorkBuddy以Docker容器方式运行，且模型服务被隔离为独立容器（如Triton Server），则错误日志不在宿主机路径中。
1、执行docker ps | grep -E "(claw|triton|vllm)"，找出模型服务容器ID。
2、运行docker exec -it <CONTAINER_ID> sh进入容器。
3、切换至日志目录：cd /var/log/claw-engine/ 或 cd /tmp/triton_logs/（取决于镜像配置）。
4、执行tail -n 50 claw-startup.log，重点查看是否含Failed to load model 'xxx': NOT_FOUND或cudaErrorMemoryAllocation——前者说明模型路径配置错误，后者表明GPU显存不足。
调用API获取结构化模型错误事件
适用于已接入监控平台或需批量分析多台机器模型故障的运维人员，能绕过文件权限限制直接拉取带时间戳和trace_id的原始错误。
① 获取有效JWT Token：从WorkBuddy控制台「开发者中心」→「API凭证」页面复制Token。
② 构造curl请求：curl -H "Authorization: Bearer YOUR_JWT_TOKEN" "https://wb-api.example.com/api/v1/logs?service=model-loader&level=ERROR&since=2026-07-27T00:00:00Z&limit=50"。
③ 响应体中每条JSON记录包含"error_code"字段（如"MODEL_LOAD_FAILED"）和"stack_trace"完整堆栈，可直接用于根因分类统计。
