ToClaw任务实时监控需启用Web面板、CLI日志流、分级过滤、JSON导出及进程端口检查五种方法：1. 点击“监控”按钮访问http://127.0.0.1:18789/dashboard查看可视化进度；2. 用./toclaw logs --follow流式捕获原始日志；3. 用--level warn/error聚焦高危事件；4. 用--json --task-id导出结构化日志供分析；5. 通过ps aux | grep toclaw和lsof -i :18789确认服务与端口状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用ToClaw执行自动化任务时无法及时掌握当前进展或遇到异常中断，很可能是由于任务状态反馈通道未启用或日志输出未被正确捕获。以下是获取实时任务进度与完整日志的多种方法：
一、启用内置Web监控面板
该面板提供轻量级可视化界面，直接展示任务生命周期、执行阶段、耗时统计及错误摘要，无需额外安装依赖。
1、确保ToDesk客户端已更新至v2.1.0或更高版本，并完成账号登录。
2、在ToClaw主界面右上角点击“监控”按钮，系统将自动启动本地Express服务并跳转至http://127.0.0.1:18789/dashboard。
3、页面加载后，查看“Running Tasks”区域中最新任务卡片，其中状态色块、进度条、已用时间戳均为实时刷新。
4、点击任一任务卡片，展开详情页，在“Execution Timeline”中可查看按秒粒度标记的各子步骤起止时间。
二、通过CLI命令流式捕获日志
ToClaw CLI内置日志流机制，可绕过图形界面直接获取原始运行时输出，适用于调试卡死、无响应等静默故障场景。
1、打开终端，切换至ToClaw安装目录下的bin子目录（Windows为toclaw.exe所在路径，macOS/Linux为./toclaw）。
2、执行命令：./toclaw logs --follow（macOS/Linux）或toclaw.exe logs --follow（Windows）。
3、日志将按时间顺序持续滚动，每条记录包含[TASK-ID]、[STEP]、[LEVEL]、[TIMESTAMP]四要素。
4、当任务进入关键节点（如文件扫描、跨设备调用、模型推理）时，对应日志行会以[INFO] STEP_STARTED或[DEBUG] TOOL_INVOKED前缀标识。
三、过滤高优先级事件日志
面对高频日志输出，需聚焦警告与错误信号以快速定位阻塞点，避免人工筛查海量INFO级别信息。
1、在终端中执行：./toclaw logs --level warn，仅显示WARN及以上等级日志。
2、若任务已失败，改用：./toclaw logs --level error --tail 50，获取最近50条ERROR日志。
3、重点关注含"timeout"、"connection refused"、"device offline"关键词的日志行。
4、对跨设备任务，检查是否出现"auth_failed_on_remote"或"permission_denied_by_toDesk"提示。
四、导出结构化JSON日志用于分析
JSON格式日志支持程序化解析，便于提取特定任务ID的完整执行链、工具调用序列或资源消耗峰值。
1、执行命令：./toclaw logs --json --task-id "TASK-20260417-082231"，精确拉取单次任务全量日志。
2、配合jq工具筛选模型推理环节：./toclaw logs --json | jq 'select(.event == "llm_call")'。
3、提取所有设备操作记录：./toclaw logs --json | jq 'select(.tool == "remote_control")'。
4、导出至文件供离线审查：./toclaw logs --json --since "2026-04-17T14:00:00Z" > task_debug.json。
五、检查ToClaw运行时进程与端口占用
当Web面板无法访问或CLI日志无输出时，需确认ToClaw核心服务是否处于活跃监听状态。
1、执行命令：ps aux | grep toclaw（macOS/Linux）或tasklist | findstr toclaw（Windows），确认主进程存在且状态为RUNNING。
2、检查18789端口是否被占用：lsof -i :18789（macOS/Linux）或netstat -ano | findstr :18789（Windows）。
3、若端口被占，修改配置文件~/.toclaw/config.json中的"dashboard.port"字段为其他可用端口（如18790）。
4、重启ToClaw客户端，使新端口配置生效，再访问http://127.0.0.1:18790/dashboard验证连通性。
