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) 必须已安装并认证。检查方法：

bash

gh --version && gh auth status

---

🚀 命令行快速开始#

如果你想直接调用脚本：

bash

# 查询特定版本的 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 真正影响当前环境。

输出内容#

1. 🔴 Critical / 严重问题 - 导致崩溃、数据丢失、系统不稳定的 bug
2. 🟠 Regression / 回归问题 - 之前版本正常，当前版本失效的功能
3. 🟡 General Bugs / 一般问题 - 其他 bug 报告
4. 📋 质量评估 - 每个 issue 的可行动性/重复/模糊度自动标记
5. 📊 统计信息 - 未解决/已解决 issues 数量 + 质量分布
6. ✅ 修复状态 - 已合并的修复 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

使用场景#

升级前避坑#

bash

# 在升级到 v2026.4.9 之前
bug-hunt.sh 2026.4.9

输出示例：

text

### 🔴 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版本/部署方式）

比较两个版本#

bash

# 比较 v2026.4.8 和 v2026.4.9
bug-hunt.sh 2026.4.8
bug-hunt.sh 2026.4.9

检查当前版本的已知问题#

bash

# 先用 openclaw status 查看当前版本
openclaw status | grep "app"

# 然后查询该版本的 bug
bug-hunt.sh 2026.4.8

依赖#

• GitHub CLI ( gh) - 必须已安装并认证
• Bash - 脚本运行环境

检查依赖#

bash

# 检查 gh 是否安装
gh --version

# 检查是否已认证
gh auth status

输出解读#

脚本只提供 结构化数据，不做简单的阈值判断。OpenClaw 是活跃项目，永远有 actionable issue，关键是 哪些影响你的实际配置。

Agent 评估指南#

当主人要求升级评估时，Agent 应结合以下维度做 contextual 判断：

配置维度排查方向使用的渠道只关注对应渠道的 bug（飞书/Discord/微信等）启用的插件关注相关插件的 bug（active-memory、codex 等）运行时Pi/Codex embedded — 关注对应 runtime 的 regressionNode 版本关注特定 Node 版本的兼容性问题部署方式本机/容器 — 忽略无关部署的问题当前版本判断是否有新 regression 需要热修复

评估结论格式：

text

🟢 可以升级 — 与你的配置相关的 actionable issue 为 0
🟡 谨慎升级 — 发现 X 个影响你配置的问题：
   - #N: 简述（影响你的 Y 功能）
🔴 暂缓升级 — 发现 Critical regression 影响核心功能：
   - #N: 简述

高级用法#

搜索特定标签#

bash

# 只搜索 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 详情#

bash

gh issue view 64552 --comments

导出为 Markdown#

bash

bug-hunt.sh 2026.4.9 > bug-report-2026.4.9.md

限制#

1. 需要 gh CLI 认证 - 未认证用户无法访问 GitHub API
2. API 速率限制 - 未认证用户每小时 60 次请求，认证后 5000 次
3. 搜索精度 - 依赖 GitHub 搜索算法，可能遗漏未明确提及版本号的 issue

故障排查#

问题： gh: command not found#

解决：安装 GitHub CLI

bash

# macOS
brew install gh

# 验证
gh --version

问题： gh: not authenticated#

解决：认证 GitHub

bash

gh auth login

问题：搜索结果太少#

原因：issue 标题/正文未明确提及版本号

解决：手动搜索关键词

bash

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 用户设计，帮助大家在升级前避开已知坑点～🌙