用途:管理本地 GitHub 知识库,并借由 gh CLI 提供 GitHub 搜索能力。当用户询问仓库、PR、Issue,或要求克隆 GitHub 项目时使用。
配置:使用前设置环境变量。GITHUB_TOKEN 为 GitHub 个人访问令牌(可选,用于私有仓库);GITHUB_KB_PATH 为本地知识库目录路径(默认 /home/node/clawd/github-kb)。令牌不得硬编码,应通过环境变量或容器密钥注入。
依赖:需安装并认证 GitHub CLI。安装如 macOS 用 brew install gh,Linux 用 apt install gh,Windows 用 winget install GitHub.cli;认证用 gh auth login 或 gh auth login --with-token <(echo "$GITHUB_TOKEN"),用 gh auth status 验证。若未安装或未认证,跳过搜索操作,仅使用本地知识库功能。
搜索能力: 搜索仓库:gh search repos <query> [--limit <n>],支持 language:、stars:、topic:、user:、org: 等限定符。 搜索 Issue:gh search issues <query> [--limit <n>],支持 repo:、state:、author:、label:、language:、comments: 等限定符。 搜索 PR:gh search prs <query> [--limit <n>],支持 repo:、state:、author:、label:、language:、is:merged|unmerged 等。 查看详情:gh issue view <number> --repo <owner/repo>(可加 --comments),gh pr view <number> --repo <owner/repo>。
本地知识库流程:查阅 GITHUB_KB.md 了解已有项目;在 ${GITHUB_KB_PATH:-/home/node/clawd/github-kb}/ 下定位项目目录;未知完整仓库名时先搜索;克隆命令为 git clone https://github.com/<owner>/<name>.git ${GITHUB_KB_PATH:-/home/node/clawd/github-kb}/<name>;阅读 README 或关键文件生成描述;按既有格式更新 GITHUB_KB.md 条目并告知用户。未指定目录时默认克隆至该知识库路径。
限制:资料未提供除上述外的收费、价格、平台与效果信息;依赖 gh 的可用性与认证状态,隐私上禁止硬编码令牌。