ClawHub

Shared Memory Os

Other

Shared memory governance for multi-agent OpenClaw workspaces — with tiered memory, learnings capture, promotion review, lifecycle management, self-maintaining reports, cross-skill collaboration, and bilingual ClawHub-friendly docs.

Install

openclaw skills install shared-memory-os

Shared Memory OS

English and 中文 are on the same page below. In ClawHub, read the language section directly instead of relying on anchor-jump behavior.

English

Shared Memory OS turns workspace memory into a governed system instead of a pile of notes.

Core capabilities

  • layered memory governance
  • active learnings harvesting into .learnings/
  • review cadence and archive strategy
  • conflict resolution order
  • health scoring and health history
  • duplicate learnings detection with evidence/confidence
  • promotion candidate detection with review state
  • promotion suggestion and memory patch generation
  • weekly review, audit report, and dashboard generation
  • stale durable memory detection with lifecycle hints
  • validated repeated rule detection
  • low-value learning detection
  • workflow optimization suggestions
  • conflict logging and conflict review reporting
  • learning merge suggestions
  • skill upgrade candidate detection
  • migration guidance and initialization scripts
  • self-improving loop
  • maintenance runner
  • policy profiles and workspace profiles
  • cross-skill collaboration governance
  • multi-agent write and review guidance
  • periodic maintenance-day guidance

References

  • references/governance-guide.md
  • references/pattern-harvesting.md
  • references/archive-strategy.md
  • references/learnings-template.md
  • references/health-check.md
  • references/self-improving-loop.md
  • references/health-score-model.md
  • references/conflict-template.md
  • references/migration-guide.md
  • references/policy-profiles.md
  • references/workspace-profiles.md
  • references/cross-skill-collaboration.md
  • references/multi-agent-governance.md
  • references/maintenance-day.md
  • references/zh-cn-guide.md

Scripts

  • scripts/bootstrap-shared-memory-os.js
  • scripts/ensure-shared-memory-crons.js
  • scripts/init-shared-memory-os.js
  • scripts/migrate-notes-into-memory.js
  • scripts/run-shared-memory-maintenance.js
  • scripts/check-memory-health.js
  • scripts/rebuild-learnings-index.js
  • scripts/find-duplicate-learnings.js
  • scripts/find-promotion-candidates.js
  • scripts/find-stale-durable-memory.js
  • scripts/find-validated-rules.js
  • scripts/find-low-value-learnings.js
  • scripts/build-workflow-optimization-suggestions.js
  • scripts/log-memory-conflict.js
  • scripts/build-conflict-review-report.js
  • scripts/build-weekly-review.js
  • scripts/record-health-snapshot.js
  • scripts/build-promotion-suggestions.js
  • scripts/build-learning-merge-suggestions.js
  • scripts/find-skill-upgrade-candidates.js
  • scripts/build-memory-patch-candidates.js
  • scripts/build-audit-report.js
  • scripts/build-dashboard.js

Setup

For first-time setup in an OpenClaw agent session, prefer the built-in cron tool instead of shelling out to openclaw cron ... commands.

When this skill is used to initialize a workspace, immediately ensure these three recurring jobs exist (create missing ones, update same-name jobs if they already exist):

  • shared-memory-os daily maintenance — daily light maintenance
  • shared-memory-os weekly review — weekly full maintenance + dashboard/audit summary
  • shared-memory-os monthly deep maintenance — monthly deep cleanup and review

Recommended default schedules (Asia/Shanghai):

  • daily: 15 3 * * *
  • weekly: 30 3 * * 1
  • monthly: 45 3 1 * *

Recommended job shape:

  • sessionTarget: "isolated"
  • payload.kind: "agentTurn"
  • payload.toolsAllow: ["exec", "read"]
  • delivery.mode: "none"
  • failure alert enabled after 1 failure

After cron jobs are ensured, run one full maintenance pass so reports exist immediately.

For first-time setup from a terminal instead of an agent session, run node skills/shared-memory-os/scripts/bootstrap-shared-memory-os.js or bash skills/shared-memory-os/scripts/bootstrap-shared-memory-os.sh from the workspace root. These are fallback entrypoints for manual/bootstrap use.

If you only need to repair or reapply automation from a terminal, run node skills/shared-memory-os/scripts/ensure-shared-memory-crons.js or bash skills/shared-memory-os/scripts/ensure-shared-memory-crons.sh. The installer is intended to be idempotent: same-name jobs are updated, missing jobs are created.

Guidance

