Agent Config Sync — 代理 Config 同步

代理 Config 同步

Multi-代理 configuration version management and automatic 同步 for OpenClaw 部署ments.

Overview

This 技能 mAIntAIns consistency across multiple OpenClaw 代理s (AMaster, 大师, 元宝, 牛奶) by 追踪ing all configuration changes — 系统 code, 代理 configs, OpenClaw 设置tings, and task configurations — and automatically pushing 更新s to all 代理s via heartbeat 检查s.

Architecture ┌─ Version 追踪ing ──────────────────────┐ │ .current_系统_version (monotonic) │ │ .last_同步_version (last 同步ed) │ │ CHANGE记录.md (change 记录) │ └──────────────────────────────────────────┘ │ version mismatch 检测ed by HEARTBEAT ▼ ┌─ 同步 Dis补丁 ─────────────────────────┐ │ 会话s_发送 (代理 online) ──→ live │ │ or pending_同步.md (offline) ──→ file │ └──────────────────────────────────────────┘ │ 代理 reads on 启动up/heartbeat ▼ ┌─ 代理 Side ────────────────────────────┐ │ BOOTSTRAP.md → 检查 pending_同步.md │ │ HEARTBEAT.md → 检查 pending_同步.md │ │ 同步.md → manual 同步 instructions │ └──────────────────────────────────────────┘

设置up

• 初始化 追踪ing files in the AMaster workspace

cd ~/.OpenClaw/workspace-amaster/memory echo "v1.0" > .current_系统_version echo "v1.0" > .last_同步_version touch CHANGE记录.md

• 添加 HEARTBEAT 检查 (in AMaster's HEARTBEAT.md)

添加 item 12. ⭐ 配置变更强制同步 that:

Reads .current_系统_version and .last_系统_version On mismatch: reads CHANGE记录.md, pushes to all 代理s Falls back to pending_同步.md if 代理s offline 更新s .last_同步_version on 成功

See references/同步-设置up.md for the exact HEARTBEAT item text.

• 添加 代理-side auto-同步

For each 代理 workspace, 创建/更新:

同步.md — 同步 instructions BOOTSTRAP.md — 启动up 检查 for pending_同步.md HEARTBEAT.md — heartbeat 检查 for pending_同步.md

See references/代理-设置up.md for exact file contents.

• 创建 pending_同步.md template

Place in each 代理 workspace:

~/.OpenClaw/workspace-acode/pending_同步.md ~/.OpenClaw/workspace-AInvest/pending_同步.md ~/.OpenClaw/workspace-alive/pending_同步.md

See references/pending-同步-template.md.

工作流 On any configuration/系统 change 更新 CHANGE记录.md with the change description Increment memory/.current_系统_version (e.g., v3.1 → v3.2) Next HEARTBEAT (or immediate manual 运行) 检测s the version mismatch 同步 is dis补丁ed to all 代理s Manual 同步 trigger

Consult scripts/force_同步.sh or manually 运行:

# Force the heartbeat 同步 检查 echo v3.1 > ~/.OpenClaw/workspace-amaster/memory/.current_系统_version echo v3.0 > ~/.OpenClaw/workspace-amaster/memory/.last_同步_version

Then the next heartbeat will 检测 the mismatch and trigger 同步.

Change Categories (all require 同步) Type Examples 🖥️ 系统 code Quant 系统, price compare, scripts 🤖 代理 config SOUL.md, 代理S.md, 身份.md, USER.md, 工具S.md ⚙️ OpenClaw sysconfig 模型s, 技能s, 服务 添加resses, ports 🎯 Task config API keys, cron jobs, data sources Files 技能.md — This file references/同步-设置up.md — DetAIled HEARTBEAT item 12 and infrastructure 设置up references/代理-设置up.md — Per-代理 同步/BOOTSTRAP/HEARTBEAT config references/pending-同步-template.md — pending_同步.md template scripts/init_同步.sh — One-command 设置up of all 同步 infrastructure scripts/force_同步.sh — Trigger heartbeat 同步 检测ion immediately