15 KiB
| id | pageType | updatedAt | sourceIds | tags | claims | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| concept-git-backup-recovery-protocol | concept | 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→ приватный Forgejohttps://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 timeropenclaw-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