OpenClaw GitHub 指南

OpenClaw 与 GitHub issues、仓库和工程工作流的实用平台指南。
2026/03/12

OpenClaw GitHub 指南

GitHub 是杠杆最高的 OpenClaw 平台之一,因为它把助手直接连到了真实工程工作中。这个页面教你怎么搭建以及能用它做什么。


开始之前

请先确认基本安装已经跑通:

你还应该已经连接了一个 channel(Discord 或 Telegram),这样助手才能把输出发到你能看到的地方。


第一步:创建 GitHub personal access token

  1. 前往 GitHub → Settings → Developer settings → Personal access tokens
  2. 生成一个新 token(classic),勾选以下权限:
    • repo(如果需要访问私有仓库)
    • public_repo(如果只用公开仓库)
    • read:org(如果需要组织级可见性)
  3. 复制 token

对于只读工作流(推荐第一天只用这个),你只需要读权限。在只读工作流跑通之前,不要给写权限。


第二步:添加 GitHub 配置到 OpenClaw

在 workspace 配置中添加 GitHub 配置:

{
  "integrations": {
    "github": {
      "token": "你的-github-token",
      "repos": [
        "owner/repo-name"
      ]
    }
  }
}

先从一个仓库开始。不要第一天就把整个 GitHub 账号加进去。


第三步:选一个 GitHub 工作流开始

从以下选项中选一个:

方案 A:每日 issue 摘要

每天早上,助手汇总仓库中的新 issue 并发送摘要到你的 channel。适合想保持了解但不想一直盯着 GitHub 的维护者。

方案 B:issue 分类助手

当新 issue 创建时,助手读取内容,识别缺失的上下文,并起草澄清回复。适合 issue 量大的项目。

方案 C:仓库健康检查

按计划检查是否有陈旧的 PR、未标记的 issue 或缺失的标签,并报告结果。适合保持仓库整洁。

第一天不要三个都跑。选一个验证。


第四步:测试和验证

配置完成后:

  1. 重启 Gateway
  2. 触发工作流(或等待计划时间)
  3. 检查助手是否正确读取了 GitHub 数据
  4. 检查输出是否出现在你的投递 channel 中

常见问题:

  • 401 错误:token 无效或过期
  • 结果为空:仓库名错误或 token 没有访问权限
  • 没有输出:投递 channel 没有配置

好的第一个工作流

从低风险、适合审核的工作流开始:

  • 每天早上汇总新 issue
  • 标记等待维护者的项目
  • 按主题分组 issue
  • 生成简短的每周仓库摘要

第一天不要做的事

  • 自动关闭 issue
  • 到处自动评论
  • 在只读工作流有用之前就把写操作设为默认

第一个 GitHub 工作流应该先改善可见性,再考虑自动化操作。


接下来该看什么