--- id: concept-git-backup-recovery-protocol pageType: concept updatedAt: 2026-09-24T21:02:00+03:00 sourceIds: - source.agents - source.memory tags: - git-backup - recovery - state-git - config-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) и НЕ воспроизводить процедуру из памяти" status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md lines: "AGENTS.md §20.1, §20.12 (lines 437–760)" updatedAt: "2026-09-24T20:57:49.604Z" updatedAt: 2026-09-24T21:02:00+03:00 - text: "Двухслойная архитектура: State Git (/home/owner/openclaw-backup/state-repo, приватный Forgejo Sergey/openclaw-clawpi-state, scope --all --include-secrets) + Config Git (/home/owner/openclaw-backup/repo, Sergey/openclaw-clawpi); слои НЕ равнозначны и НЕ заменяют друг друга; full recovery требует обоих; --include-secrets — политика State Git, НЕ распространяется на Config Git" status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md lines: "AGENTS.md §20.2–20.3 (lines 459–508)" updatedAt: "2026-09-24T20:57:49.604Z" updatedAt: 2026-09-24T21:02:00+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 510–536)" updatedAt: "2026-09-24T20:57:49.604Z" - kind: source-file sourceId: source.memory path: sources/memory.md lines: "MEMORY.md §3, line 30 (OpenClaw Git Backup / Recovery)" updatedAt: "2026-09-24T20:58:10.382Z" updatedAt: 2026-09-24T21:02:00+03:00 - text: "Рутинг интентов: 'сделай backup/закоммить состояние' → State Git backup (--all --push) через setup-agent + верификация evaluator-agent; 'покажи backup' → setup-agent; 'проверь backup' → setup-agent → evaluator-agent; 'откати/восстанови' → destructive (exact SHA, верификация снапшота, safety-backup live state, остановка Gateway перед заменой БД, staged restore, post-restore validation, health-check, новый backup после); 'восстанови всю систему' → Config Git + State Git; 'посмотри предыдущий backup' ≠ rollback" status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md lines: "AGENTS.md §20.5–20.8 (lines 538–659)" updatedAt: "2026-09-24T20:57:49.604Z" updatedAt: 2026-09-24T21:02:00+03:00 - text: "State Git safety rules (§20.9): никаких ordinary commits и non-backup-файлов (README.md — исторический контент, не трогать), без git reset --hard как замены restore, без замены БД при работающем Gateway, без restore без верификации и safety-copy, без автоудаления истории/legacy-БД, без автореактивации репо, без публичного экспорта, без history rewrite без approval; 'non-backup commits' → не создавать новое репо автоматически" status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md lines: "AGENTS.md §20.9 (lines 661–692)" updatedAt: "2026-09-24T20:57:49.604Z" updatedAt: 2026-09-24T21:02:00+03:00 - text: "Separation of Responsibilities (§20.10): main-agent = оркестрация/рутинг/ approval/отчёты, setup-agent = инфраструктурное исполнение, evaluator-agent = вердикт; main-agent НЕ самоверифицирует инфраструктурный recovery; full procedure НЕ копируется в AGENTS.md/MEMORY.md (context-minimization §20.11)" status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md lines: "AGENTS.md §20.10–20.11 (lines 694–732)" updatedAt: "2026-09-24T20:57:49.604Z" updatedAt: 2026-09-24T21:02:00+03:00 - text: "Integration test: /home/owner/openclaw-backup/integration-test-git-backups.sh — успех = PASS / FAIL=0 (auth, backup, commit/no-change, push, sync, scheduled mechanisms для обоих слоёв); тест диагностический, НЕ должен менять инфраструктуру; integration-test-run2.log = evidence базового теста, не operational truth" status: supported confidence: 0.95 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md lines: "AGENTS.md §20.13 (lines 760–766)" updatedAt: "2026-09-24T20:57:49.604Z" updatedAt: 2026-09-24T21:02:00+03:00 - text: "Final state (MEMORY.md 2026-09-24): 24h State Git backup active; 24h Config Git backup через systemd --user timer active; полный recovery = State Git + Config Git; интеграционный тест прошёл PASS / FAIL=0; operational truth — Git-репозитории, результаты бэкапов, Config Git timer, State Git automation" status: supported confidence: 0.9 evidence: - kind: source-file sourceId: source.memory path: sources/memory.md lines: "MEMORY.md §3, line 30 (OpenClaw Git Backup / Recovery)" updatedAt: "2026-09-24T20:58:10.382Z" updatedAt: 2026-09-24T21:02:00+03:00 - text: "КОНТРАДИКЦИЯ (открытый вопрос): AGENTS.md §20.2 помечает Config Git как 'ARCHITECTURE DEFINED / CONFIGURATION NOT YET COMPLETED', при этом MEMORY.md, канонический документ (timer IMPLEMENTED/ACTIVE) и live-проверка 2026-09-24 (openclaw-config-backup.timer active, config-git-backup.sh существует, последний trigger 2026-09-24 04:35 MSK) указывают на реализованную 24h-автоматизацию Config Git; до явного решения владельца Config Git НЕ считается операционным recovery-источником (правило §20.2 в силе)" status: disputed confidence: 0.6 evidence: - kind: source-file sourceId: source.agents path: sources/agents.md lines: "AGENTS.md §20.2 (line 473)" updatedAt: "2026-09-24T20:57:49.604Z" - kind: source-file sourceId: source.memory path: sources/memory.md lines: "MEMORY.md §3, line 30" updatedAt: "2026-09-24T20:58:10.382Z" updatedAt: 2026-09-24T21:02:00+03:00 --- # Concept: Git Backup & Recovery Protocol (AGENTS.md §20) ## Summary Двухслойный Git-бэкап OpenClaw (State Git + Config Git) с жёстким разделением ролей: канонический операционный документ — `OPENCLAW-GIT-BACKUP-RECOVERY.md`; main-agent никогда не исполняет инфраструктурные команды и не самоверифицируется — исполнение делегировано setup-agent, вердикт корректности — evaluator-agent. ## Description ### Архитектура (§20.2–20.3) - **State Git** — бэкап внутреннего состояния OpenClaw (SQLite): `/home/owner/openclaw-backup/state-repo` → приватный Forgejo `https://git.datacloudport.ru/Sergey/openclaw-clawpi-state.git`. Статус по AGENTS.md: IMPLEMENTED / ACTIVE. Scope: `--all --include-secrets` (политика специфична для State Git; на Config Git распространять нельзя). Репозиторий PRIVATE и содержит credential-bearing backup material. - **Config Git** — конфигурация, credentials, persistent workspace-файлы: `/home/owner/openclaw-backup/repo` → `https://git.datacloudport.ru/Sergey/openclaw-clawpi.git`. Статус по AGENTS.md §20.2: ARCHITECTURE DEFINED / CONFIGURATION NOT YET COMPLETED — **противоречит** MEMORY.md и каноническому документу, где 24h timer `openclaw-config-backup.timer` отмечен IMPLEMENTED/ACTIVE; live-проверка 2026-09-24: timer active (next trigger 2026-09-25 04:31 MSK), `config-git-backup.sh` (600) существует. До явной верификации Config Git НЕ является операционным recovery-источником. - Слой ≠ слой: State Git alone НЕ является полным бэкапом машины/системы. ### Автоматический backup (§20.4) 24h State Git backup ACTIVE. Ключевое правило: активный scheduler entry — НИКОГДА не доказательство успешного бэкапа; доказательство = `backup created + pushed=true` или валидный `noChanges=true`. Сбой = pipeline degraded до диагностики + успешного прогона. ### Рутинг по интентам пользователя (§20.5–20.8) | Интент | Маршрут | Ключевые требования | |---|---|---| | «сделай backup» / «закоммить состояние» | main → setup-agent → evaluator-agent | canonical doc → `--all --push` → верификация → отчёт commit/noChanges/pushed | | «покажи backup» | main → setup-agent | история по каноническому документу | | «проверь backup» | main → setup-agent → evaluator-agent | commit ≠ валидность; внешний успех = push; restore-eligibility = прохождение верификации снапшота | | «откати» / «восстанови из backup» | main → setup-agent → evaluator-agent | destructive: явный запрос, exact SHA, верификация снапшота, safety-backup live state, остановка Gateway, staged restore, post-restore validation, health-check, новый backup | | «восстанови всю систему» | main → setup-agent → evaluator-agent | Config Git + State Git; последовательность ТОЛЬКО в каноническом документе | «Посмотри предыдущий backup» — просмотр, НЕ rollback; эти действия не тождественны. ### Safety rules State Git (§20.9) Никаких ordinary commits/non-backup-файлов (наследственный README.md — исторический контент, не изменять/не удалять); без `git reset --hard` как замены OpenClaw restore; без деструктивной замены БД при работающем Gateway; без restore без верификации и без safety-copy live state; без автоудаления backup-истории и legacy-БД; без автореактивации репозитория; без публичного экспорта; без history rewrite без явного approval. Отчёт «repository history contains non-backup commits» → НЕ создавать новое репо автоматически, следовать канонической процедуре. ### Ответственность и минимизация контекста (§20.10–20.12) - main-agent = оркестрация/рутинг/user approval/отчётность - setup-agent = инфраструктурное исполнение (backup/restore/репозиторий) - evaluator-agent = вердикт корректности (authoritative, без самоверификации main) - Полная процедура НЕ копируется в AGENTS.md / MEMORY.md; там только routing/authority/safety-правила и стабильные final-state-факты. - Mandatory Reference: любой интент backup/snapshot/restore/rollback/recovery → сначала читать `OPENCLAW-GIT-BACKUP-RECOVERY.md`. ### Integration test (§20.13) `/home/owner/openclaw-backup/integration-test-git-backups.sh`: успех = `PASS / FAIL=0` (аутентификация, backup, commit/no-change, push, sync, scheduled mechanisms — оба слоя). Тест диагностический: не модифицирует инфраструктуру, credentials, remotes, automation, историю. Детальный вывод `integration-test-run2.log` — evidence успешного базового теста, НЕ operational source of truth. ### Final state (MEMORY.md, 2026-09-24) State Git: 24h автоматический backup — active. Config Git: 24h автоматический backup через `systemd --user` timer — active (live-подтверждено 2026-09-24). Полный recovery использует оба слоя. Интеграционный тест: PASS / FAIL=0. Operational truth — Git-репозитории, результаты бэкапов OpenClaw, Config Git timer, State Git automation. ## Tags - git-backup - recovery - state-git - config-git - disaster-recovery - openclaw ## Sources - [[AGENTS.md]] - [[MEMORY.md]] ## Related