适用于 Openclaw 的 GitHub CLI

一种高性能的 Openclaw Skills 集成,用于通过 gh CLI 执行 PR 检查、运行程序日志和自定义 API 查询等 GitHub 操作。

khurramjamil12
v1.0.0
2026年6月16日
0
510
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install github-1

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 github-1。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 GitHub CLI?

GitHub CLI skill 使您的 AI 编码助手无需离开终端即可直接与 GitHub 仓库交互。通过利用官方 gh CLI 工具,该技能可实现对 pull requests、issues 和 GitHub Actions 工作流运行的无缝管理。它充当了自动化开发流水线的桥梁,用于检查 CI 状态和获取仓库元数据,这些都是现代 Openclaw Skills 配置的基本能力。

无论是在本地 git 仓库中运行,还是通过明确指定目标仓库执行远程查询,该技能都提供了一个强大的、以命令行优先的接口。开发者和自动化代理可以执行复杂查询,使用自定义 JSON/jq 选择器过滤输出,并实时调试 CI/CD 故障,从而简化整个软件开发生命周期。

GitHub CLI 应用场景

  • 检查特定 pull requests 的持续集成 (CI) 状态。
  • 监控、列出和调试失败的工作流运行和 actions 日志。
  • 使用高级 JQ 过滤直接从 GitHub API 查询复杂的仓库数据。
  • 通过自动化的 JSON 输出解析来管理和列出仓库 issues。
  • 在本地 git 上下文和远程多仓库设置中标准化开发工作流。

GitHub CLI 工作原理

  1. 命令初始化: 代理触发 GitHub CLI 命令(例如 gh pr、gh issue、gh run 或 gh api)。
  2. 上下文解析: 工具检查是否在本地 git 目录中运行;如果不是,则应用明确指定的 --repo owner/repo 标志。
  3. API 和 CLI 执行: 技能与 GitHub 后端通信以检索请求的资源或触发仓库事件。
  4. 输出解析和过滤: 技能利用结构化的 --json 格式和 --jq 过滤器来提取精确字段(例如 PR 状态或 issue 标题)。
  5. 结果交付: 将整洁、结构化的元数据或日志输出返回给调用代理或用户环境。

GitHub CLI 配置指南

前置条件

确保您在本地机器上安装并验证了官方 GitHub CLI (gh)。

# 安装 GitHub CLI (macOS 示例)
brew install gh

# 验证您的 GitHub 账户
gh auth login

启用技能

将 GitHub 技能配置添加到您的 Openclaw Skills 工作区设置中。配置完成后,您可以直接使用交互式命令:

# 通过查询仓库测试安装
gh repo view --repo owner/repo

GitHub CLI 数据架构与分类体系

结构化 JSON 输出模式

当在 Openclaw Skills 中使用 --json 和 --jq 标志时,基础数据结构直接与官方 GitHub API 负载模式对齐。以下是常见返回模式的细分:

命令类型 支持的关键字段 示例 JQ 查询
Pull Requests (gh pr) number, title, state, author .[] | .title
Workflow Runs (gh run) id, name, status, conclusion .workflow_runs[] | .id
Issues (gh issue) number, title, state, labels .[] | .title
GitHub API (gh api) 可自定义的动态负载 .title, .state

所有结构化查询响应都以 JSON 格式输出,便于自动化流水线提取。

GitHub CLI 高级特性

  • 精细的 CI/CD 故障排除: 在工作流运行视图上使用 --log-failed 标志,仅从失败的步骤中立即隔离和检索日志,减少带宽占用和屏幕噪音。
  • 直接 GitHub API 集成: 使用 gh api 绕过标准 CLI 限制,直接执行 REST 和 GraphQL 查询以检索复杂的仓库元数据。
  • 高级数据投影: 利用组合的 --json 和自定义 JQ 过滤器,直接在 CLI 内将嵌套的 API 响应转换为扁平、优化的格式。
  • 与上下文无关的执行: 支持显式的 --repo 标志覆盖,使自动化工作流能够跨多个远程仓库扩展,而无需进行物理 git 克隆。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*