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