# 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` 的节点执行恢复正常。