Auto-sync 2026-09-26 13:30:02

This commit is contained in:
Sergey 2026-09-26 13:30:02 +00:00
parent b79b782ddc
commit 721281312e
4 changed files with 246 additions and 135 deletions

View file

@ -1,7 +1,7 @@
---
id: concept-git-backup-recovery-protocol
pageType: concept
updatedAt: 2026-09-24T21:02:00+03:00
updatedAt: 2026-09-26T16:15:48+03:00
sourceIds:
- source.agents
- source.memory
@ -10,36 +10,46 @@ tags:
- 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) и НЕ воспроизводить процедуру из памяти"
(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, §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"
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–20.3 (lines 459–508)"
updatedAt: "2026-09-24T20:57:49.604Z"
updatedAt: 2026-09-24T21:02:00+03:00
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'
@ -51,185 +61,286 @@ claims:
- 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"
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, 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"
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.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' → не создавать новое репо автоматически"
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.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 = оркестрация/рутинг/
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 = вердикт; main-agent НЕ самоверифицирует инфраструктурный
recovery; full procedure НЕ копируется в AGENTS.md/MEMORY.md
(context-minimization §20.11)"
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.10–20.11 (lines 694–732)"
updatedAt: "2026-09-24T20:57:49.604Z"
updatedAt: 2026-09-24T21:02:00+03:00
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 (auth, backup, commit/no-change, push, sync, scheduled
mechanisms для обоих слоёв); тест диагностический, НЕ должен менять инфраструктуру;
integration-test-run2.log = evidence базового теста, не operational truth"
успех = 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.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:
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 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
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.2 (line 473)"
updatedAt: "2026-09-24T20:57:49.604Z"
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, line 30"
updatedAt: "2026-09-24T20:58:10.382Z"
updatedAt: 2026-09-24T21:02:00+03:00
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
---
# 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.
Трёхслойный 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)
- **State Git** — бэкап внутреннего состояния OpenClaw (SQLite):
### Архитектура (§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`.
Статус по AGENTS.md: IMPLEMENTED / ACTIVE. Scope: `--all --include-secrets`
(политика специфична для State Git; на Config Git распространять нельзя).
Репозиторий PRIVATE и содержит credential-bearing backup material.
- **Config Git** — конфигурация, credentials, persistent workspace-файлы:
`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`.
Статус по 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 НЕ является полным бэкапом машины/системы.
Статус: 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)
24h State Git backup ACTIVE. Ключевое правило: активный scheduler entry — НИКОГДА
не доказательство успешного бэкапа; доказательство = `backup created + pushed=true`
или валидный `noChanges=true`. Сбой = pipeline degraded до диагностики + успешного прогона.
### Автоматический 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).
### Рутинг по интентам пользователя (§20.5–20.8)
### Безопасность 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» / «закоммить состояние» | 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» / «закоммить состояние» (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» — просмотр, НЕ 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 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» →
НЕ создавать новое репо автоматически, следовать канонической процедуре.
### 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.10–20.12)
- main-agent = оркестрация/рутинг/user approval/отчётность
### Ответственность и минимизация контекста (§20.19–20.20)
- main-agent = оркестрация/рутинг/user approval/отчётность (НЕ самоверификация
инфраструктурных мутаций)
- setup-agent = инфраструктурное исполнение (backup/restore/репозиторий)
- evaluator-agent = вердикт корректности (authoritative, без самоверификации main)
- evaluator-agent = вердикт корректности (authoritative)
- Полная процедура НЕ копируется в AGENTS.md / MEMORY.md; там только
routing/authority/safety-правила и стабильные final-state-факты.
- Mandatory Reference: любой интент backup/snapshot/restore/rollback/recovery →
сначала читать `OPENCLAW-GIT-BACKUP-RECOVERY.md`.
routing/authority/safety-правила и стабильные architectural facts.
### 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.
### Mandatory Reference Rule (§20.21)
Любой интент backup/snapshot/commit state/restore/rollback/recovery/disaster
recovery/recover OpenClaw|database|configuration|Obsidian → сначала читать
`OPENCLAW-GIT-BACKUP-RECOVERY.md`.
### 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.
### 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

View file

