--- id: concept-git-backup-recovery-protocol pageType: concept updatedAt: 2026-10-30T00:20:00+03:00 sourceIds: - source.agents - source.memory tags: - git-backup - recovery - state-git - config-git - obsidian-git - disaster-recovery - openclaw claims: - text: "Канонический операционный документ Git backup/recovery — /home/owner/.openclaw/workspace/OPENCLAW-GIT-BACKUP-RECOVERY.md: main-agent ОБЯЗАН читать его перед любой задачей backup/rollback/restore/recovery (Mandatory Reference Rule, §20.21) и НЕ воспроизводить процедуру из памяти" status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md lines: "AGENTS.md §20.1 (lines 460–482), §20.21 (lines 1146–1174)" updatedAt: "2026-09-26T11:54:39.969Z" updatedAt: 2026-09-26T16:15:48+03:00 - text: "Трёхслойная архитектура: State Git (/home/owner/openclaw-backup/state-repo, приватный Forgejo Sergey/openclaw-clawpi-state, native openclaw backup git с scope --all --include-secrets --push) + Config Git (/home/owner/openclaw-backup/repo, Sergey/openclaw-clawpi, отдельные credentials OPENCLAW_CONFIG_GIT_TOKEN + временный GIT_ASKPASS) + Obsidian Git (/home/owner/obsidian-vault, Sergey/obsidian-vault); три независимых репозитория с независимыми lifecycle/recovery-механизмами; НЕ объединяются в один backup repository; успешный backup одного слоя НЕ является успехом остальных; --include-secrets — политика только State Git; статус по §20.23 (2026-09-26): все слои ACTIVE" status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md lines: "AGENTS.md §20.2 (lines 484–515), §20.3 (lines 517–561), §20.5 (lines 599–653), §20.7 (lines 683–734), §20.23 (lines 1226–1260)" updatedAt: "2026-09-26T11:54:39.969Z" - kind: source-file sourceId: source.memory path: sources/memory.md lines: "MEMORY.md §3, lines 52–58 (OpenClaw Git Backup / Recovery)" updatedAt: "2026-09-26T11:56:18.417Z" updatedAt: 2026-09-26T16:15:48+03:00 - text: "24h автоматический State Git backup ACTIVE — production-механизм, отключать только по явному приказу пользователя; 'автоматизация включена' ≠ 'backup успешен': здоровье доказывают 'backup created + pushed=true' или валидный 'noChanges=true'; сбой расписания = degraded pipeline до диагностики и успешного прогона" status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md lines: "AGENTS.md §20.4 (lines 563–597)" updatedAt: "2026-09-26T11:54:39.969Z" - kind: source-file sourceId: source.memory path: sources/memory.md lines: "MEMORY.md §3, lines 52–54 (OpenClaw Git Backup / Recovery, State Git)" updatedAt: "2026-09-26T11:56:18.417Z" updatedAt: 2026-09-26T16:15:48+03:00 - text: "Obsidian Git (третий независимый слой): host cron */15 → /usr/local/bin/obsidian-docker-sync.sh → Docker obsidian-git-sync (commit+push только при изменениях, лог /home/owner/obsidian-sync.log); SSH Ed25519 Deploy Key /home/owner/.ssh/obsidian-vault-sync (Write Access) + dedicated known_hosts /home/owner/.ssh/obsidian-vault-known_hosts, IdentitiesOnly=yes, StrictHostKeyChecking=yes, BatchMode=yes; host ~/.git-credentials НЕ используется для аутентификации и НЕ монтируется в Docker-контейнер; concurrency protection — flock /tmp/obsidian-docker-sync.lock (конкурентный запуск завершается без изменений репозитория); НЕ часть native openclaw backup git; независимый lifecycle и recovery" status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md lines: "AGENTS.md §20.7 (lines 683–734), §20.8 (lines 736–791), §20.9 (lines 793–833), §20.10 (lines 835–848)" updatedAt: "2026-09-26T11:54:39.969Z" - kind: source-file sourceId: source.memory path: sources/memory.md lines: "MEMORY.md §3, lines 56, 60, 62 (Obsidian Git)" updatedAt: "2026-09-26T11:56:18.417Z" updatedAt: 2026-09-26T16:15:48+03:00 - text: "Рутинг интентов (§20.11–20.16): 'сделай backup/закоммить состояние' (default) → State Git backup (--all + push) через setup-agent + верификация evaluator-agent; явный 'Config backup' → Config Git; явный 'сохрани Obsidian' → Obsidian Git; 'проверь Obsidian backup' → cron → фактическое исполнение скрипта → результат синхронизации → local/remote HEAD (наличие cron-записи само по себе НЕ доказательство); 'полный backup' → все три слоя, каждый слой отчитывается отдельно (SUCCESS/NO CHANGES/FAILED; частичный результат ≠ полный успех); 'откати/восстанови' → destructive (exact revision, верификация снапшота, safety-backup live state, остановка Gateway перед заменой БД, staged restore, post-restore validation, health-check, новый backup); 'восстанови всю систему' → State + Config + Obsidian Git (последовательность ТОЛЬКО в каноническом документе); 'покажи предыдущий backup' — просмотр, НЕ rollback" status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md lines: "AGENTS.md §20.11–20.16 (lines 851–1047)" updatedAt: "2026-09-26T11:54:39.969Z" updatedAt: 2026-09-26T16:15:48+03:00 - text: "State Git safety rules (§20.17): никаких ordinary commits и non-backup-файлов, без git reset --hard как замены OpenClaw restore, без замены live-БД при работающем Gateway, без restore без верификации снапшота и без safety-copy live state, без автоудаления backup-истории/legacy-БД, без авторекреации репозитория, без публичного экспорта, без history rewrite без явного user approval; 'non-backup commits' → НЕ создавать новое репо автоматически, следовать канонической процедуре; Obsidian Git safety rules (§20.18): запрет авто-удаления репо/.git, git init, git reset --hard, git push --force, замены Forgejo-репозитория, перезаписи remote-истории; сбой синхронизации НЕ является причиной рекреации репозитория" status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md lines: "AGENTS.md §20.17 (lines 1049–1075), §20.18 (lines 1077–1095)" updatedAt: "2026-09-26T11:54:39.969Z" updatedAt: 2026-09-26T16:15:48+03:00 - text: "Separation of Responsibilities (§20.19): main-agent = оркестрация/рутинг/ approval/отчёты, setup-agent = инфраструктурное исполнение, evaluator-agent = вердикт корректности (authoritative); main-agent НЕ самоверифицирует инфраструктурные изменения; полная процедура НЕ копируется в AGENTS.md/MEMORY.md (context-minimization §20.20) — там только routing/authority/safety-правила и стабильные architectural facts" status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md lines: "AGENTS.md §20.19–20.20 (lines 1097–1144)" updatedAt: "2026-09-26T11:54:39.969Z" updatedAt: 2026-09-26T16:15:48+03:00 - text: "Integration test: /home/owner/openclaw-backup/integration-test-git-backups.sh — успех = PASS / FAIL=0; валидирует State Git и Config Git (authentication, backup, commit/no-change handling, push, local/remote synchronization, scheduled mechanisms); тест диагностический, НЕ должен менять инфраструктуру/credentials/remotes/automation/историю; integration-test-run2.log = evidence базового теста, не operational truth; Obsidian Git проверяется отдельно из-за независимого lifecycle и synchronization-механизма" status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md lines: "AGENTS.md §20.22 (lines 1176–1224)" updatedAt: "2026-09-26T11:54:39.969Z" - kind: source-file sourceId: source.memory path: sources/memory.md lines: "MEMORY.md §3, line 64 (Integration test, Obsidian Git отдельно)" updatedAt: "2026-09-26T11:56:18.417Z" updatedAt: 2026-09-26T16:15:48+03:00 - text: "Final state (2026-09-26, AGENTS.md §20.23 + MEMORY.md §3): все три слоя ACTIVE/operational, private Forgejo, независимы — State Git (24h, native openclaw backup git, --all --include-secrets --push), Config Git (24h, systemd --user timer, отдельные credentials), Obsidian Git (cron */15, Docker-синхронизация, SSH Deploy Key); integration test ранее прошёл PASS / FAIL=0 (State+Config); operational truth — Git-репозитории, результаты бэкапов, automation (timer/cron)" status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md lines: "AGENTS.md §20.23 (lines 1226–1260)" updatedAt: "2026-09-26T11:54:39.969Z" - kind: source-file sourceId: source.memory path: sources/memory.md lines: "MEMORY.md §3, lines 52–66 (OpenClaw Git Backup / Recovery)" updatedAt: "2026-09-26T11:56:18.417Z" updatedAt: 2026-09-26T16:15:48+03:00 - text: "РАЗРЕШЁННОЕ противоречие (было открытым на 2026-09-24): старый AGENTS.md §20.2 помечал Config Git как 'ARCHITECTURE DEFINED / CONFIGURATION NOT YET COMPLETED', при этом MEMORY.md и канонический документ указывали на реализованную 24h-автоматизацию; переписанный AGENTS.md (2026-09-26) разрешает противоречие: §20.5 помечает Config Git IMPLEMENTED / ACTIVE (backup/restore-скрипты, systemd user timer), §20.23 (2026-09-26) помечает все три слоя ACTIVE/operational" status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md lines: "AGENTS.md §20.5 (lines 599–653, line 625 IMPLEMENTED / ACTIVE), §20.23 (lines 1238–1241)" updatedAt: "2026-09-26T11:54:39.969Z" - kind: source-file sourceId: source.memory path: sources/memory.md lines: "MEMORY.md §3, line 55 (Config Git, systemd --user timer)" updatedAt: "2026-09-26T11:56:18.417Z" updatedAt: 2026-09-26T16:15:48+03:00 - text: "Инцидент 2026-10-29 (Obsidian Git layer): Docker-образ obsidian-git-sync (третий слой, host cron */15 -> Docker) потерян ~вечером 2026-10-29 и восстановлен 2026-10-29 (MEMORY.md Sec.3, line 46); после восстановления pipeline синхронизации /home/owner/obsidian-vault -> git@git.datacloudport.ru:Sergey/obsidian-vault.git операционен; final state (2026-10-30): все три слоя backup ACTIVE/operational" status: verified confidence: 0.95 evidence: - kind: source-file sourceId: source.memory path: sources/memory.md lines: "MEMORY.md §3, line 46 (Obsidian Git, Docker obsidian-git-sync, restoration 2026-10-29)" updatedAt: "2026-10-29T21:19:28.703Z" updatedAt: 2026-10-30T00:20:00+03:00 --- # Concept: Git Backup & Recovery Protocol (AGENTS.md §20) ## Summary Трёхслойный Git-бэкап OpenClaw (State Git + Config Git + Obsidian Git) с жёстким разделением ролей: канонический операционный документ — `OPENCLAW-GIT-BACKUP-RECOVERY.md`; main-agent никогда не исполняет инфраструктурные команды и не самоверифицируется — исполнение делегировано setup-agent, вердикт корректности — evaluator-agent. Статус 2026-09-26 (§20.23): все три слоя ACTIVE/operational, private Forgejo, независимы. ## Description ### Архитектура (§20.2, 20.3, 20.5, 20.7) Три независимых Git-слоя — три независимых репозитория и три независимых lifecycle/recovery-механизма. Слои MUST NOT объединяться в один backup repository; успешный backup одного слоя MUST NOT сообщаться как успех остальных слоёв. - **State Git** — внутреннее состояние OpenClaw (SQLite): `/home/owner/openclaw-backup/state-repo` → приватный Forgejo `https://git.datacloudport.ru/Sergey/openclaw-clawpi-state.git`. Статус: IMPLEMENTED / ACTIVE. Native `openclaw backup git` с scope `--all --include-secrets --push`; `--include-secrets` — политика ТОЛЬКО State Git, НЕ распространяется на Config/Obsidian Git. Репозиторий PRIVATE и содержит credential-bearing backup material. - **Config Git** — конфигурация, credentials, selected persistent-файлы: `/home/owner/openclaw-backup/repo` → `https://git.datacloudport.ru/Sergey/openclaw-clawpi.git`. Статус: IMPLEMENTED / ACTIVE (§20.5). Скрипты `config-git-backup.sh` / `config-git-restore.sh`; автоматизация — systemd user timer `openclaw-config-backup.{service,timer}`. Независим от State Git; отдельные credentials (§20.6: `OPENCLAW_CONFIG_GIT_TOKEN` в `/home/owner/.openclaw/.env` + временный `GIT_ASKPASS`, временное auth-состояние чистится после исполнения); НЕ заменяется native State Git backup. - **Obsidian Git** — knowledge vault / Markdown / документация: `/home/owner/obsidian-vault` → `git@git.datacloudport.ru:Sergey/obsidian-vault.git`. Статус: IMPLEMENTED / ACTIVE (§20.7). НЕ является частью State Git и Config Git; MUST NOT добавляться в native `openclaw backup git` pipeline. ### Автоматический backup (§20.4, 20.5, 20.8) - **State Git**: 24h OpenClaw scheduled backup — production-механизм, отключается только по явному приказу пользователя. Ключевое правило: активный scheduler entry — НИКОГДА не доказательство успешного бэкапа; доказательство = `backup created + pushed=true` или валидный `noChanges=true`. Сбой = pipeline degraded до диагностики + успешного прогона. - **Config Git**: 24h через `systemd --user` timer `openclaw-config-backup.timer`. - **Obsidian Git**: host cron `*/15 * * * *` → `/usr/local/bin/obsidian-docker-sync.sh` → Docker `obsidian-git-sync` → при изменениях: commit + push (лог `/home/owner/obsidian-sync.log`); без изменений — commit не создаётся («Нет изменений.»). Concurrency protection: `flock` на `/tmp/obsidian-docker-sync.lock`; конкурентный запуск MUST завершиться без изменений репозитория (§20.10). ### Безопасность Obsidian Git (§20.9) Dedicated SSH Ed25519 key `/home/owner/.ssh/obsidian-vault-sync` (Forgejo Deploy Key с Write Access); dedicated `known_hosts` `/home/owner/.ssh/obsidian-vault-known_hosts`; `IdentitiesOnly=yes`, `StrictHostKeyChecking=yes`, `BatchMode=yes`; host `~/.git-credentials` MUST NOT использоваться для аутентификации и MUST NOT монтироваться в Docker-контейнер; пароли/токены MUST NOT встроены в `obsidian-docker-sync.sh`. ### Рутинг по интентам пользователя (§20.11–20.16) | Интент | Маршрут | Ключевые требования | |---|---|---| | «сделай backup» / «закоммить состояние» (default) | main → setup-agent → evaluator-agent | canonical doc → State Git `--all` + push → верификация → отчёт | | «Config backup» (явно) | main → setup-agent → evaluator-agent | Config Git по каноническому документу | | «сохрани Obsidian» / «сделай backup Obsidian» (явно) | main → setup-agent → evaluator-agent | Obsidian Git | | «проверь Obsidian backup» | main → setup-agent → evaluator-agent | cron → фактическое исполнение скрипта → результат синхронизации → local HEAD → remote HEAD; наличие cron-записи ≠ успех | | «полный backup» | main → setup-agent → evaluator-agent | все три слоя (State + Config + Obsidian); каждый слой отчитывается отдельно (SUCCESS / NO CHANGES / FAILED); частичный результат ≠ «полный backup успешен» | | «откати» / «восстанови из backup» | main → setup-agent → evaluator-agent | destructive: явный запрос, exact revision, canonical doc, верификация снапшота, safety-copy live state, остановка Gateway, staged restore, post-restore validation, health-check, новый backup | | «восстанови всю систему» | main → setup-agent → evaluator-agent | Full System Recovery = State + Config + Obsidian Git (§20.16); последовательность ТОЛЬКО в каноническом документе | | «покажи/посмотри предыдущий backup» | main → setup-agent | только просмотр; НЕ интерпретировать как rollback | Backup Verification (§20.14): активный scheduler — недостаточное доказательство; верификация только по фактическому execution evidence: State Git — backup result / pushed=true / noChanges=true; Config Git — исполнение скрипта, commit/no-change, push, local/remote sync; Obsidian Git — исполнение cron, результат скрипта, local/remote HEAD. При проблемах синхронизации авторитетно состояние remote-репозитория. ### Safety rules (State §20.17, Obsidian §20.18) - **State Git**: никаких ordinary commits и non-backup-файлов; без `git reset --hard` как замены OpenClaw restore; без замены live-БД при работающем Gateway; без restore без верификации снапшота и без safety-copy live state; без автоудаления backup-истории и legacy-БД; без авторекреации репозитория; без публичного экспорта; без history rewrite без явного user approval. Отчёт «repository history contains non-backup commits» → НЕ создавать новое репо автоматически, следовать канонической процедуре. - **Obsidian Git**: MUST NOT автоматически — удалять репозиторий/`.git`, `git init`, `git reset --hard`, `git push --force`, заменять Forgejo-репозиторий, переписывать remote-историю. Сбой синхронизации НЕ является причиной рекреации репозитория: сохранить локальное репо и сначала определить точный сбой. ### Ответственность и минимизация контекста (§20.19–20.20) - main-agent = оркестрация/рутинг/user approval/отчётность (НЕ самоверификация инфраструктурных мутаций) - setup-agent = инфраструктурное исполнение (backup/restore/репозиторий) - evaluator-agent = вердикт корректности (authoritative) - Полная процедура НЕ копируется в AGENTS.md / MEMORY.md; там только routing/authority/safety-правила и стабильные architectural facts. ### Mandatory Reference Rule (§20.21) Любой интент backup/snapshot/commit state/restore/rollback/recovery/disaster recovery/recover OpenClaw|database|configuration|Obsidian → сначала читать `OPENCLAW-GIT-BACKUP-RECOVERY.md`. ### Integration test (§20.22) `/home/owner/openclaw-backup/integration-test-git-backups.sh`: успех = `PASS / FAIL=0`. Валидирует State Git и Config Git (аутентификация, backup, commit/no-change handling, push, local/remote synchronization, scheduled mechanisms). Тест диагностический: НЕ модифицирует инфраструктуру, credentials, remotes, automation, историю. Детальный вывод `integration-test-run2.log` — evidence успешного базового теста, НЕ operational source of truth. Obsidian Git проверяется отдельно — независимый lifecycle и synchronization-механизм. ### Final state (§20.23, 2026-09-26) Все три слоя ACTIVE/operational, private Forgejo, независимы: - **State Git**: ACTIVE, каждые 24h (native OpenClaw backup). - **Config Git**: ACTIVE, systemd user timer. - **Obsidian Git**: ACTIVE, cron */15, Docker-синхронизация, SSH Deploy Key. Противоречие 2026-09-24 про Config Git («NOT YET COMPLETED») разрешено: переписанный AGENTS.md §20.5 помечает Config Git IMPLEMENTED / ACTIVE, §20.23 (2026-09-26) — все слои ACTIVE. Operational truth — Git-репозитории, результаты бэкапов, automation (timer/cron). ## Tags - git-backup - recovery - state-git - config-git - obsidian-git - disaster-recovery - openclaw ## Sources - [[AGENTS.md]] - [[MEMORY.md]] ## Related ### Sources - [AGENTS](../sources/agents.md) - [MEMORY](../sources/memory.md) ### Related Pages - [Concept: Eurostela SEO Endpoint (MCP SEO Endpoint)](Eurostela-SEO-Endpoint.md) - [Entity: Eurostela (евростела.ru)](../entities/eurostela.md) - [Entity: Infrastructure](../entities/Infrastructure.md) - [Pg-Boss Queue & AI Inference Worker](../syntheses/pg-boss-queue-ai-inference-worker.md) - [Travel Automation (Mail Scan Pipeline)](../syntheses/travel-automation-mail-scan-pipeline.md) - [Travel Documents: Registry, Scans, NC Mirror](../syntheses/travel-documents-registry-scans-nc-mirror.md) - [Travel Rule: Trip Calendar & Transport (Sergey 2026-11-04)](../syntheses/travel-rule-trip-calendar-transport-sergey-2026-11-04.md)