What makes Agent Config Sync notable?

976 downloads. Trust evidence available

How should Agent Config Sync be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Agent Config Sync

Synchronize configuration versions across OpenClaw multi-agent deployments. Tracks changes in a master workspace using sentinel version files and CHANGELOG,...

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

976

Updated

Oct 11, 2026

Version

1.5.1

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 976 downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 976 downloadsadoption · observed Oct 11, 2026
Latest release: 1.5.1release · observed May 16, 2026
Handshake status: UNKNOWNsecurity

What changed

Newest first. Only changes that point at a source are listed.

Release 1.5.1release
agent-config-sync v1.5.1 - SECURITY.md updated with guidance and improved formatting; no major policy or scope changes. - Minor documentation cleanup in SKILL.md for clarity. - No changes to logic, features, or behavior in the codebase.
Observed May 16, 2026 · source

Install and run

Setup complexity: low.

clawhub skill install s17f83drgkhbaj6myp1m3b9eeh86vjzd:agent-config-sync

Install using `clawhub skill install s17f83drgkhbaj6myp1m3b9eeh86vjzd:agent-config-sync` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/stevensongxx/agent-config-sync before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-stevensongxx-agent-config-sync/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

146,116 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: agent-config-sync
description: |-
  Synchronize configuration versions across OpenClaw multi-agent deployments.
  Tracks changes in a master workspace using sentinel version files and CHANGELOG,
  then dispatches to downstream agents via sessions_send or file-based pending_sync
  fallback. Each agent independently checks for updates on startup (BOOTSTRAP.md)
  and heartbeat (HEARTBEAT.md). Designed for users running 2+ specialized agents
  who need consistent system/agent/OpenClaw configurations.
  Triggers on: sync, configure, version management, multi-agent coordination.
---

# Agent Config Sync (v1.5)

Keep configuration consistent across multiple OpenClaw agents using version tracking, CHANGELOG-based change detection, and automatic sync dispatch with journal-backed two-phase commit.

