🐙 GitHub 深度集成

代码协作 · 仓库管理 · DevOps

将全球最大的代码托管平台变作 AI 智能体的作战指挥室！赋予大模型直接查阅仓库代码、自动创建 Issue 与 Pull Request、管理 CI/CD 管线以及进行代码审查的全栈能力。

OpenClaw Team

🚀 快速安装

在您的终端中执行以下命令即可完成安装：

npx clawhub install github

📊 数据总览

⭐ 收藏点赞	☁️ 总计调用	👥 当前活跃	🎯 稳定版本
2.1k	156w	15,600	v3.2.0

🎛️ 详解：它是如何运转的？

本技能是 OpenClaw 生态中连接 AI 与软件工程基础设施的核心纽带。接入 GitHub REST & GraphQL API 后，大模型获得了对整个开发生命周期进行全程介入的能力：

📂 仓库深度穿透查阅：模型可遍历组织下全部仓库结构，按路径读取指定文件内容，解析 package.json、追溯 Git 提交历史与分支差异图谱，做到对项目代码库的全息感知。
🐛 Issue 智能创建与分拣：当 AI 在对话中发现潜在 Bug 或改进点，可直接创建结构清晰的 GitHub Issue 并自动标注标签（bug、enhancement、priority:high），省去开发者手动转写的繁琐环节。
🔀 Pull Request 自动化流水线：Agent 不仅能提交代码变更创建 PR，还能在描述中附上完整的变更摘要、关联 Issue 号，甚至自动 Request Review 指定的团队成员。
✅ CI/CD 管线状态监控：实时追踪 GitHub Actions 工作流的运行状态。当构建失败时，模型可直接拉取失败步骤的日志进行分析并给出修复建议。
👀 代码审查辅助：读取 PR 中的 diff 变更，基于上下文理解对代码质量、安全漏洞和性能隐患进行逐行标注式审查评论。

🧭 典型业务场景剖析

🤖 场景一：自动化 Bug 捕获与 Issue 归档

当 AI 在执行自动化测试链路时捕获到一个未预期的崩溃堆栈。模型会立即分析错误上下文，自动在对应仓库中创建一个格式规范的 Issue，附带完整的复现步骤、错误日志和环境信息，并标注为 bug + critical。

📝 场景二：智能代码审查助手

团队成员提交 PR 后，AI 自动收到 Webhook 通知。它会逐文件读取变更 diff，结合项目的编码规范（读取 .eslintrc 或 CONTRIBUTING.md），对每处可疑变更留下建设性的 review comment。

🚀 场景三：发版自动化编排

当 main 分支的所有 CI 检查通过后，Agent 可以自动创建 Release Tag、生成 Changelog（基于合并的 PR 标题）、触发部署管线，并将发版通知推送到 Slack 频道。

💻 常用命令参考

安装完成后，您不仅可以通过对话让 AI 自主调用，还可以在 CLI 侧手动发起操作：

查看指定仓库的最近提交记录：

clawhub execute github action="commits" repo="openclaw/core" limit=10

创建一个带有标签的 Issue：

clawhub execute github action="create-issue" repo="openclaw/core" \
  title="Fix: Memory leak in streaming module" \
  labels="bug,priority:high" \
  body="Detected during automated stress test..."

读取 PR 的 diff 变更并进行代码审查：

clawhub execute github action="review-pr" repo="openclaw/core" pr=42 \
  intent="Check for security vulnerabilities and performance issues"

查询 GitHub Actions 最近工作流运行状态：

clawhub execute github action="workflows" repo="openclaw/core" status="failure"

🛡️ 环境要求与鉴权预备

🔑 Personal Access Token：前往 GitHub Settings > Developer settings > Personal access tokens 创建一个拥有 repo、workflow、read:org 权限的细粒度令牌（Fine-grained token）。
⚙️ 环境变量注入：在终端预设：export GITHUB_TOKEN="ghp_xxxxxxxxxxxx"。
🔒 安全建议：切勿在公共仓库的 .env 文件中明文存储 Token。建议使用 GitHub Secrets 或本地加密密钥管理方案。

🔗 查看 GitHub 源代码