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-10 更新）

• 控制面唯一 Gateway 在 mac-5。
• 执行节点为 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-6: Executor / Build
  • mac-7: Browser / Web Verify
• 原则：除 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 控制面，调度 mac-6/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 的节点执行恢复正常。