Dbg

Name: Dbg
Rating: 3.5 (1 reviews)
Author: osen77

By osen77 👁 21 views ▲ 0 votes

OpenClaw debug trace plugin — human-friendly agent reply diagnostics with auto troubleshooting

GitHub

Install

openclaw plugins install ./openclaw-dbg

README

# openclaw-dbg

OpenClaw 调试追踪插件 — 用大白话展示 agent 每次回复的执行过程。

## 安装

```bash
# 从 GitHub 安装
git clone https://github.com/osen77/openclaw-dbg.git
openclaw plugins install ./openclaw-dbg

# 重启 gateway 生效
openclaw gateway restart
```

**前置要求**: Python 3.8+（macOS/Linux 自带）

## 命令

在任意聊天渠道中发送：

| 命令 | 说明 |
|------|------|
| `/dbg` | 查看最近一条回复的执行详情 |
| `/dbg count 5` | 列出最近 5 条回复摘要 |
| `/dbg 3` | 查看第 3 条的详情（序号对应 count 列表） |
| `/dbg ask` | 让 agent 自动排查当前查看的回复 |
| `/dbg ask 3` | 排查第 3 条 |
| `/dbg ask 原因是什么` | 排查并附带补充说明 |
| `/dbg ask 3 为什么出错` | 排查第 3 条并附带说明 |

## 输出示例

```
📨 最近回复 20:13 · feishu · MiniMax-M2.5 · 耗时1.6分钟
💬 "添加到单聊标签页上"
🆔 68d61276
---
🔧 执行步骤:
  1. ✅ 飞书操作 — lark chats --help (0.0s)
  2. ✅ 搜索网络 — "飞书 API 添加标签页" (8.1s)
  3. ❌ 调用API — POST /chat_tabs → 参数错误 (0.3s)
---
📊 共3步 · ✅2 ❌1 · 总耗时1.6分钟
---
💡 使用 /dbg ask 自动排查问题
```

## /dbg ask 排查流程

1. 先执行 `/dbg` 或 `/dbg N` 查看详情
2. 执行 `/dbg ask` — 插件将 trace 存入待注入文件
3. 发送任意消息（如"排查"）— agent 自动收到 trace 并分析
4. Agent 给出根因分析和编号改进方案，回复编号即可让 agent 执行

## 工具翻译表

插件将技术工具名翻译为中文（如 `exec` → "执行命令"，`web_search` → "搜索网络"）。

如果你添加了新的 skill 或工具，在 `scripts/dbg.py` 顶部的 `EXEC_PATTERNS` 和 `TOOL_LABELS` 中添加对应翻译，否则会显示原始技术名称。

## 工作原理

- `/dbg` 命令解析 OpenClaw JSONL 日志和 session 文件，提取工具调用链
- `/dbg ask` 将 trace 写入 `ask/{channel}.pending` 文件
- `before_prompt_build` hook 在下一次 agent turn 时读取 pending 文件并注入到 prompt，然后删除文件
- 每个渠道独立文件，互不干扰

tools