GitHub (gh) 技能 通过官方 GitHub CLI (gh) 将 OpenClaw 连接到 GitHub 平台。安装后,你的 OpenClaw 智能体可以使用自然语言与仓库、Pull Request、Issue、Actions 工作流等进行交互。
这是 OpenClaw 生态系统中最受欢迎、功能最全面的技能之一。无论是处理 Issue、创建 PR,还是检查 CI 状态,GitHub 技能都能将多步骤的 Git 工作流转化为简单的对话。
典型工作流:
- 让 OpenClaw 查看你的待处理 PR。
- 智能体在后台运行 。
- 结果以可读的摘要形式返回 — 无需切换上下文。
在安装 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 指派给我,并添加 标签。"
智能体会执行 。
你: "从 分支向 创建一个 PR,标题为 ‘Add OAuth2 login’,并总结变更内容。"
智能体会使用 创建 PR,填写标题,并根据提交差异生成描述。
你: "总结 PR #128 中的变更。"
智能体会使用 获取差异,分析变更内容,并提供简洁的摘要,包括:
- 修改的文件及增删行数
- 关键逻辑变更
- 潜在问题或建议
你: " 分支上最近一次 Actions 运行的状态如何?"
智能体会检查 ,并报告运行是通过、失败还是仍在进行中 — 同时附上完整日志的链接。
GitHub 技能可以对你的仓库执行写操作。请遵循以下准则以确保安全:
- 使用最小权限。 仅授予你实际需要的令牌权限范围。如果只需读取仓库,可以跳过 权限。
- 尽可能使用 认证,而非长期有效的 PAT。CLI 会自动处理令牌刷新。
- 合并前先审查。 始终确认 PR 合并和破坏性操作。OpenClaw 默认会提示你确认。
- 定期轮换令牌。 如果使用 PAT,请设置过期时间并至少每 90 天轮换一次。
- 避免授予管理员权限。 和 权限范围很少需要。除非必要,否则不要授予。
- 审计活动。 定期检查 GitHub 审计日志,查看通过 API 执行的操作。
GitHub CLI 未安装或不在你的 PATH 中。
安装后,使用 进行认证。
你的令牌缺失、已过期或缺少所需权限范围。
- 运行 检查当前认证状态。
- 如果已过期,使用 重新认证。
- 如果使用 PAT,请在 github.com/settings/tokens 验证是否具有 权限。
你正在尝试访问你的令牌没有权限的仓库或组织。
- 检查你的令牌是否包含 权限范围。
- 确认你的 GitHub 账户有权访问目标仓库。
- 对于组织仓库,管理员可能需要在 Settings → Third-party access 中批准你的令牌。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/213484.html