📦 Gbrain Multi-Agent Search — 本地知识库搜索
v1.0.0搜索和管理本地 gbrain 个人知识库，支持全文搜索、语义搜索和知识图谱查询。适用于搜索个人笔记、邮件、文档、日记等存储在 gbrain 中的知识。
0· 26·0 当前·0 累计
by 安全扫描
OpenClaw
可疑
medium confidence该技能的指令要求使用 OpenAI 兼容的 embedding API 和本地 gbrain 仓库，但注册表元数据未声明这些凭据/路径，且附带的包装脚本硬编码了 ~/gbrain — 这些不一致之处需要谨慎对待。
评估建议
该技能将在你的本地仓库中运行 gbrain CLI，并在运行 embedding 命令时使用 OPENAI_API_KEY/OPENAI_BASE_URL 将你的笔记发送到外部 embedding API。在安装或使用之前：1) 验证并审查 gbrain 仓库代码（bun run src/cli.ts 执行该仓库的代码）。2) 注意注册表元数据省略了 SKILL.md 所需的环境变量 — 将 OPENAI_API_KEY 和 OPENAI_BASE_URL 视为必要的密钥并主动配置。3) 提供的包装脚本硬编码了 ~/gbrain（它忽略 GBRAIN_DIR）；如果你的仓库在其他位置，请更新它。4) 如果你不想将私人笔记上传到外部 embedding 服务，请不要运行 embed 命令或配置本地/私有 embedding 端点。能够提升信任度的其他信息：技能元数据明确声明所需的环境变量/主要凭据，以及包装脚本使用 GBRAIN_DIR 而不是硬编码路径，或者使用可信的 gbrain 上游仓库 URL。...详细分析 ▾
ℹ 用途与能力
声明的用途（搜索/管理本地 gbrain 知识库）与运行时指令一致：该技能运行 gbrain CLI 来搜索、查询、图形、同步和嵌入内容。要求提供 embedding API 密钥和本地仓库路径与该用途相符。然而，技能元数据未声明所需的环境变量或配置路径，而 SKILL.md 明确指示用户设置 GBRAIN_DIR、BRAIN_DIR、OPENAI_API_KEY 和 OPENAI_BASE_URL — 这种元数据/指令不匹配值得关注。
⚠ 指令范围
SKILL.md 指示智能体进入本地 gbrain 仓库并运行 'bun run src/cli.ts' 执行多种操作，并使用 OPENAI_API_KEY/OPENAI_BASE_URL 调用 embedding 端点。这些指令将导致本地文件（你的 brain markdown）被读取，并在运行 embed 时可能上传到 embedding API。没有指令级别请求读取无关的系统文件，但执行 gbrain CLI 的能力意味着该仓库中的任意代码将在你的环境中运行 — SKILL.md 没有指示智能体先验证 CLI 代码。另外，提供的包装脚本忽略 GBRAIN_DIR 环境变量并硬编码 ~/gbrain，这与文档中的配置相冲突。
✓ 安装机制
未包含安装规范；这只是带有小型辅助脚本的指令式技能。技能本身不会下载或写入任何内容 — 最高风险的安装模式不存在。
⚠ 凭证需求
运行时需要 embedding API 密钥和基础 URL（OPENAI_API_KEY、OPENAI_BASE_URL）来为本地内容生成 embedding，这对于此用例是合理的。然而，技能的注册表元数据未声明所需的环境变量或主要凭据，这是不一致的，可能会误导用户关于密钥的要求。技能不请求无关凭据，但用户必须意识到运行 'embed' 会将本地内容传输到配置的 embedding 服务。
✓ 持久化与权限
always 为 false，该技能不请求系统级配置或修改其他技能。没有请求提升的持久性。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.02026/4/16
初始版本：双语（EN/CN）gbrain CLI 包装器，用于多智能体知识库搜索
● Pending
安装命令
点击复制官方npx clawhub@latest install gbrain-multi-agent-search
镜像加速npx clawhub@latest install gbrain-multi-agent-search --registry https://cn.longxiaskill.com
技能文档
本地知识库，支持全文搜索、语义搜索和知识图谱。需要已安装 gbrain 并初始化 brain 仓库。
前置条件
- 已安装 gbrain CLI（在 gbrain 仓库中执行
bun install） - 有一个已同步 markdown 内容的 brain 仓库
- 已配置 Embedding API（OpenAI 兼容端点）
配置 / Configuration
设置这些变量或替换内联值：
| 变量 | 描述 | 示例 |
|---|---|---|
GBRAIN_DIR | gbrain 源代码仓库路径 | ~/gbrain |
BRAIN_DIR | brain 内容仓库路径 | ~/brain |
OPENAI_API_KEY | Embedding API 密钥 | sk-... |
OPENAI_BASE_URL | Embedding API 基础 URL | https://api.openai.com/v1 |
一行式设置（添加到 TOOLS.md）
export GBRAIN_DIR=~/gbrain
export BRAIN_DIR=~/brain
export OPENAI_API_KEY=your-key-here
export OPENAI_BASE_URL=https://api.openai.com/v1
alias gb="cd $GBRAIN_DIR && bun run src/cli.ts"
搜索 / Search
关键词搜索（快速、精确匹配）
cd $GBRAIN_DIR && bun run src/cli.ts search "" [--limit N]
适用场景：精确的人名、术语、文件名搜索。
语义搜索（混合，理解含义）
cd $GBRAIN_DIR && bun run src/cli.ts query "" [--limit N]
适用场景：自然语言提问、模糊概念、跨主题查询。
示例：
query "When did I join company X" / "什么时候加入的公司X"
query "Heart rate trends in 2024" / "2024年心率趋势"
query "Email about project approval" / "项目审批相关的邮件"
列出页面
cd $GBRAIN_DIR && bun run src/cli.ts list [--type source|person|concept|company|project|deal|media|civic] [--tag T] [-n N]
读取页面
cd $GBRAIN_DIR && bun run src/cli.ts get "" [--fuzzy]
使用 --fuzzy 进行模糊匹配。
知识图谱 / Knowledge Graph
创建关联
cd $GBRAIN_DIR && bun run src/cli.ts link "" "" [--link-type TYPE] [--context "description"]
遍历图谱
cd $GBRAIN_DIR && bun run src/cli.ts graph "" [--depth N]
常用关联类型
works_at, invested_in, related_to, wrote, attended, located_in, managed, friend_of, reported_to, parent_of, spouse_of
数据管理 / Data Management
导入与嵌入
# 从仓库同步 markdown 文件到 brain cd $GBRAIN_DIR && bun run src/cli.ts sync --repo $BRAIN_DIR --no-pull --no-embed --full
# 为新的/已更改的内容生成 embedding cd $GBRAIN_DIR && OPENAI_API_KEY=... OPENAI_BASE_URL=... bun run src/cli.ts embed --stale
统计信息
cd $GBRAIN_DIR && bun run src/cli.ts stats
健康检查
cd $GBRAIN_DIR && bun run src/cli.ts doctor
工作流程 / Workflow
添加新内容
- 将 markdown 文件添加到
$BRAIN_DIR/sources// git add && git commit- 运行
sync --full --no-pull --no-embed - 运行
embed --stale
典型搜索模式
- 先使用
search进行精确匹配 - 如果没有结果或需要更深入的理解，使用
query - 使用
get读取完整页面内容 - 使用
graph探索相关页面
提示 / Tips
search更快，query更智能 — 先使用search- 添加
--limit 5获取简洁结果 - 不确定 slug 时使用
--fuzzy - 大文件嵌入失败时（>64 个块），拆分为小文件
- 定期运行
stats检查知识库状态