OpenClaw Version Bug Hunter
作者: Initiated by Neo Shi and executed by 银月
许可证: MIT
👋 使用教程（人类友好）
你不需要记任何命令，直接用自然语言和你的 Agent 说话就行。
安装技能后，直接对你的 Agent 说：
| 你想说的 | Agent 会做的 |
|---|---|
| "帮我看看 2026.5.6 有没有什么 bug" | 自动跑脚本，输出分类报告 |
| "获取最新版本的稳定性报告" | 先查当前版本，再跑报告 |
| "升级前帮我查下 2026.5.7 的坑" | 跑报告 + 结合你的配置做升级评估 |
| "2026.5.6 和 2026.5.5 哪个更稳？" | 对比两个版本的 bug 报告 |
就这么简单。 不需要记脚本路径，不需要拼命令行，Agent 会搞定一切。
前置要求：GitHub CLI (gh) 必须已安装并认证。检查方法：
gh --version && gh auth status
🚀 命令行快速开始
如果你想直接调用脚本：
# 查询特定版本的 bug 报告
~/.openclaw/workspace/skills/openclaw-version-bug-hunter/scripts/bug-hunt.sh 2026.4.9
功能
此技能封装了 GitHub CLI (gh)，自动搜索并分类 OpenClaw 官方仓库中与特定版本相关的 issue 报告。
设计原则：脚本提供数据，Agent 做 contextual 评估。 脚本不做简单的阈值判断（因为 OpenClaw 永远有 actionable issue），Agent 应结合主人的实际配置（渠道/插件/运行时/Node版本/部署方式）判断哪些 bug 真正影响当前环境。
输出内容
- 🔴 Critical / 严重问题 - 导致崩溃、数据丢失、系统不稳定的 bug
- 🟠 Regression / 回归问题 - 之前版本正常，当前版本失效的功能
- 🟡 General Bugs / 一般问题 - 其他 bug 报告
- 📋 质量评估 - 每个 issue 的可行动性/重复/模糊度自动标记
- 📊 统计信息 - 未解决/已解决 issues 数量 + 质量分布
- ✅ 修复状态 - 已合并的修复 PR 列表
质量评估标记（内置，零 LLM 依赖）
| 标记 | 含义 | 判定逻辑 |
|---|---|---|
| ✅ actionable | 有足够信息可调查 | 复现步骤 + 错误信息 + 环境/代码引用 ≥ 4 分 |
| ⚡ partial | 部分信息 | 有错误消息但缺少复现步骤，2-3 分 |
| ❓ needs info | 缺少关键信息 | 无复现步骤、无错误堆栈、无环境信息 |
| ⚠️ vague | 描述过于模糊 | 正文 < 50 字或缺乏技术关键词 |
| 🔁 dup of #N | 疑似重复 | 标题与同批次 issue 高度相似 |
严重程度判定规则
详细规则见 references/severity-rules.md（按需加载）。
快速参考：
- Critical: 崩溃、数据丢失、安全漏洞、无限循环
- Regression: 标记为
regression标签的 issue - General: 标记为
bug但非 critical/regression
使用场景
升级前避坑
# 在升级到 v2026.4.9 之前
bug-hunt.sh 2026.4.9
输出示例：
### 🔴 Critical / 严重问题
- #64745: macOS 2026.4.8 app causes infinite self-replication... [✅ actionable]
- #64812: Same replication loop issue... [🔁 dup of #64745]
- #65003: It crashes lol [⚠️ vague]
### 🟠 Regression / 回归问题
- #64552: Severe Performance Regression - 30-60 Second Delay... [✅ actionable]
- #64636: Version 2026.4.9 ignore the system environment proxy... [⚡ partial]
### 📋 质量评估
- 总 issue 数: 25
- ✅ actionable: 8
- ⚡ partial: 5
- ❓ needs info: 7
- ⚠️ vague: 3
- 🔁 duplicate: 2
### 📊 统计信息
- 未解决 issues: 25
- 已解决 issues: 8
---
💡 升级评估：请结合你的实际配置（渠道/插件/运行时/Node版本/部署方式）
比较两个版本
# 比较 v2026.4.8 和 v2026.4.9
bug-hunt.sh 2026.4.8
bug-hunt.sh 2026.4.9
检查当前版本的已知问题
# 先用 openclaw status 查看当前版本
openclaw status | grep "app"
# 然后查询该版本的 bug
bug-hunt.sh 2026.4.8
依赖
- GitHub CLI (
gh) - 必须已安装并认证 - Bash - 脚本运行环境
检查依赖
# 检查 gh 是否安装
gh --version
# 检查是否已认证
gh auth status
输出解读
脚本只提供结构化数据，不做简单的阈值判断。OpenClaw 是活跃项目，永远有 actionable issue，关键是哪些影响你的实际配置。
Agent 评估指南
当主人要求升级评估时，Agent 应结合以下维度做 contextual 判断：
| 配置维度 | 排查方向 |
|---|---|
| 使用的渠道 | 只关注对应渠道的 bug（飞书/Discord/微信等） |
| 启用的插件 | 关注相关插件的 bug（active-memory、codex 等） |
| 运行时 | Pi/Codex embedded — 关注对应 runtime 的 regression |
| Node 版本 | 关注特定 Node 版本的兼容性问题 |
| 部署方式 | 本机/容器 — 忽略无关部署的问题 |
| 当前版本 | 判断是否有新 regression 需要热修复 |
评估结论格式：
🟢 可以升级 — 与你的配置相关的 actionable issue 为 0
🟡 谨慎升级 — 发现 X 个影响你配置的问题：
- #N: 简述（影响你的 Y 功能）
🔴 暂缓升级 — 发现 Critical regression 影响核心功能：
- #N: 简述
高级用法
搜索特定标签
# 只搜索 regression
gh issue list --repo openclaw/openclaw --label regression --search "2026.4.9"
# 只搜索 Critical
gh issue list --repo openclaw/openclaw --label Critical --search "2026.4.9"
查看 issue 详情
gh issue view 64552 --comments
导出为 Markdown
bug-hunt.sh 2026.4.9 > bug-report-2026.4.9.md
限制
- 需要 gh CLI 认证 - 未认证用户无法访问 GitHub API
- API 速率限制 - 未认证用户每小时 60 次请求，认证后 5000 次
- 搜索精度 - 依赖 GitHub 搜索算法，可能遗漏未明确提及版本号的 issue
故障排查
问题：gh: command not found
解决：安装 GitHub CLI
# macOS
brew install gh
# 验证
gh --version
问题：gh: not authenticated
解决：认证 GitHub
gh auth login
问题：搜索结果太少
原因：issue 标题/正文未明确提及版本号
解决：手动搜索关键词
gh issue list --repo openclaw/openclaw --label bug --search "v2026.4.9 OR 2026.4.9 OR 2026.4.8"
相关文件
scripts/bug-hunt.sh- 核心搜索脚本references/severity-rules.md- 严重程度判定规则（详细版）
发布渠道
- ClawHub:
clawhub install openclaw-version-bug-hunter - GitHub: https://github.com/Suidge/openclaw-version-bug-hunter
银月注：此技能专为 OpenClaw 用户设计，帮助大家在升级前避开已知坑点～🌙