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 一起变强。