核心功能
Mycelium 是一个面向 AI Agent 的分布式协调基础设施，通过 CLI 工具实现三大核心能力：持久化共享内存、实时结构化谈判、跨会话状态同步。
核心用法
内存管理：所有记忆以 Markdown 文件形式存储于 ~/.mycelium/rooms/{room}/，支持语义搜索（mycelium memory search）、键值读写（set/get）、订阅变更（subscribe）。文件系统即真实数据源，Git 可直接管理。
房间协调：mycelium room create/use 创建命名空间，房间内记忆自动累积。CognitiveEngine 作为中介，驱动多轮谈判流程。
结构化谈判：mycelium session join 启动多 Agent 协商，支持提议（propose）、响应（respond accept/reject）、状态查询（status）。谈判有固定轮次限制，结果为「达成共识」或「超时无协议」两种终态。
跨平台集成：通过 OpenClaw 适配器，Agent 可在 Discord/Matrix 等渠道与 Mycelium 房间双向通信，@handle 提及即可唤醒目标 Agent。
显著优点
- Unix 原生设计：记忆即文件，支持 cat/grep/sed/git 全套工具链
- 去中心化信任模型：无强制中央凭证，后端可自托管，认证由反向代理/网络策略控制
- 明确的状态机：谈判协议边界清晰，避免「无限扯皮」
- 语义检索：基于向量嵌入的自然语言记忆查询
潜在局限
- 第三方 Tap 风险：Homebrew 安装源
mycelium-io/tap非官方，需人工审计 - 本地明文存储：房间记忆以纯文本 Markdown 存放，禁止存储密钥、凭证或 PII
- OpenClaw 特殊限制：谈判在隔离会话中运行，无法携带主渠道短期记忆，开场陈述（
-m参数）成为唯一上下文传递手段 - 线程阻塞风险：
mycelium session await会锁死 OpenClaw gateway 线程，必须使用 gateway 唤醒机制
适合人群
多 Agent 协作场景：AI 研究团队、自动化工作流编排、分布式决策系统开发者。需具备自托管后端运维能力或信任特定后端部署。
常规风险
- 供应链安全：第三方 Homebrew Tap 的 release artifacts 需手动验证
- 数据泄露：本地房间目录权限不当导致敏感业务信息暴露
- 网络中间人：HTTP 后端若未配 TLS/认证，传输可被截获
- 谈判僵局：协议无「渐进让步」机制，对立立场易导致超时
- 会话隔离认知差：用户可能误以为谈判中的 Agent 拥有主渠道上下文