跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.ironclaw.com/llms.txt

Use this file to discover all available pages before exploring further.

GitHub 扩展允许智能体与 GitHub 仓库、议题、拉取请求等交互，非常适合自动化代码相关任务、管理项目或从 GitHub 收集信息。

​
设置

1

获取 API 密钥

要使用 GitHub 扩展，您需要从 GitHub 获取个人访问令牌。
2

安装 GitHub 扩展

在终端中运行以下命令安装 GitHub 扩展：
ironclaw registry install github
3

配置 API 密钥

安装扩展后，需要在 IronClaw 中配置您的 GitHub API 密钥。运行：
ironclaw tool auth github
然后按照提示输入您的 API 密钥。
请确保创建细粒度的个人访问令牌，仅授予用例所需的必要权限。如有疑问，选择最小权限选项，之后随时可以创建具有不同权限的新令牌。

​
可用操作：

以下是智能体使用 GitHub 扩展可以执行的一些操作：
  • get_repo：获取仓库信息
  • list_issues：列出仓库中的所有议题
  • create_issue：创建新议题
  • get_issue：获取特定议题的详细信息
  • list_pull_requests：列出拉取请求
  • get_pull_request：获取特定拉取请求的详细信息
  • get_pull_request_files：获取拉取请求中的文件列表
  • create_pr_review：提交拉取请求审查
  • list_repos：列出仓库（用户/组织）
  • get_file_content：获取仓库中文件的内容
  • trigger_workflow：手动触发 GitHub Actions 工作流
  • get_workflow_runs：列出最近的工作流运行

​
在公共仓库上工作

让我们为智能体配置自己的 GitHub 账户，以便它可以在公共仓库中创建议题和评论拉取请求。
1

创建新的 GitHub 账户

前往 https://github.com 为智能体创建新账户。如果您已使用个人账户登录，需要暂时登出以创建新账户，之后可以立即重新登录。
2

生成个人访问令牌

在智能体的 GitHub 账户上，前往 Settings -> Developer settings -> Personal access tokens -> Tokens (classic) 并生成具有以下权限的新令牌（classic）：repo -> public_repo
3

认证 GitHub 扩展

获取令牌后，运行以下命令认证 GitHub 扩展：
ironclaw tool auth github
然后按照提示输入刚生成的令牌。
4

测试一下！

让智能体在您的某个公共仓库中创建一个测试议题，检查议题是否创建成功。
让智能体阅读 GitHub Markdown 指南 并在创建议题和评论时记住这些格式规范，可以让格式更加美观！