3条命令跑通gbrain：个人AI助手搭建到上手
【免费下载链接】gbrainGarry's Opinionated OpenClaw/Hermes Agent Brain项目地址: https://gitcode.com/gh_mirrors/gb/gbrain
你刚搭了个人AI助手，文档喂了一半，却说不清它到底能不能跑？这篇 gbrain 入门教程带你走一遍：从装好环境，到让它搜得准、答得聪明，最后带走一份长期运行清单。看完，你就能独立完成 gbrain 安装并让知识库真正可用。
🧰 环境还没配好？先花1分钟自检
- 确认 Bun 可用。gbrain 跑在 Bun 上，先检查：
bun --version有版本号输出就行；没有的话，先去 Bun 官网装上运行时，再继续。
- 克隆仓库。把 gbrain 源码拉到本地：
git clone https://gitcode.com/gh_mirrors/gb/gbrain- 装依赖。进入刚克隆出的 gbrain 目录后执行：
bun install这一步拉取项目声明的全部依赖。三步都无报错，你的 gbrain 环境才算就绪。
🚀 3条命令，先让它跑起来
一条 init 命令，本地数据库就位
在项目目录执行：
gbrain init它会自动建好本地 PGLite 数据库——Postgres 17.5 的 WASM 版，无需服务器、无需订阅，连 pgvector 扩展都帮你建好。如果知识库超过约 1000 个 Markdown 文件，init 会建议你改用 Supabase 获得更好性能；也可以用标志显式指定：
gbrain init --pglite gbrain init --supabase前者锁定本地 WASM 引擎，后者直连云端数据库。百来篇文档的体量，选--pglite最省心；团队共享或千页以上，直接上--supabase。
用 doctor 做个体检
init 完马上执行：
gbrain doctor这条命令会逐项检查 pgvector 扩展、RLS 策略、模式版本、嵌入覆盖率和连接状态。全部通过，说明地基是稳的，再往里灌数据才不踩坑。哪项不过，它也会直接告诉你过不了的原因，照着提示修比盲目重装快得多。
📥 你的文档，怎么喂给它
分两步：先导入，再建向量。导入时指定文档路径，并加--no-embed暂时跳过嵌入：
gbrain import /path/to/your/documents --no-embed路径可以指向整个目录，目录里的 Markdown 会被批量读入。为什么先不嵌入？嵌入耗时耗钱，导入阶段全量跑一遍容易浪费时间。等文档都进库了，再统一重建：
gbrain embed --stale--stale只处理"过期"文档——内容自上次嵌入后有变化的那部分。首次是全量，之后每次只补变化的部分，越用越省。
🔍 怎么让它回答得更聪明
先搜一个你确定写在文档里的东西：
gbrain search "关键词" --limit 3--limit控制返回条数，先用 3 条快速确认搜索是否对路。纯关键词检索不需要任何 API key，装完就能用。命中偏了，多半是嵌入没覆盖到，回到上一步补一次embed --stale。
想语音交互的话，gbrain 提供 HD Voice，底层走 WebRTC，并用 RNNNoise 做降噪。界面里可以切两种模式：Auto (VAD) 自动检测你开口说话，Push-to-Talk 则是经典的按键说话，降噪开关也能随时启用：
📈 数据涨了、能力要扩，怎么办
数据量上来后 PGLite 不够用，就迁去 Supabase：
gbrain migrate --to supabase哪天想回本地，方向反过来同样成立：
gbrain migrate --to pglite迁移是双向的，历史数据跟着一起搬，引擎切换不必推倒重来。迁过去后跑一遍 doctor 确认连接健康，就可以继续日常操作了。想让助手接上外部服务，先看手里有哪些牌：
gbrain integrations list邮箱、日历这类服务接好后，助手能自动获取这些来源的新信息，并入自己的知识库，而不需要你手动复制粘贴。集成细节可参考 docs/guides/ 目录里的指南。
🧾 长期运行清单
| 事项 | 命令 | 说明 |
|---|---|---|
| 同步数据 | gbrain sync --no-pull --no-embed | 只对齐文档状态，不拉远端、不重建向量 |
| 后台补嵌入 | nohup gbrain embed --stale > /tmp/gbrain-embed.log 2>&1 & | 完成后tail -f /tmp/gbrain-embed.log看进度 |
| 自动化监控 | gbrain doctor --json | JSON 输出，可接定时任务，异常即告警 |
嵌入这步建议丢到后台跑，跑完记得看一眼日志确认没有报错。三项定期做，你的个人AI助手就能一直保持在可回答、可验证的状态。
装环境、初始化、体检、喂文档、搜索，这条 gbrain 入门路线到这里就闭环了。想继续配技能和自动化，去看 docs/guides/ 里的更多指南。
【免费下载链接】gbrainGarry's Opinionated OpenClaw/Hermes Agent Brain项目地址: https://gitcode.com/gh_mirrors/gb/gbrain
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
