核心定位
Mycelium 是一个面向多智能体协作的 CLI 工具，提供三大核心能力：持久化共享内存（以本地 Markdown 文件为存储，支持语义搜索）、实时结构化协商（由 CognitiveEngine 中介的多轮谈判协议）以及 房间化命名空间管理（Rooms 作为跨会话的协作容器）。
核心用法
1. 房间与内存管理
房间（Room）是持久化的协作空间，内存以 Markdown 文件形式存储于 ~/.mycelium/rooms/{room}/{key}.md，支持原生 Unix 工具链操作（cat/grep/sed），并可 Git 管理。使用 mycelium memory set/get/search/ls 进行读写和语义检索。
2. 结构化协商协议
当多智能体需就多议题权衡达成共识时，通过 mycelium session join 进入协商会话，CognitiveEngine 驱动多轮出价-响应循环（propose/respond accept/reject）。协商结果自动编译为共享计划（plan/tasks.md），以 - [ ] 任务清单形式驱动后续执行。
3. 非协商式通信
日常快速协调通过 @handle 提及在房间内直接进行，或使用 mycelium room send 单向投递。需即时答复时使用 OpenClaw 的 sessions_send 原语。
显著优点
- 文件系统原生：内存即文件，无 vendor lock-in，支持版本控制与标准工具链
- 协议化协商：将"讨论到共识"的模糊过程转化为可审计、可中断、有终态的结构化协议
- 跨会话持久：Rooms 积累历史上下文，新加入智能体可通过搜索快速获取背景
- OpenClaw 深度集成：协商结果自动回传至原会话，无需手动中继
潜在局限与风险
架构层面：协商运行在独立的 Mycelium-channel 会话中，不继承 home-channel 的短期记忆。开场位置声明（-m "..."）成为唯一上下文传递通道，表述需极度具体。协议无渐进让步机制，僵局只能通过 reject 直至 timeout，可能浪费轮次。
安全与运维：第三方 Homebrew Tap（mycelium-io/tap）非官方源，需人工审计信任度。本地明文存储 Markdown，明确禁止存放密钥或 PII。后端 HTTP 通信依赖 ~/.mycelium/config.toml 配置的端点，需确保网络边界安全。
运维约束：OpenClaw 环境下禁止调用 mycelium session await（会阻塞网关线程）。每智能体需单独 allowlist mycelium 二进制文件。
适合人群
- 运行多智能体团队的工程师，需协调复杂技术决策（架构选型、任务分配、排期权衡）
- 需要可审计、可复现的协商历史的合规场景
- 偏好文件系统优先、Git 友好的基础设施团队
常规风险提示
| 类别 | 说明 |
|------|------|
| 第三方代码 | Tap 及二进制非 Homebrew 官方分发，建议校验 release 签名 |
| 数据泄漏 | 房间内存为本地明文，共享目录权限需收紧 |
| 上下文断裂 | 跨通道协商会话隔离，依赖人工编写完备的开场声明 |
| 网络暴露 | 默认 `localhost:8000` 后端若暴露公网，需前置认证代理 |