- name
- github-bug-report
- description
- Submit bug reports to GitHub for OpenClaw issues. Use when: (1)发现了明确的bug并想提交给官方; (2)官方产品出现问题需要报障; (3)想查询现有issue状态; (4)需要跟进已提交issue的进展. Includes issue template, GitHub API workflow, and post-submission follow-up reminders via cron.
GitHub Bug Report
向 OpenClaw 官方仓库提交 bug report 的标准化流程。
核心原则
- 提交前先搜索是否有人已经报过同样的问题，避免重复
- 格式按官方建议：标题含版本号、步骤编号、预期 vs 实际结果分开
- 提交后用 cron 建跟进提醒，三天后 bump 一次
Issue 提交标准格式
标题格式：[版本号] Bug简述
内容必须包含：
## Bug Description
（清晰描述问题）
## Steps to Reproduce
1. 第一步
2. 第二步
3. 第三步
## Expected Behavior
（预期应该怎样）
## Actual Behavior
（实际出了什么岔子）
## Environment
- OS / 版本
- OpenClaw 版本
- Node 版本
- Model（如果是模型相关）
## Additional Context
（如有日志、截图、配置 JSON，贴在这里）快速提交流程
1. 提交新 issue
# 使用 scripts/submit_issue.py
python3 scripts/submit_issue.py --title "[v1.x.x] Bug标题" --body "内容"2. 提交后立即建 cron 跟进
提交成功后，用 cron 建一个 3 天后的提醒：
{
"name": "Bug跟进-#<issue号>",
"schedule": { "kind": "cron", "expr": "0 10 * * *", "tz": "Asia/Shanghai" },
"payload": {
"kind": "agentTurn",
"message": "检查 GitHub issue #<issue号> 是否有官方回复，如果没有，去 bump 一下（留言：Any update?）"
},
"sessionTarget": "isolated",
"delivery": { "mode": "announce" }
}3. 检查是否已有重复 issue
提交前先搜索：
curl -s "https://api.github.com/search/issues?q=checkpoint+orphan+repo:openclaw/openclaw" \
-H "Authorization: token $GITHUB_TOKEN"常用 GitHub API
| 操作 | API |
|---|---|
| 查 issue | GET /repos/openclaw/openclaw/issues/<number> |
| 搜 issue | GET /search/issues?q=关键词+repo:openclaw/openclaw |
| 建 issue | POST /repos/openclaw/openclaw/issues |
| 更新 issue | PATCH /repos/openclaw/openclaw/issues/<number> |
| 查 repo 信息 | GET /repos/openclaw/openclaw |
GitHub Token
当前 token：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
Header 格式：
Authorization: token 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
Accept: application/vnd.github+json
Content-Type: application/vnd.github+json相关文件
- 提交脚本：
scripts/submit_issue.py - 快速参考：
references/quick-ref.md