核心用法
github-repos 是一套基于 ClawLink 托管集成的 GitHub 管理技能。用户需先安装 ClawLink 插件并完成设备配对,随后在 ClawLink 仪表板一键授权 GitHub 账户即可使用。所有工具通过 clawlink_list_tools 动态发现,支持仓库、Issue、PR、分支、提交、Release 及 GitHub Actions 工作流的查询与管理。
显著优点
- 零配置接入:无需生成 Personal Access Token 或处理 OAuth 回调,ClawLink 托管凭证流,降低配置门槛。
- 动态工具发现:工具列表实时同步用户权限与 ClawLink 目录更新,避免硬编码 schema 导致的版本错位。
- 操作安全护栏:所有写入操作需经
clawlink_preview_tool预览并用户确认,配合askBefore与safeDefaults机制,减少误操作风险。 - 开源可审计:ClawLink 源码公开(github.com/hith3sh/clawlink),支持本地验证托管逻辑。
潜在局限
- 外部依赖:功能可用性绑定 ClawLink 服务在线状态,若服务中断则工具失效。
- 权限边界:实际可执行操作受 GitHub OAuth Scope 及组织级权限策略限制,部分私有仓库或企业版功能可能不可用。
- 网络延迟:动态发现与预览调用增加往返次数,高频自动化场景下响应略慢于直连 API。
适合人群
- 希望快速在 AI 聊天中操作 GitHub、但不愿管理 API 凭证的开发者与项目经理;
- 团队协作场景下需要临时查询 PR 状态、创建 Issue 注释的非专职运维人员。
常规风险
- 凭证集中托管:GitHub Token 由 ClawLink 加密存储,存在第三方托管的固有信任假设;
- 权限过度申请:用户需留意 OAuth 授权范围,避免授予不必要的写权限;
- 预览漏确认:若用户跳过
clawlink_preview_tool直接确认,可能误删分支或合并 PR。
使用流程简述
1. 安装插件:openclaw plugins install clawhub:clawlink-plugin
2. 配对设备:调用 clawlink_begin_pairing → 用户浏览器批准 → clawlink_get_pairing_status
3. 连接账户:访问 claw-link.dev/dashboard?add=github 完成 GitHub 授权
4. 发现工具:clawlink_list_integrations → clawlink_list_tools github
5. 安全执行:读操作直接调用;写操作先 clawlink_describe_tool → clawlink_preview_tool → 用户确认 → clawlink_call_tool