
GBrain 接入 Meta Muse 个人智能体持久化记忆的本地 CLI 集成指南【免费下载链接】gbrainGarrys Opinionated OpenClaw/Hermes Agent Brain项目地址: https://gitcode.com/gh_mirrors/gb/gbrain本文以 GBrain 官方指南 docs/guides/muse.md 为核心骨架讲解如何将 GBrain 的本地 CLI 安装到 Meta Muse 个人智能体personal agent的持久化用户文件区域实现显式记忆写入remember与回忆recall并给出无 API Key 的启动路径、宿主化大脑的瘦客户端复用方式、维护/备份/恢复流程以及验收清单。读完本文你将掌握在 Muse 这类自带哨兵Sentinel管控的智能体环境中如何合规地建立一条不触碰连接器凭据、可验证、可修复、可备份恢复的持久记忆通道。Muse Code 是另一款产品请勿混淆Meta 旗下存在两个容易混淆的产品实体Muse 个人智能体本指南的对象与Muse Code面向开发的 MCP 客户端。二者能力边界不同在 GBrain 的 harness 注册表中也是两个独立的适配器标识。从源码 src/core/harness/registry.ts 可以看到两个适配器的定义差异适配器 ID支持模式连接机制指南muselocal-cli,thin-clithin-clidocs/guides/muse.mdmuse-codestdio,httpmanual按客户端设置docs/guides/muse.md#muse-code-is-a-different-product也就是说本指南全程使用--harness muse而muse-code以独立身份存在绝不能把 Muse Code 或任何同名的第三方项目的能力如 stdio/http MCP 注册套用到一个尚未证实支持原生 MCP 注册的个人智能体上。运行gbrain mcp adapters可查看带日期标注的适配器清单。公共设计文档确立了哪些前提Meta 官方发布的 Muse 技术设计2026-09-08 发布本仓库于 2026-09-09 核验确立了以下事实Muse 运行在专用 Linux VM、Debian 运行时单元中支持 CLI 工具、自定义技能skills与自定义连接器connectors内置连接器的凭据保存在运行时单元之外由Sentinel统一管控连接器动作与网络出口egress。这些前提为小型 CLI 集成提供了良好基础但公共文档并未明确以下三件事持久化的自定义工具目录具体路径原生 MCP 注册接口是否存在GBrain 技能的安装 API。因此本指南的核心纪律是在安装之前先在真实 Muse 环境中确认持久化路径。不要照搬 Grok Bot 的/workspace惯例也不要把记忆放进一个可能随运行时单元替换而消失的临时 home 目录——今天有一个 Linux shell并不能证明其文件能活过运行时单元替换。registry 源码中muse适配器的evidence.runtimeTestedAt为null正是这一未验证状态的直接体现。先选路径本地新大脑还是宿主化瘦客户端你的处境选择全新大脑且已确认存在持久化用户文件目录本地安装适配器muse见下文已有宿主化大脑按 宿主化 harness 接入 走适配器muse使用瘦 CLI尚未确认任何持久化自定义文件位置先解决该平台能力再创建持久化本地记忆账户中出现了原生 MCP 选项将其视为待验证的新能力本指南不声称 Muse 支持原生 MCP若走宿主化路线需要在两个不同的地方分别做事大脑所有者在宿主上授权gbrain mcp grant然后在智能体环境内安装私有交接凭据gbrain connect ... --install。授权配置文件不安装在宿主侧不等于智能体侧已配置完成。粘贴到 Muse 的安装提示词官方指南提供了一段可直接粘贴给 Muse 的完整提示词它把确认持久化证据 → 运行 setup 助手 → 挂载技能 → 随机化测试的整个流程编排进一次对话Set up GBrain as my durable memory. Read: https://raw.githubusercontent.com/garrytan/gbrain/master/docs/guides/muse.md and its linked in-agent setup guide. First identify the documented or platform-confirmed durable user-files area available to your runtime. Inspect it and choose an absolute gbrain root there. Tell me the persistence evidence. If you cannot establish persistence, report that blocker instead of treating a temporary runtime directory as durable. Use the shipped setup helper with --harness muse and that absolute --root. Reuse a matching installation and preserve existing state. Use its generated absolute bin/gbrain launcher for every memory command. Keep your current identity. Start with keyless facts and recall. Show me inits search-mode matrix and confirm my choice; keep paid maintenance and bulk capture opt-in. Attach the generated memory instructions using the native custom-skill mechanism available in this account, and report its exact location or name. Save and recall a harmless randomized test fact, then help me verify a fresh conversation actually invokes GBrain. Use Muses normal permission and secure credential flows for any blocked download or later hosted connection. Report each unverified platform step separately from successful local CLI checks.这段提示词刻意内置了几道防幻觉闸门先要持久性证据说不出就报告阻塞点而非把临时目录当持久目录全程使用生成的绝对路径 launcher保持现有身份把本地 CLI 检查成功与平台集成步骤未经证实分开汇报。运行官方 setup 助手--harness muse确定持久化根目录根目录必须是绝对路径且父目录已存在示例/workspace/gbrain但请以你在 Muse 环境中实测确认的持久化目录为准。新装时该目录应为空或不存在不得使用临时目录、可能被其他任务删除的检出目录或符号链接。同一根目录必须对后续对话与例行任务持续可见。安装完成后会生成如下目录布局根目录下的路径用途bin/gbrain稳定命令入口始终选中这个大脑及其来源bin/gbrain-setup修复已记录的运行时或显式升级.gbrain/config.json本地配置.gbrain/brain.pglite完整数据库含仅存于数据库中的事实.gbrain/agent-install/receipt.json所有权、固定的包/运行时版本、schema 与能力证据memory/受托管源文件instructions/gbrain-skill.md供原生技能机制挂载的记忆指令instructions/maintenance.md可选的维护例行任务带稳定标识符runtime/可替换的私有运行时与包版本GBRAIN_HOME即所选根目录状态落在其下的.gbrain/。必须使用生成的 launcher 而非 PATH 上的其他gbrain它会显式选定根目录、切换到该目录并清除继承的数据库、大脑、源与 provider 覆盖项。后续 provider 配置应写入本安装的 config 或私有.gbrain/.env不要写进别的项目的环境。执行安装命令在智能体计算机内执行Muse 使用--harness muse与实测确认的持久化根目录curl --fail --silent --show-error --location \ https://raw.githubusercontent.com/garrytan/gbrain/latest-stable/scripts/setup-in-agent.sh \ --output /tmp/gbrain-setup.sh bash /tmp/gbrain-setup.sh --root /your/verified/durable/root --harness muse从 scripts/setup-in-agent.sh 源码可以确认该助手的实际行为与约束非 root 运行脚本是运行时跳板trampoline所有权/初始化/修复策略全部落在包内的src/core/agent-install服务里脚本本身绝不写大脑参数约束--harness只接受grok-bot或muse第 38 行硬校验--root必须是无路径穿越..的绝对路径还支持--adopt、--upgrade、--json可用-h查看帮助依赖检查环境需具备 Bash、curl、unzip、git与对外访问 GitHub 及包下载的能力但不安装系统包、不需要 root若平台拦截下载走 Muse 正常的授权流程运行时固定Bun 版本固定为1.3.13第 45 行下载后校验 SHA-256 校验和安装包以--ignore-scripts禁用生命周期脚本首次安装解析latest-stable标签并把不可变的 commit 记入 receipt因此普通修复绝不会隐式升级软件环境隔离安装前清除GBRAIN_*、ANTHROPIC_*、OPENAI_*、DATABASE_URL、*_API_KEY等几十类环境变量第 89-93 行防止把 Bot 其他项目/数据库的环境带进来初始化模式--pglite --no-embedding即无 Key 事实写入、实体回忆、文本过滤可用语义嵌入与付费提取需另行配置。重复运行同一助手即修复已记录的运行时记忆永不被重置。初始化会打印搜索模式矩阵search-mode matrix需向用户转达并确认选择付费维护与批量采集保持 opt-in。对已存在的兼容本地大脑可在核查其根目录与配置后加--adopt采纳它保留数据库与配置但不会把宿主化客户端转换成本地库也不会用替换手段修复不可读的数据库。证明第一次记忆往返randomized round trip用无害的随机化值做测试确保答案不可能来自模型的一般知识。让 Muse 替换随机后缀与当前日期/your/verified/durable/root/bin/gbrain remember \ My setup test phrase is amber-orbit-REPLACE-WITH-RANDOM-SUFFIX \ --entity projects/gbrain-setup --provenance explicit setup test, YYYY-MM-DD --json /your/verified/durable/root/bin/gbrain recall projects/gbrain-setup --json写入必须返回成功状态且独立的recall 进程必须原样返回该短语及其出处。随后通过 Muse 的原生自定义技能/常驻指令机制挂载instructions/gbrain-skill.md技能内保留确切的绝对 launcher 路径开启新对话不重复该短语直接提问检查实际命令结果——智能体必须调用同一绝对 launcher其内置记忆不能作为使用过 GBrain 的证据让智能体更正测试短语回忆旧事实、退役旧 ID、带出处保存新事实、再验证普通 recall 返回当前事实测试清理/your/verified/durable/root/bin/gbrain forget FACT_ID --reason setup test complete /your/verified/durable/root/bin/gbrain recall projects/gbrain-setup --jsonFACT_ID使用本安装 CLI 返回的数字 ID。forget只是让事实退出活跃回忆历史与早期备份仍可能保留它。安装器在 receipt 中刻意记录native_runtime: unverified见 src/core/agent-install/state.ts 与 src/core/agent-install/setup.ts数据库探针通过只证明本地运行启用原生技能并在新对话中测试才证明应用层行为两者要分别记录含日期与应用版本。公共文档并未确立 Muse 存在自动的AGENTS.md加载器或 hook API仅写一个仓库文件不能证明 Muse 会用它。三个值得先试的实战场景持久偏好记住我希望推荐先给简短结论再给证据。开新对话在准备推荐前先让它回忆该偏好。项目交接回忆当前 project-example 决策与待决问题我们决定后把今天的新决策连同日期记住。复用既有连接服务用你已连接的日历和邮件准备这场会议把我让你保留的承诺连同来源链接保存。让 Muse 继续用自己的连接器与权限GBrain 只存选定事实不复制服务凭据。另有两类明确禁区不要索取连接器的原始令牌也不要为让 GBrain 工作而改动 Sentinel 策略。宿主化大脑的允许目标与安全凭据交付属于宿主化接入流程的一部分需走产品真实支持的流程完成一次被拒绝的请求是已报告的环境边界而不是绕道尝试的借口。本地安装的维护、备份与恢复以下步骤适用于 GBrain 运行在 Muse 内部的情形宿主化连接则使用ROOT/GBRAIN-INSTRUCTIONS.md与宿主化运行时修复流程。维护单一例行任务手工记忆成功后若账户提供原生调度能力可把instructions/maintenance.md作为可选原生调度的依据只维护一条例行任务并实际测试它。不要安装投机性的守护进程也不要假设 shell cron 就是产品的原生调度器。并发方面PGLite 同一时刻只允许一个进程持有数据库另一个命令会等待超时可能返回pglite_busy此时应先等前者结束再重试绝不要删除活跃锁也避免对同一根目录并行发起记忆命令。备份完整私有备份 离 VM 副本mkdir -p /your/verified/durable/root-backups chmod 700 /your/verified/durable/root-backups /your/verified/durable/root/bin/gbrain backup create \ --output /your/verified/durable/root-backups/brain-YYYYMMDD-HHMM.gbrain-backup --json每个输出文件名必须全新。该命令持有真实 PGLite 写入锁、做全库转储、核查受托管文件清单、发布带校验和的0600归档数据库忙或文件变化会导致操作失败而非发布成功回执。归档包含完整数据库与可能的敏感记忆/认证状态其0600权限不代表加密也无法防整个 VM 丢失——必须显式选择受保护的离 VM 副本套用目标端加密与访问控制并验证副本可恢复。恢复格式当前接受受托管的.gbrain/brain.pglite数据库、PostgreSQL 17 PGLite 集群载荷上限 8 GiBbackup status/backup check只报告文件覆盖情况不产生快照Markdown 导出无法恢复仅存于数据库的事实。恢复还原到全新根目录/your/verified/durable/root/bin/gbrain backup restore \ /your/verified/durable/root-backups/brain-YYYYMMDD-HHMM.gbrain-backup \ --into /your/verified/durable/root-restored --json目标目录必须不存在。恢复先验证归档再重定位受托管路径、隔离外部源/配置路径并在一个事务中取消所有未完成的后台任务保留其原状态供检查。外部检出与 API 源记住的页面仍可查询但实时连接器配置被隔离且同步被禁用sync --source ...无法凭单一命令重新激活被隔离的 Google/GitHub 配置。成功回执为state: ready、launcher_ready: false、setup_required: true随后重装运行时bash /tmp/gbrain-setup.sh --root /your/verified/durable/root-restored --harness muse受托管安装的备份不要加--adoptrestore 已写入修复所需的归属回执。恢复后读取重连清单、用平台安全机制补回被排除的凭据、显式重挂外部源并在更新原生技能之前用随机化记忆测试对着新 launcher 重跑一遍。原始大脑保持完好之后只用一个选定根目录写入。修复与停止运行时单元替换后用保留的 shell 助手修复已记录的包而不重置记忆bash /your/verified/durable/root/bin/gbrain-setup若该文件丢失重新下载官方助手并传入原--root与--harness。修复重装记录的 commit 与 Bun 版本保留事实、配置、源选择与原生例行任务标识符它会拒绝替换被编辑过的生成文件、损坏配置或已初始化却消失的数据库。升级是另一回事需在完成验证过的备份后显式执行gbrain-setup --upgrade。要停止使用暂停原生例行任务并禁用技能保留根目录与受保护备份直到你决定删除记忆若连接过宿主化大脑另行撤销宿主上的授权。详见共享设置命令与排查表。验收清单与已知边界本地安装器、CLI 与恢复路径拥有仓库内封闭测试真实 PGLite 初始化、独立 CLI 进程、环境隔离、运行时修复、所有权守卫、归档完整性、路径重定位、未完成任务隔离但尚未用真实 Muse 账户验证过该集成。剩余验收项是具体的建立并记录持久化根目录及其在运行时替换后的行为完成允许的包下载并运行生成的 launcher用独立命令完成随机化事实的保存、回忆、更正与遗忘让新对话选中原生技能并调用该 launcher把私有备份恢复到另一根目录并验证已存事实若使用测试账户原生调度及其失败上报宿主化大脑需验证真实出口与安全凭据流不假定存在原生 MCP 或特权凭据服务集成。故障处置要点安装被阻塞时保留平台的原样拒绝记忆只在当前对话生效则检查原生技能挂载运行时消失则对同一持久化根目录做修复根目录未保留则恢复备份而不是在旧路径上初始化一个替代大脑。更多错误与修复见共享排查表。完整的验证证据与真机 harness 验收标准见 harness 集成验证其中明确记录了仓库测试与平台级验收的边界——Muse 原生 MCP 支持未被声称它也不是一条公开的安装路径。【免费下载链接】gbrainGarrys Opinionated OpenClaw/Hermes Agent Brain项目地址: https://gitcode.com/gh_mirrors/gb/gbrain创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考