collective-memory-repo/shared/long-term/projects/openclawd-memory-index.md

OpenClaw MEMORY Index (Imported)

• imported_from: /Users/lingyuzeng/openclawd/vaults/MEMORY.md
• imported_at_utc: 2026-03-10T07:53:38Z
• note: migrated from openclawd/vaults to collective-memory-repo.

---

MEMORY.md - Long-Term Memory

OpenClaw 集群架构（2026-03-18 更新）

• mac-5 = brain：控制面唯一 Gateway，负责编排、记忆主入口、全局调度。
• mac-6 = hands：执行与算力节点，负责构建、脚本、CLI agent、批处理等通用执行。
• mac-7 = eyes：浏览器与验收节点，负责网页访问、自动化验证、截图、browser-first 检查。
• mac-6 / mac-7 均为 Node Host（不运行 Gateway）。
• mac-8 已下线，已从当前调度与记忆基线中移除。
• 对外统一入口通过 Caddy 的 HTTPS/WSS 反代（当前说明含 mac5.hs.jmsu.top:8443，运行态摘要也提到 bot.jmsu.top:443，以实际部署配置为准）。
• 节点生命周期：node run/install -> Pending -> devices approve -> Online -> nodes run 调度。
• 原则：除 mac-5 外，其他机器禁止启动 Gateway。

协作与权限原则

• 远程执行统一走 openclaw nodes run。
• 节点执行受本地 allowlist / approvals 控制，按角色最小权限配置。
• 常见故障定位关键词：unauthorized、pairing required、origin not allowed、trusted proxies、approval required。

记忆索引

• 集群基础设施细节：memory/infra.md
• 项目状态：memory/projects.md
• 经验教训：memory/lessons.md
• 每日记录：memory/YYYY-MM-DD.md

记忆网关策略（QMD Gateway）

• 采用 qmd-memory-gateway 的一致性模型：查询前同步（fetch -> workspace sync -> qmd update/embed -> query）。
• 当前建议仍为 mac-5 单 Gateway（控制面唯一入口），mac-6/7 不启动 Gateway。
• 仅在出现跨机网络瓶颈或单点容量瓶颈时，再评估分机独立 Gateway。

身份与运行角色

• 身份文件：IDENTITY.md
• 当前运行定位：驻守 mac-5 的 brain 位，统一编排并调度 mac-6（hands）与 mac-7（eyes）。
• 任务分发默认心智模型：
  • 需要控制、汇总、决策、记忆写入 → mac-5
  • 需要执行、构建、脚本、算力 → mac-6
  • 需要浏览器、页面验证、验收 → mac-7

当前集群调用经验（2026-03-10）

• wss://bot.jmsu.top 这条远端入口链路可正常控制 mac-6 / mac-7。
• 若 mac-5 本机 CLI 默认落到 ws://127.0.0.1:18789，可能出现 1006 abnormal closure / ECONNREFUSED，这不等于远端 WSS 链路坏掉。
• 排障时要先区分两层：
  • 网关路径选择问题（本地默认 vs 显式 --url wss://bot.jmsu.top）
  • 节点版本兼容问题（旧版 node host 可能因 system.run.prepare 不支持而无法执行）
• 当前确认：将 mac-6 / mac-7 升级到 v2026.3.8 后，显式走 wss://bot.jmsu.top 的节点执行恢复正常。