OpenClaw GitHub Assistant

🐙 代码托管智能助手

通过 GitHub API 管理仓库、检查 CI 状态、创建 Issue,适合开发者日常运维,需配置 Personal Access Token。

收藏
54.5k
安装
16.2k
版本
2.0.1
CLS 安全性认证2026-05-09
点击查看完整报告 >

使用说明

核心用法

GitHub Skill 提供一站式 GitHub 仓库管理能力,支持以下操作:

  • 仓库查询list_repos 列出仓库、get_repo 获取详情、search_repos 搜索仓库
  • CI/CD 监控check_ci_status 实时查看流水线状态
  • Issue 管理create_issue 快速创建问题工单
  • 活动追踪get_recent_activity 查看近期提交记录
  • 仓库创建create_repo 初始化新仓库

配置方式

支持环境变量(GITHUB_TOKENGITHUB_USERNAME)或 OpenClaw 配置文件(~/.openclaw/openclaw.json)两种方式认证,需生成具备 repopublic_repo scope 的 Personal Access Token。

显著优点

1. 原生集成:直接对接 GitHub REST API,无需额外工具链
2. 高效工作流:AI 对话中即可完成 Issue 创建、CI 状态检查,减少上下文切换

3. 灵活认证:支持环境变量与配置文件双模式,适配本地开发与生产部署

4. 权限可控:Token scope 最小化原则,可限定仅公开仓库或全仓库访问

5. 速率优势:认证后 5,000 请求/小时,满足团队级高频操作

潜在缺点与局限性

  • Token 管理负担:用户需自行生成、保管、轮换 PAT,存在泄漏风险
  • 功能边界:不支持 PR 合并、分支管理、代码审查等高级协作场景
  • 平台锁定:仅支持 GitHub,不兼容 GitLab、Gitee 等其他平台
  • 网络依赖:完全依赖 GitHub API 可用性,国内访问可能受网络波动影响

适合人群

  • 个人开发者:快速管理个人仓库、监控项目 CI 状态
  • 技术团队 TL:批量查看团队仓库活跃度、创建标准化 Issue
  • DevOps 工程师:集成到自动化工作流,辅助监控流水线健康度
  • 开源维护者:响应社区反馈时快速创建追踪 Issue

常规风险

| 风险类型 | 说明 | 缓释建议 |
|---------|------|---------|
| Token 泄漏 | PAT 写入 shell 配置文件或误提交至仓库 | 使用环境变量注入,配合 `.gitignore` 检查 |
| 权限过度 | 申请 `repo` scope 后 Token 可读写所有仓库 | 按需申请 `public_repo` 或细粒度 Fine-grained PAT |
| 速率耗尽 | 高频操作触发 5,000/hour 上限 | 实现指数退避重试,监控剩余配额 |
| 凭证残留 | 进程结束后 Token 仍存在于内存或日志 | 定期轮换 Token,启用 GitHub 的 Token 使用审计 |

安全解读

核心用法

该 Skill 通过 GitHub API 提供完整的仓库管理能力,涵盖 7 大核心功能:

  • 仓库管理list_repos 按语言/权限筛选仓库,get_repo 获取详情,create_repo 快速新建仓库
  • CI/CD 监控check_ci_status 实时查看 Actions 运行状态,适合 DevOps 场景
  • 协作工具create_issue 创建带标签/指派人的 Issue,get_recent_activity 追踪提交历史
  • 智能搜索search_repos 支持关键词检索个人仓库

配置方式灵活:环境变量(生产推荐)或 OpenClaw 配置文件(本地开发)。

显著优点

安全架构突出:纯原生实现,零第三方依赖,彻底消除供应链攻击风险;无危险函数(eval/exec),无敏感信息硬编码,静态代码分析得分 95/100。

通信安全可靠:仅与 api.github.com 通信,全链路 TLS 1.3 加密,动态行为分析 90 分,无异常网络活动。

权限最小化:仅需 reporead:user 两个 Scope,支持细粒度控制(public_repo 仅限公开仓库)。

开发者体验友好:自然语言交互设计,"Check CI status on my main project" 即可完成复杂查询。

潜在局限

  • 来源可信度:T3 级别(个人开发者维护),缺乏组织级安全审计和长期维护保障
  • 输入验证薄弱:仓库名等参数直接拼接 URL,存在潜在注入风险(GitHub API 会拦截,但客户端无预校验)
  • 错误处理简单:原始错误直接抛出,无分类重试机制,网络波动时体验不佳
  • 无速率保护:高频调用易触发 5,000/小时 的 API 限制

适合人群

  • 个人开发者:快速管理自己的开源/私有项目
  • 小型团队:无需复杂配置的轻量 CI 监控和 Issue 跟踪
  • 自动化工作流:结合 OpenClaw 实现 "语音/文字 → GitHub 操作" 的快捷指令

常规风险

| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 令牌泄露 | 中 | 需妥善保管 `GITHUB_TOKEN`,避免写入 shell 历史或提交到代码仓库 |
| 过度授权 | 低 | 建议按需选择 Scope,公开仓库仅需 `public_repo` |
| 供应链攻击 | 极低 | 零依赖架构,无 npm 包风险 |
| 作者失联 | 中 | 个人项目,建议 fork 后自行维护关键功能 |

使用建议:生产环境优先采用环境变量注入,配合 secrets manager;首次使用前建议审查 conorkennedy/openclaw-github-skill 仓库的提交历史和社区活跃度。

OpenClaw GitHub Assistant 内容

手动下载zip · 11.4 kB
api.d.tstext/plain
请选择文件