🐙 OpenClaw GitHub Skill 完全教程

📅 2026-06-14 ⏱️ 阅读约12分钟 🏷️ GitHub, AI Agent, 自动化

一句话总结:OpenClaw 的 GitHub Skill 让你的 AI Agent 直接操作 GitHub —— 创建仓库、管理 Issues、审查 PR、监控 Trending,全部通过自然语言完成。

🎯 什么是 GitHub Skill?

GitHub Skill 是 OpenClaw 官方内置的 Skills 之一,它通过 GitHub CLI (gh) 和 GitHub REST API,让你的 AI Agent 能够直接与 GitHub 交互。你不再需要记住复杂的命令行参数,只需要用自然语言告诉 Agent 你想做什么。

核心能力一览

功能说明示例指令
仓库管理创建/搜索/克隆仓库"帮我创建一个名为 my-project 的仓库"
Issues 管理创建/查看/关闭 Issues"看看 my-project 有什么未关闭的 Issue"
PR 管理创建/审查/合并 PR"审查一下最新的 PR,看看有没有安全问题"
代码搜索搜索代码片段"在 GitHub 上搜索 OpenClaw 相关的 MCP 配置"
Trending 监控追踪热门项目"今天 GitHub Trending 上有什么 AI 相关项目?"

⚙️ 安装与配置

前置条件

Step 1: 安装 GitHub CLI

# macOS
brew install gh

# Ubuntu/Debian
sudo apt install gh

# Windows
winget install GitHub.cli

Step 2: 认证 GitHub

# 登录 GitHub(会自动打开浏览器)
gh auth login

# 验证认证状态
gh auth status

Step 3: 在 OpenClaw 中启用

GitHub Skill 是 OpenClaw 内置的 Skills,通常无需额外安装。如果你使用的是自定义配置,确保 openclaw.json 中包含:

{
  "skills": {
    "github": {
      "enabled": true
    }
  }
}
💡 妙趣提示:如果你需要更高的 API 速率限制,建议设置 GitHub Personal Access Token:
export GITHUB_TOKEN=ghp_xxxxxxxxxxxx

🔧 核心功能详解

1. 仓库操作

# 自然语言指令示例
"帮我创建一个公开仓库叫 awesome-ai-tools,描述写 'A curated list of AI tools'"

# Agent 实际执行
gh repo create awesome-ai-tools --public --description "A curated list of AI tools"

2. Issue 管理

# 查看 Issues
"看看 openclaw/openclaw 仓库最近有什么 Bug 报告"

# 创建 Issue
"在 my-project 里创建一个 Issue,标题是 '添加中文文档支持',标签用 enhancement"

3. PR 审查

# Agent 会自动:
# 1. 获取 PR 详情
# 2. 分析代码变更
# 3. 检查潜在问题
# 4. 给出审查意见

"审查 my-project 的 #42 号 PR,重点关注安全问题"

4. Trending 监控

# 获取热门项目
"今天 GitHub Trending 上有哪些 Python 项目?"

# Agent 会爬取 GitHub Trending 页面并整理成表格

🧪 5个实战案例

案例1:自动化 Issue 分类

让 AI Agent 定期扫描仓库的 Issues,自动打标签和分类:

"扫描 my-project 的所有未分类 Issue,根据内容自动打上 bug/enhancement/documentation 标签"

案例2:PR 安全审查

在合并 PR 前进行安全检查:

"对 my-project 的最新 PR 进行安全审查,检查是否有:
1. 硬编码的密钥或密码
2. SQL 注入风险
3. 不安全的依赖版本
4. 敏感信息泄露"

案例3:开源项目分析

分析竞品或感兴趣的开源项目:

"分析 anthropics/anthropic-sdk-python 这个仓库:
- 最近一个月的 commit 频率
- 主要贡献者
- 最受欢迎的 PR
- 使用的编程语言比例"

案例4:自动创建 Release

基于 git 历史自动生成 Release Notes:

"根据最近的 commit 历史,帮我生成 v2.0.0 的 Release Notes,按功能/修复/文档分类"

案例5:多仓库批量操作

同时管理多个仓库:

"检查我所有仓库(gh repo list --limit 50),找出过去3个月没有更新的仓库,列出清单"

📌 最佳实践

🔑 安全建议:
⚠️ 注意事项:

❓ 常见问题

Q: gh auth login 失败怎么办?

尝试使用 Token 方式登录:gh auth login --with-token < token.txt

Q: 如何提高 API 速率限制?

设置 GITHUB_TOKEN 环境变量,或使用 GitHub App 的 Installation Token。

Q: Agent 能直接 push 代码吗?

可以,但建议先让 Agent 生成变更预览,确认后再执行。安全起见,推荐使用 PR 流程。

📚 推荐阅读

→ ClawHub 技能市场完全指南(66,500+ Skills 怎么选) → MCP 服务器安全审计:16项检查清单 → OpenClaw Auto Mode 安全执行指南 → MCP 协议入门百科 → AI Agent 是什么?通俗解释 → 踩坑实录:我用 AI 管理 GitHub 的那些事