> **⚡ Quick Start (30 seconds to running):**
> ```bash
> # Step 1: Install
> clawhub install agent-config-sync
>
> # Step 2: Run setup wizard (interactive, no manual editing needed)
> cd ~/.openclaw/skills/agent-config-sync
> bash scripts/wizard.sh
>
> # Step 3: Done! 🎉
> #    - Agent registry auto-detected
> #    - Sync infrastructure created
> #    - HEARTBEAT integration added
> #    - All agents ready to receive syncs
> ```
> 
> **Non-interactive?** Use `bash scripts/wizard.sh --auto` to auto-detect everything.
> 
> **Prefer manual?** See [Installation](#installation) below for step-by-step instructions.
>
> **New in v1.5**: Interactive setup wizard (`scripts/wizard.sh`), `--auto` mode for init_sync.sh (zero-config auto-detection), enhanced SYNC.md with quick start guide and cheat sheet, simplified onboarding.
>
> **New in v1.4**: Full version conflict management — dispatch lock, loop detection, self-upgrade isolation, batch mode, rollback snapshots, TTL-based expiry, offline catch-up, and agent-side version collapse. See [Version Conflict Management](#version-conflict-management-v14) for details.
>
> **Security**: This skill writes to agent workspaces across your OpenClaw deployment. Read the full [SECURITY.md](SECURITY.md) for permission scope, path validation, cross-agent isolation, and user consent flow. Key highlights:
> - All scripts require `--confirm` for write operations (use `--dry-run` to preview first)
> - Only paths under `~/.openclaw/workspace-*` are allowed (path validation enforced)
> - Each agent can only read/write its own workspace files
> - No network access, no external API calls, no credential access

## ⚙️ Customization Variables

**Option A (Recommended): Run the setup wizard**
```bash
cd ~/.openclaw/skills/agent-config-sync
bash scripts/wizard.sh
```
The wizard auto-detects your agents and generates `agent-registry.json` — no manual editing.

**Option B: Manual configuration**

Edit `references/agent-registry.json` — this is the only file you need to change for your deployment:

| Variable | Location | Example | Description |
|----------|----------|---------|-------------|
| `workspace_root` | `vars` in registry | `~/.open

README.md

# agent-config-sync v1.5

**Keep configuration consistent across multiple OpenClaw agents** — zero-touch setup, interactive wizard, version tracking, and automatic sync dispatch.

[![Version](https://img.shields.io/badge/version-1.5.0-blue)](_meta.json)
[![OpenClaw](https://img.shields.io/badge/OpenClaw-enabled-green)](https://openclaw.ai)
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
[![Bash](https://img.shields.io/badge/pure-bash-orange)](scripts/)

---

## 🎯 What It Does

When you run 2+ OpenClaw agents, keeping their configurations in sync is painful. `agent-config-sync` automates this:

```
Master Agent detects change
        │
        ▼
  Reads CHANGELOG.md
        │
        ▼
  Generates sync manifest
        │
        ├─→ Agent 1: pending_sync_v3.1_a1b2c3.md
        ├─→ Agent 2: pending_sync_v3.1_a1b2c3.md
        └─→ Agent 3: pending_sync_v3.1_a1b2c3.md
                │
                ▼
       Agents apply → verify → cleanup
```

**Syncs**: System code · Agent configs (SOUL/IDENTITY/TOOLS) · OpenClaw config · Task configs · API keys

---

## ⚡ Quick Start (30 seconds)

```bash
# 1. Install
clawhub install agent-config-sync

# 2. Run wizard (interactive, auto-detects everything)
cd ~/.openclaw/skills/agent-config-sync
bash scripts/wizard.sh

# 3. Done! 🎉
#    All agents now have sync infrastructure.
#    Changes are auto-dispatched on next Master heartbeat.
```

**Prefer non-interactive?**
```bash
bash scripts/wizard.sh --auto     # Zero prompts
bash scripts/init_sync.sh --auto  # Even faster
```

---

## ✨ Features

| Feature | Description |
|:--------|:------------|
| 🧙 **Interactive Wizard** | 5-step guided setup with auto-detection — no manual file editing |
| 🤖 **--auto Mode** | One-command setup that detects workspaces, generates registry, and initializes everything |
| 📊 **Version Tracking** | Sentinel files (`.current_system_version`, `.last_sync_version`) for monotonic versioning |
| 🔄 **Auto Dispatch** | Master HEARTBEAT detects version mismatch → dispatches to all agents via `sessions_send` or file fallback |
| 📝 **CHANGELOG-driven** | Structured `CHANGELOG.md` — read only latest section, not entire history |
| 🗄️ **Two-Phase Commit** | `.sync_journal.jsonl` ensures atomicity — PREPARE → DISPATCH → COMMIT |
| 🔍 **Offline Catch-Up** | Agents that miss sync cycles get cumulative catch-up packages |
| 🛡️ **Rollback** | Pre-sync snapshots + SHA256 verification for safe rollbacks |
| 🔒 **Dispatch Lock** | Prevents concurrent sync dispatch (< 2min window) |
| 🔁 **Loop Detection** | 3+ consecutive same-version → block and alert |
| 📦 **Batch Mode** | Merges rapid consecutive changes into single dispatch |
| 🏝️ **Self-Upgrade Isolation** | agent-config-sync's own files use isolated upgrade flow |
| 🌐 **Bilingual** | Full Chinese + English output (`--lang en|zh`) |
| 🎭 **Demo Mode** | `--demo` creates a full temp deployment for learning |
| 🔐 **Path Validation** | Only writes to `~/.openclaw/wo

_meta.json

{
  "ownerId": "kn7at24f2mbp2nzbvyprwbaws186t9g8",
  "slug": "agent-config-sync",
  "version": "1.5.1",
  "publishedAt": 1778918841603
}

references/agent-registry.json

{
  "version": "1.4.0",
  "comment": "Customize this file for your deployment — vars section + keyed agents object. v1.4 adds self_protect, batch, and sync configuration.",
  "vars": {
    "workspace_root": "~/.openclaw",
    "master_agent": "amaster",
    "master_memory": "${vars.workspace_root}/workspace-${vars.master_agent}/memory"
  },
  "agents": {
    "acode": {
      "name": "大师",
      "name_en": "Coding Agent",
      "role": "编程开发",
      "workspace": "${vars.workspace_root}/workspace-acode"
    },
    "ainvest": {
      "name": "元宝",
      "name_en": "Investment Agent",
      "role": "投资分析",
      "workspace": "${vars.workspace_root}/workspace-ainvest"
    },
    "alive": {
      "name": "牛奶",
      "name_en": "Assistant Agent",
      "role": "生活助理/写作",
      "workspace": "${vars.workspace_root}/workspace-alive"
    }
  },
  "sync": {
    "sentinel_dir": "memory",
    "journal_file": ".sync_journal.jsonl",
    "changelog_file": "CHANGELOG.md",
    "pending_prefix": "pending_sync",
    "max_changelog_sections": 10,
    "ttl_hours": 24,
    "dispatch_timeout_sec": 120
  },
  "self_protect": {
    "enabled": true,
    "skip_agents": ["agent-config-sync"],
    "isolated_sync": true,
    "blacklist": [
      "HEARTBEAT.md",
      "BOOTSTRAP.md",
      "SKILL.md",
      "scripts/",
      "SECURITY.md",
      "references/",
      "agent-registry.json"
    ],
    "sync_own_version_file": "skills/agent-config-sync/.sync_own_version",
    "allow_bootstrap_only": true
  },
  "batch": {
    "mode": "auto",
    "window_sec": 300
  }
}

references/agent-setup.md

# Per-Agent Auto-Sync Setup

For each agent workspace, create or append to these files:

## 1. SYNC.md (new file)

```markdown
# 配置同步机制 — 自动获取变更通知

## 检查入口
每次启动/激活时，先检查工作空间下的 `pending_sync.md` 是否存在且非空。

## 同步检查流程
```
启动/激活 → 检查工作目录存在 pending_sync.md?
  ├─ ✅ 有内容 → 读取变更摘要 → 更新本地 MEMORY.md
  │              → 根据变更内容更新本地配置
  │              → 删除 pending_sync.md（标记已处理）
  │              → 回复 AMaster 确认已同步
  └─ ❌ 无文件或空 → 无需同步
```

## 同步源
- 完整变更日志: `/home/admin/.openclaw/workspace-amaster/memory/CHANGELOG.md`
- 当前版本: `/home/admin/.openclaw/workspace-amaster/memory/.current_system_version`
- 主动查询: 可向 AMaster 询问最新版本状态

## 重要
- 使用量化交易系统 / 比价系统前，必须确认版本信息
- 如果有 pending_sync.md 但未处理，不要使用相关系统功能
```

## 2. BOOTSTRAP.md (append to end)

```markdown
## 启动检查 — 配置同步
- [ ] 检查工作目录下是否存在 `pending_sync.md`
  - 存在 → 读取变更摘要，更新 MEMORY.md，删除 pending_sync.md
  - 不存在 → 无需同步
- [ ] 使用量化系统/比价系统前先确认版本
```

## 3. HEARTBEAT.md (append to end)

```markdown
## ⭐ 配置同步检查（每次 heartbeat 执行）
- [ ] 检查工作目录下是否存在 `pending_sync.md`
  - 存在且非空 → 读取变更摘要，更新 MEMORY.md，删除文件
  - 不存在 → 跳过
```

Github ReposUpdated 3d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW

Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular