24 KiB
| id | pageType | updatedAt | sourceIds | tags | claims | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| concept-git-backup-recovery-protocol | concept | 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→ приватный Forgejohttps://git.datacloudport.ru/Sergey/openclaw-clawpi-state.git. Статус: IMPLEMENTED / ACTIVE. Nativeopenclaw 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 timeropenclaw-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 добавляться в nativeopenclaw backup gitpipeline.
Автоматический 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 --usertimeropenclaw-config-backup.timer. - Obsidian Git: host cron
*/15 * * * *→/usr/local/bin/obsidian-docker-sync.sh→ Dockerobsidian-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