@ -1,7 +1,7 @@
---
id: entity-Infrastructure
pageType: entity
updatedAt: 2026-09-10T04:50:00.000Z
updatedAt: 2026-09-26T16:17:10+03:00
confidence: 0.9
status: active
sourceIds:
@ -327,7 +327,7 @@ claims:
- Diagnostic Command Convention (§18, AGENTS.md 2026-08-22): read-only verification chains (grep, head, wc, ls, file-existence checks, diff-checks) MUST end with neutral exit (`; true` / `|| true`) so "no match" is valid result not Exec failed; exit codes of mutation/build/deploy/sync commands must NEVER be masked
- Ingest self-loop root fix (2026-08-22, user decision): volatile wiki state (page/claim counts, lint counts, last-ingest timestamps, bridge artifact counts) НЕ пишется в MEMORY.md и source-файлы — источник: CHANGELOG.md + concepts/Bridge-Mode.md; правило закреплено: AGENTS.md §16 «Volatile-state ban» + constraint в payload cron wiki-ingest-event; причина: такие записи сами бампали mtime MEMORY.md → cron (30m) видел «изменение источника» → idempotent self-loop (2026-08-22: 6 циклов 00:32→08:09 при semantic delta=0)
- north-mini-code-1.0 CANCELLED (2026-08-22, user decision): не устанавливать, не использовать; на Dell Precision 5560 (Ollama, 18 моделей) не установлен; решение закрыло 3-дневное ожидание установки (08-19→08-22) и план 3-модельного coding-теста
- OpenClaw Git backup/recovery (AGENTS.md §20, 2026-09-24): два слоя — State Git `/home/owner/openclaw-backup/state-repo` → приватный Forgejo `Sergey/openclaw-clawpi-state` (scope `--all --include-secrets`, 24h автоматический backup ACTIVE) + Config Git `/home/owner/openclaw-backup/repo` → `Sergey/openclaw-clawpi` (24h через `systemd --user` timer `openclaw-config-backup.timer`, live-active 2026-09-24); AGENTS.md §20.2 при этом помечает Config Git «NOT YET COMPLETED» — contradicts MEMORY.md/канон-дока, открытый вопрос; канонический операционный документ — `OPENCLAW-GIT-BACKUP-RECOVERY.md`; интеграционный тест `integration-test-git-backups.sh` (успех = PASS/FAIL=0); full recovery = State + Config Git; детали — concepts/Git-Backup-Recovery-Protocol.md
- OpenClaw Git backup/recovery (AGENTS.md §20, трёхслойная архитектура, final state 2026-09-26 по §20.23): State Git `/home/owner/openclaw-backup/state-repo` → приватный Forgejo `Sergey/openclaw-clawpi-state` (native `openclaw backup git`, `--all --include-secrets --push`, 24h автоматический backup ACTIVE) + Config Git `/home/owner/openclaw-backup/repo` → `Sergey/openclaw-clawpi` (24h через `systemd --user` timer, отдельные credentials `OPENCLAW_CONFIG_GIT_TOKEN` + временный `GIT_ASKPASS`) + Obsidian Git `/home/owner/obsidian-vault` → `Sergey/obsidian-vault` (host cron */15 → Docker `obsidian-git-sync`, SSH Ed25519 Deploy Key, dedicated `known_hosts`, host `~/.git-credentials` не монтируется в контейнер); три слоя независимы и НЕ объединяются в один backup repository; противоречие 2026-09-24 про Config Git «NOT YET COMPLETED» разрешено — AGENTS.md §20.5/§20.23 (2026-09-26) помечает Config Git IMPLEMENTED/ACTIVE, все три слоя ACTIVE/operational; канонический операционный документ — `OPENCLAW-GIT-BACKUP-RECOVERY.md`; интеграционный тест `integration-test-git-backups.sh` (успех = PASS/FAIL=0; валидирует State+Config Git, Obsidian Git проверяется отдельно); full recovery = State + Config + Obsidian Git; детали — concepts/Git-Backup-Recovery-Protocol.md
- Pi-hole (FTL v6) на clawpi (проверено 2026-08-24): контейнер pihole (docker на clawpi, healthy); Web UI http://192.168.1.20:8080/admin, DNS 192.168.1.20:53; версии Core v6.4.3, Web v6.6, FTL v6.7 (снимок 2026-08-24)
- Pi-hole v6 аутентификация: пароль Web UI = env `FTLCONF_webserver_api_password` контейнера (значение НЕ фиксируется в wiki/CHANGELOG/MEMORY.md — файлы синкаются в Nextcloud); хеш `pwhash` (BALLOON-SHA256) в /etc/pihole/pihole.toml; `setupVars.conf` в v6 отсутствует (заменён pihole.toml)
- Pi-hole API-логин: POST /api/auth JSON `{"password":"*** env FTLCONF_webserver_api_password>","totp":null}` → session.sid; дальнейшие запросы — с сессионным cookie; проверено 2026-08-24: логин через Web UI (браузер) и API (200 + SID) — работает. Внимание: локальная проверка BALLOON-SHA256 в чистом Python дала ложный NO MATCH (сломанный test-vector в реализации) — верификацию пароля делать только через живой API

View file

@ -4,7 +4,7 @@
<!-- openclaw:wiki:index:start -->
- Render mode: `native`
- Total pages: 79
- Claims: 162
- Claims: 163
- Sources: 36
- Entities: 11
- Concepts: 13

View file

@ -3,23 +3,23 @@ pageType: report
id: report.provenance-coverage
title: Provenance Coverage
status: active
updatedAt: 2026-09-24T21:15:40.281Z
updatedAt: 2026-09-26T13:17:28.017Z
---
# Provenance Coverage
## Generated
<!-- openclaw:wiki:provenance-coverage:start -->
- Evidence entries: 189
- Evidence entries: 194
- Claims missing evidence: 0
### Evidence Classes
- source-file: 188
- source-file: 193
- file: 1
### Top Evidence Sources
- source.memory: 87
- source.agents: 30
- source.memory: 90
- source.agents: 32
- source.bridge-workspace-4c6d747f-memory-2d62c497: 22
- source.user: 18
- source.embedding-trading: 14