企业官网建设流程全解析

GBrain 接入 Meta Muse 个人智能体：持久化记忆的本地 CLI 集成指南

【免费下载链接】gbrainGarry's 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 可以看到两个适配器的定义差异：

也就是说：本指南全程使用--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 集成"提供了良好基础，但公共文档并未明确以下三件事：

1. 持久化的自定义工具目录具体路径；
2. 原生 MCP 注册接口是否存在；
3. GBrain 技能的安装 API。

因此本指南的核心纪律是：在安装之前，先在真实 Muse 环境中确认持久化路径。不要照搬 Grok Bot 的/workspace惯例，也不要把记忆放进一个可能随运行时单元替换而消失的临时 home 目录——"今天有一个 Linux shell"并不能证明"其文件能活过运行时单元替换"。registry 源码中muse适配器的evidence.runtimeTestedAt为null，正是这一未验证状态的直接体现。

先选路径：本地新大脑还是宿主化瘦客户端

若走宿主化路线，需要在两个不同的地方分别做事：大脑所有者在宿主上授权（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 init's 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 Muse's 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 环境中实测确认的持久化目录为准）。新装时该目录应为空或不存在；不得使用临时目录、可能被其他任务删除的检出目录或符号链接。同一根目录必须对后续对话与例行任务持续可见。

安装完成后会生成如下目录布局：

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 进程必须原样返回该短语及其出处。随后：

1. 通过 Muse 的原生自定义技能/常驻指令机制挂载instructions/gbrain-skill.md，技能内保留确切的绝对 launcher 路径；
2. 开启新对话，不重复该短语直接提问，检查实际命令结果——智能体必须调用同一绝对 launcher；其内置记忆不能作为使用过 GBrain 的证据；
3. 让智能体更正测试短语：回忆旧事实、退役旧 ID、带出处保存新事实、再验证普通 recall 返回当前事实；
4. 测试清理：

/your/verified/durable/root/bin/gbrain forget FACT_ID --reason "setup test complete" /your/verified/durable/root/bin/gbrain recall projects/gbrain-setup --json

FACT_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 会用它。

三个值得先试的实战场景

1. 持久偏好："记住我希望推荐先给简短结论，再给证据。"开新对话，在准备推荐前先让它回忆该偏好。
2. 项目交接："回忆当前 project-example 决策与待决问题；我们决定后，把今天的新决策连同日期记住。"
3. 复用既有连接服务："用你已连接的日历和邮件准备这场会议，把我让你保留的承诺连同来源链接保存。"让 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 GiB；backup 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

受托管安装的备份不要加--adopt（restore 已写入修复所需的归属回执）。恢复后读取重连清单、用平台安全机制补回被排除的凭据、显式重挂外部源，并在更新原生技能之前用随机化记忆测试对着新 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 支持未被声称，它也不是一条公开的安装路径。

【免费下载链接】gbrainGarry's Opinionated OpenClaw/Hermes Agent Brain项目地址: https://gitcode.com/gh_mirrors/gb/gbrain