OpenClaw GitHub (gh) 技能指南

OpenClaw GitHub (gh) 技能指南

GitHub (gh) 技能 通过官方 GitHub CLI (gh) 将 OpenClaw 连接到 GitHub 平台。安装后,你的 OpenClaw 智能体可以使用自然语言与仓库、Pull Request、Issue、Actions 工作流等进行交互。

这是 OpenClaw 生态系统中最受欢迎、功能最全面的技能之一。无论是处理 Issue、创建 PR,还是检查 CI 状态,GitHub 技能都能将多步骤的 Git 工作流转化为简单的对话。

典型工作流:

  1. 让 OpenClaw 查看你的待处理 PR。
  2. 智能体在后台运行 。
  3. 结果以可读的摘要形式返回 — 无需切换上下文。

在安装 GitHub 技能之前,请确保你已具备:

  • 已安装并运行 OpenClaw(v1.0+)
  • 已安装 GitHub CLI (gh) — 安装指南
  • 拥有 GitHub 账户 并有权访问你要管理的仓库
  • 已安装 clawhub CLI 用于技能管理

验证你的环境:

使用一条命令安装 GitHub 技能:

验证安装结果:

你应该能在已安装技能列表中看到 。

GitHub 技能需要个人访问令牌(PAT)或 GitHub CLI 认证。我们推荐使用 进行最简单的配置。

如果你更倾向于使用 PAT,请在 github.com/settings/tokens 创建一个具有以下权限的令牌:

| 权限范围 | 是否必需 | 用途 | |———|———|——| | | 是 | 完整的仓库访问权限 | | | 推荐 | 读取组织成员信息 | | | 可选 | 管理 GitHub Actions 工作流 | | | 可选 | 读取项目看板 | | | 可选 | 创建和管理 Gist |

重要提示: 切勿将令牌硬编码在配置文件中。请使用环境变量或密钥管理工具(如 1Password 或 Bitwarden)。

你: “显示主仓库中标记为 的待处理 Issue。”

智能体会运行相当于 的命令,并返回包含 Issue 编号、标题和指派人的格式化摘要。

你: “将 Issue #42 指派给我,并添加 标签。”

智能体会执行 。

openclaw skills 教程

你: “从 分支向 创建一个 PR,标题为 ‘Add OAuth2 login’,并总结变更内容。”

智能体会使用 创建 PR,填写标题,并根据提交差异生成描述。

你: “总结 PR #128 中的变更。”

智能体会使用 获取差异,分析变更内容,并提供简洁的摘要,包括:

  • 修改的文件及增删行数
  • 关键逻辑变更
  • 潜在问题或建议

你: ” 分支上最近一次 Actions 运行的状态如何?”

智能体会检查 ,并报告运行是通过、失败还是仍在进行中 — 同时附上完整日志的链接。

GitHub 技能可以对你的仓库执行写操作。请遵循以下准则以确保安全:

  • 使用最小权限。 仅授予你实际需要的令牌权限范围。如果只需读取仓库,可以跳过 权限。
  • 尽可能使用 认证,而非长期有效的 PAT。CLI 会自动处理令牌刷新。
  • 合并前先审查。 始终确认 PR 合并和破坏性操作。OpenClaw 默认会提示你确认。
  • 定期轮换令牌。 如果使用 PAT,请设置过期时间并至少每 90 天轮换一次。
  • 避免授予管理员权限。 和 权限范围很少需要。除非必要,否则不要授予。
  • 审计活动。 定期检查 GitHub 审计日志,查看通过 API 执行的操作。

GitHub CLI 未安装或不在你的 PATH 中。

安装后,使用 进行认证。

你的令牌缺失、已过期或缺少所需权限范围。

  1. 运行 检查当前认证状态。
  2. 如果已过期,使用 重新认证。
  3. 如果使用 PAT,请在 github.com/settings/tokens 验证是否具有 权限。

你正在尝试访问你的令牌没有权限的仓库或组织。

  1. 检查你的令牌是否包含 权限范围。
  2. 确认你的 GitHub 账户有权访问目标仓库。
  3. 对于组织仓库,管理员可能需要在 Settings → Third-party access 中批准你的令牌。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:Ai探索者,转载请注明出处:https://javaforall.net/255035.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月13日 下午12:29
下一篇 2026年3月13日 下午12:30


相关推荐

关注全栈程序员社区公众号