Use this skill when you want memory to stay useful over time: keep facts durable, keep daily state local, keep lessons reusable, let promotion stay reviewable, let low-value noise get pruned, and let repeated lessons improve other skills too.

中文

Shared Memory OS 的目标，是把 workspace 里的共享记忆变成“可治理、可维护、可进化、可协同”的系统，而不是零散笔记。

核心能力

  • 分层记忆治理
  • 主动沉淀 .learnings/
  • review cadence 与 archive strategy
  • 冲突处理顺序
  • 健康评分与历史趋势
  • 带 evidence/confidence 的重复经验检测
  • 带 review 状态的 promotion candidate 检测
  • promotion 建议与 MEMORY.md patch 候选生成
  • 周报、审计报告、dashboard 生成
  • 带生命周期提示的 stale durable memory 检测
  • 反复验证规则检测
  • 低价值 learning 检测
  • 工作流优化建议生成
  • 冲突日志与冲突审查报告
  • learning 合并建议
  • skill 升级候选检测
  • 初始化与迁移脚本
  • 自学习进化闭环
  • 一键 maintenance runner
  • policy profile / workspace profile
  • 与其他 skills 的协同治理
  • 多 agent 写入与审核边界建议
  • 周期性 maintenance day 指南

参考文档

  • references/zh-cn-guide.md
  • references/governance-guide.md
  • references/pattern-harvesting.md
  • references/archive-strategy.md
  • references/learnings-template.md
  • references/health-check.md
  • references/self-improving-loop.md
  • references/health-score-model.md
  • references/conflict-template.md
  • references/migration-guide.md
  • references/policy-profiles.md
  • references/workspace-profiles.md
  • references/cross-skill-collaboration.md
  • references/multi-agent-governance.md
  • references/maintenance-day.md

脚本

  • scripts/bootstrap-shared-memory-os.js
  • scripts/ensure-shared-memory-crons.js
  • scripts/init-shared-memory-os.js
  • scripts/migrate-notes-into-memory.js
  • scripts/run-shared-memory-maintenance.js
  • scripts/check-memory-health.js
  • scripts/rebuild-learnings-index.js
  • scripts/find-duplicate-learnings.js
  • scripts/find-promotion-candidates.js
  • scripts/find-stale-durable-memory.js
  • scripts/find-validated-rules.js
  • scripts/find-low-value-learnings.js
  • scripts/build-workflow-optimization-suggestions.js
  • scripts/log-memory-conflict.js
  • scripts/build-conflict-review-report.js
  • scripts/build-weekly-review.js
  • scripts/record-health-snapshot.js
  • scripts/build-promotion-suggestions.js
  • scripts/build-learning-merge-suggestions.js
  • scripts/find-skill-upgrade-candidates.js
  • scripts/build-memory-patch-candidates.js
  • scripts/build-audit-report.js
  • scripts/build-dashboard.js

初始化方式

在 OpenClaw agent 会话里，优先直接使用一等 cron 工具创建/更新自动任务，而不是通过 shell 调 openclaw cron ...。

当此 skill 用于初始化 workspace 时，应立即确保以下 3 个同名任务存在（已存在则更新，不存在则创建）：

  • shared-memory-os daily maintenance
  • shared-memory-os weekly review
  • shared-memory-os monthly deep maintenance

推荐默认时区与时间（Asia/Shanghai）：

  • daily: 15 3 * * *
  • weekly: 30 3 * * 1
  • monthly: 45 3 1 * *

推荐任务形态：

  • sessionTarget: "isolated"
  • payload.kind: "agentTurn"
  • payload.toolsAllow: ["exec", "read"]
  • delivery.mode: "none"
  • 开启 failure alert，连续 1 次失败就报警

确保 cron 任务后，应立即跑一次完整 maintenance，让 reports 立刻可用。

如果是在终端里手动初始化，而不是在 agent 会话里，使用：node skills/shared-memory-os/scripts/bootstrap-shared-memory-os.js 或 bash skills/shared-memory-os/scripts/bootstrap-shared-memory-os.sh。这是给手动/终端 bootstrap 的 fallback 入口。

如果只是补装或修复自动化任务，可运行：node skills/shared-memory-os/scripts/ensure-shared-memory-crons.js 或 bash skills/shared-memory-os/scripts/ensure-shared-memory-crons.sh。这些安装脚本设计目标是幂等：同名任务更新，缺失任务创建。

使用建议

当你希望共享记忆长期可用时，用它来维持：长期事实要稳定、当天状态要就地、经验要可复用、promotion 要可审查、低价值噪音要能被清理、而且反复验证过的经验还应反向推动其他 skills 一起变强。