44 KiB
44 KiB
| pageType | id | title | sourceType | sourcePath | ingestedAt | updatedAt | status |
|---|---|---|---|---|---|---|---|
| source | source.memory | MEMORY | local-file | /home/owner/.openclaw/workspace/MEMORY.md | 2026-09-06T16:39:03.000Z | 2026-09-06T16:39:03.000Z | active |
MEMORY
Source
- Type:
local-file - Path:
/home/owner/.openclaw/workspace/MEMORY.md - Bytes: 43290
- Updated: 2026-09-06T16:39:03.000Z
Content
### Nextcloud Sync Folder (2026-07-19)
- **Local path:** /home/owner/.openclaw/workspace/arno.nextcloud
- **Purpose:** основной канал обмена файлами между Сергеем и Арно (через синхронизацию с Nextcloud)
- **Sync:** автоматическая, через nextcloud-aio-oc
### Telegram Bot — configuration (04.06.2026)
- **Name:** Cl
- **Bot ID:** 8788956736
- **Username:** @clawpi_01_bot
- **User Chat ID:** 862485388
### Network Fix
- **Problem:** Telegram API resolves to IPv6 (2001:67c:4e8:f004::9), Pi has no IPv6 routing
- **Fix:** export NODE_OPTIONS="--dns-result-order=ipv4first" added to /etc/environment
- **Gateway restart:** sudo systemctl --user restart openclaw-gateway
- **Status:** ✅ fixed
### Mail Check — Dedup & State (UID-баг РЕШЁН, 2026-08-16)
- **Решение UID-бага (2026-08-10):** дедупликация новых писем ведётся по **Message-ID** (fallback: sha1(date|from|subject)); зависимость от динамических UID Beget IMAP устранена.
- **mail_detect.py переписан (2026-08-16):** режимы `--trigger` (JSON {fire, message} на stdout, для cron trigger) и `--debug` (dry-run). Fetch с `mark_seen=False` — Unread-флаг НЕ обнуляется. Любые ошибки IMAP → fire:false, exit 0.
- **State:** `skills/nextcloud-aio-oc/state/mail_seen.json` (cap 1000, переживает ребут; bootstrap 16 писем сделан 2026-08-16). НЕ удалять.
- **mail.py — 2 точечных фикса (2026-08-16):** cmd_check → mark_seen=False; load_account → тот же env-chain пароля. Остальное не менялось.
- **Env-chain пароля IMAP:** `IMAP_PASS_ARN → IMAP_PASS → NEXTCLOUD_MAIL_PASS` (рабочая: IMAP_PASS; уже в /etc/environment и env gateway). User/host fallback: IMAP_USER/IMAP_HOST.
### Ford Mondeo 4 — Автомобиль (2026-08-01)
- **Модель:** Ford Mondeo 4 (2011), бензин 2.0 л, 145 л.с.
- **Оформление:** на жену — Ирина
- **Текущий пробег:** 296 300 км (2026-08-01)
- **Интервал ТО:** 10 000 км (сокращённый, по решению пользователя)
- **Последнее ТО:** 2026-08-01 — замена моторного масла и масляного фильтра (Пропег / Propel), пробег 296 300 км
- **Следующее ТО:** ~306 000 км, ориентир ~февраль 2027
### Memory Search Configuration (2026-06-17)
- **enabled:** true
- **provider:** ollama (ollama-local)
- **model:** bge-m3
- **remote.baseUrl:** http://192.168.1.200:11434
- **embedding vector dims:** 1024
- **storage:** ~/.openclaw/agents/{agent-id}/agent/openclaw-agent.sqlite (main, coder-agent, evaluator-agent, humanizer-agent, setup-agent)
- **Cleanup (2026-08-17):** legacy ~/.openclaw/memory/*.sqlite.migrated (5 × ~5MB) удалены — путь хранения см. выше
- **index:** 1 source (MEMORY.md); chunks: main=24, setup-agent=24, coder/evaluator/humanizer=13 (актуально 2026-08-22, проверено по sqlite)
- **all agents:** Embeddings ready, Vector store ready, Semantic vectors ready ✅
- **Note:** OpenClaw CLI `openclaw memory index` runs on Pi but embedding API needs Dell Precision Ollama (192.168.1.200:11434). Gateway process uses config baseUrl correctly.
### AI Models (Actualized 2026-08-26)
- **agents.defaults.model.primary:** `ollama-local/qwen3.8-27b-q5xl`
- **agent.models:**
- main → inherits default: `ollama-local/qwen3.8-27b-q5xl`
- coder-agent → `ollama-local/qwen3.8-27b-q5xl` (2026-08-26, было -coder тег; VRAM-архитектура: 27b resident)
- evaluator-agent → `ollama-local/qwen3.8-27b-q5xl` (2026-08-26, было qwen3.6-35b-192k)
- humanizer-agent → `ollama-local/qwen3.6-35b-192k` (on-demand, не менять)
- setup-agent → `ollama-local/qwen3.8-27b-q5xl` (с 2026-08-22)
- **imageModel.defaults.primary:** `ollama-local/qwen3-vl:32b`
- **memorySearch.model:** `bge-m3` (embedding, not generative)
- **dreaming (native, memory-core.dreaming):** DISABLED 2026-08-22 (was qwen3.6-35b-192k); sweep — main model
- **north-mini-code-1.0:** CANCELLED 2026-08-22 (user decision) — не устанавливать, не использовать (на Dell не установлен)
- **VRAM-архитектура (RTX 5090 32GB, 2026-08-26):** qwen3.8-27b-q5xl (Q5_K_XL, ~28GB VRAM) + num_ctx 131072 + keep_alive 12h = resident primary model. qwen3.6-35b-192k и qwen3-vl:32b = mutually exclusive on-demand models (не загружаются одновременно с resident 27b). Это ограничение VRAM/архитектуры, а не ошибка OpenClaw.
- **Evaluator disclaimer (с 2026-08-26):** evaluator-agent работает на qwen3.8-27b-q5xl (ранее qwen3.6-35b-192k) — последующие evaluator PASS являются результатом проверки на 27B и НЕ эквивалентны прошлым PASS на 35B-192k.
### Discord Bot (2026-06-21) — ⚠️ BLOCKED
- **Token:** configured in openclaw.json channels.discord.token
- **Guild:** 1518244752967864330
- **Plugin:** enabled (discord)
- **Skill:** enabled (discord)
- **Problem:** Raspberry Pi cannot reach Discord API — connection timeout to 162.159.x.x subnet
- **Reason:** ISP/router blocks Discord traffic from home network
- **Fix needed:** Run bot on VPS or fix DNS/routing for Discord
- **Status:** ⚠️ blocked by network
### Systemd Unit — /etc/environment binding (2026-06-12)
- **Problem:** systemd does not read /etc/environment — it's a PAM file, triggered upon login, not for systemd services.
- **Fix:** Added `EnvironmentFile=/etc/environment` to the [Service] section of the openclaw-gateway.service unit.
- **Command:** `systemctl --user edit --force --full openclaw-gateway.service` (created a new unit).
- **Then:** `systemctl --user daemon-reload` + `systemctl --user restart openclaw-gateway`
- **Result:** All vars from /etc/environment are visible to the gateway process.
### Pi-hole (FTL v6) — проверено 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)
- **Аутентификация:** пароль Web UI = env `FTLCONF_webserver_api_password` контейнера (значение НЕ записывать в MEMORY.md/CHANGELOG — файлы синкаются в Nextcloud); хеш — `pwhash` (BALLOON-SHA256) в `/etc/pihole/pihole.toml`; `setupVars.conf` в v6 отсутствует (заменён pihole.toml)
- **API:** логин `POST /api/auth`, JSON `{"password":"***","totp":null}` → `session.sid`; дальнейшие запросы — с сессионным cookie
- **Проверено 2026-08-24:** логин через Web UI (браузер) и API (200 + SID) — работает
- **Внимание:** локальная проверка пароля BALLOON-SHA256 в чистом Python дала ложный NO MATCH (сломанный test-vector в моей реализации) — верификацию пароля делать только через живой API
## Search Tool Priority
Search priority:
web_search (provider: SearXNG локально) → Tavily Search → Tavily Extract → Firecrawl Search/Scrape.
Use:
- web_search for quick lookup;
- Tavily for high-quality search, news, time/domain filtering;
- Tavily Extract for article/page extraction;
- Firecrawl only for JS-heavy or difficult pages;
- web_fetch only for simple URL retrieval.
Always choose the lightest tool that can solve the task.
### SearXNG — локальный web_search (2026-08-21)
- **Provider:** `tools.web.search.provider: "searxng"` (в openclaw.json)
- **Плагин:** @openclaw/searxng-plugin v2026.7.1 (enabled)
- **Базовый URL:** `plugins.entries.searxng.config.webSearch.baseUrl: "http://127.0.0.1:8888"`
- **Контейнер:** `searxng` (searxng/searxng:latest), --restart unless-stopped, порт **127.0.0.1:8888:8080** (только локально)
- **Конфиг:** /home/owner/searxng/settings.yml (600): use_default_settings, secret_key (hex24), limiter: false, formats [html, json]
- **Docker:** docker.io 26.1.5, enabled+running; доступ через `sudo docker` (owner не в docker-группе — осознанно)
- **E2E:** PASS (evaluator + main-agent, 2026-08-21): JSON API живёт, web_search работает через searxng
- **Автообновление:** cron "searxng-weekly-update" (воскресенье 04:00 MSK): isolated agentTurn → /home/owner/searxng/update.sh (pull :latest; digest не изменился → контейнер не трогать; изменился → recreate + verify JSON API). Лог: /home/owner/searxng/update.log. Delivery: announce → telegram:862485388
- **Остатки:** /home/owner/searxng/app/ удалены 2026-08-21
## Configuration Management
### Files
- **CHANGELOG.md** — change history. Each significant infrastructure change → record (created 2026-06-11).
- **MEMORY.md** — persistent system state (infrastructure, models, bot, settings). Not history, but final state.
- **AGENTS.md** — routing and orchestration policy. Does not contain settings.
- **INFRASTRUCTURE.md** — infrastructure baseline: воспроизводимое состояние (Pi + Dell + Ollama + BGE-M3) и recovery-процедуры. MEMORY.md = знания/контекст, INFRASTRUCTURE.md = инфраструктура.
- **Wiki vault** (`/home/owner/obsidian-vault`) — structured entities from MEMORY.md + CHANGELOG.md.
### LLM Concurrency Caps (2026-08-26)
- agents.defaults.maxConcurrent=1, agents.defaults.subagents.maxConcurrent=1, cron.maxConcurrentRuns=1 — эксперимент на Dell (исключение concurrent prefill); backup: projects/openclaw-tooling/backups/openclaw.json.concurrency-111-pre-2026-08-26
### Model Keep-Alive Policy (2026-08-26)
- qwen3.8-27b-q5xl → params.keep_alive=12h (per-model, Ollama body pass-through, dist stream-DwcvMYU5.js:261-263,331); bge-m3/qwen3.6-35b-192k/qwen3-vl:32b — default/on-demand (5m); Ollama env НЕ менялся; backup: projects/openclaw-tooling/backups/openclaw.json.keepalive-12h-pre-2026-08-26
- Подтверждено live 16:29 MSK: /api/ps expiry 27b = +12h после OpenClaw model call (per-request семантика Ollama: запрос без keep_alive сбивает expiry в 5m default)
### Vault state (2026-08-18, исторический снимок)
- ⚠️ Снимок от 08-18: volatile-числа (page/bridge counts) актуальны ТОЛЬКО в CHANGELOG.md + concepts/Bridge-Mode.md (volatile-state ban, 2026-08-22).
- memory-wiki: vaultMode=bridge, ingest.autoCompile=true, render.createDashboards=true, search.backend=shared, search.corpus=all, context.includeCompiledDigestPrompt=true
- memory-core: /home/owner/.openclaw/workspace/memory-core/ (daily/, dreams/, inbox/, index.md)
- dreaming: NATIVE DISABLED (2026-08-22, user decision); единственный pipeline = cron dreaming-sweep (03:00 MSK) → memory-core/daily/ + memory-core/dreams/; check-dreaming — ежедневный контроль; cron 'Memory Dreaming Promotion' снят/удалён; артефакты memory/dreaming, memory/.dreams, DREAMS.md удалены
- volatile wiki state (pages/lint/last-ingest/bridge counts) — НЕ хранится в MEMORY.md (self-loop ban, 2026-08-22); источник: CHANGELOG.md + concepts/Bridge-Mode.md
- wiki_apply remains primary mechanism for creating/updating structured content
- known bug: bridge import syncs 0 artifacts (GH issue #65698) — manual wiki ingest + wiki_apply needed.
### Heartbeat (main agent)
- **Heartbeat DISABLED** (2026-08-18, user decision); mail check now handled solely by cron "mail-check".
- **Config:** agents.list[0].heartbeat.every = "0m" in openclaw.json
- Отчёт daily 9:00 (check-email-daily) — ОТМЕНЁН 2026-08-16, НЕ восстанавливать
### Cron Jobs — Mail & Heartbeat (Actualized 2026-09-06 MSK)
- **mail-check** (id 81689c8a-f1a4-4c0d-bb23-d096775a75bb, every 15m, session=isolated, NATIVE TRIGGER-СКРИПТ): trigger = `skills/nextcloud-aio-oc/scripts/mail_check_trigger.mjs` → `python3 .../mail_detect.py --trigger` → JSON {fire, message}. fire:false → модель НЕ запускается, в Telegram ничего не уходит (ошибки IMAP тоже → fire:false, exit 0). fire:true → LLM agentTurn (timeout 300s): новые письма читать через `mail.py get UID`, суть/класс/важность, вложения-картинки → vision, ОДНО сообщение в Telegram на русском. Delivery: announce → telegram:862485388.
- **heartbeat** (main agent): DISABLED (2026-08-18, every="0m"); больше не работает.
- **Удалено/отменено:** mail-detect (50c4362c, пароль был в промпте) и mail-analyze (bef0b684) — удалены 2026-08-16; mail-daily-report-9am — НЕ возвращён (решение пользователя); legacy /tmp-файлы (last_seen_uids.json, mail_pattern_log.json, mail_new.json, mail_analyze_pending) удалены.
- **Status (mail-check):** ✅ активен (re-enabled 2026-09-06 после авто-отключения 2026-09-05; test-run PASS)
- **dreaming-sweep + check-dreaming — sessionTarget=isolated (с 2026-08-26):** каждый прогон = свежая изолированная сессия, main:main для этих джобов не используется; sessionKey=null; timeoutSeconds: sweep 900s / check-dreaming 300s (2026-08-26 18:5x MSK, разрешение Сергея; ранее 300/120). Серия таймаутов model-call-started закрыта увеличением timeout; root cause — скорость Ollama-prefill (192.168.1.200:11434); верификация — контрольные точки 27.08 03:00 (sweep) / 08:13 (check-dreaming) / 10:00 (ingest-observation); гипотезы проверяются раздельно: A — keep_alive 12h (warm-модель), B — timeout 900s (prefill завершается). Backup: projects/openclaw-tooling/backups/cron-pre-timeout-2026-08-26/ (предыдущий: cron-isolated-sessions-2026-08-26/).
### Sudo & Secrets (actualized 2026-08-21)
- **File:** /etc/sudoers.d/owner (440, backup: owner.bak)
- **Content:** `owner ALL=(ALL) NOPASSWD: /usr/b…ctl, /usr/bin/journalctl, /usr/bin/apt, /usr/bin/apt-get, /usr/sbin/usermod, /usr/bin/docker`
- **Пароль owner:** `/home/owner/.openclaw/secrets/OWNER_PASS` (600, 6 байт) — решение Сергея 13:02: держать в доступе агента. НЕ в /etc/environment, НЕ в MEMORY.md (sync в Nextcloud/Obsidian).
- **Purpose:** setup-agent работает с apt/docker без повторного ввода пароля
- **Audit trail:** all infra changes logged in CHANGELOG.md + MEMORY.md
### Agent Boundaries
- **main-agent:** routing, planning, coordination, status reporting only
- **setup-agent:** infrastructure (systemd, /etc/, packages, networking, firewall) — has NOPASSWD sudo
- **coder-agent:** implementation, code, scripting
- **evaluator-agent:** validation, audit, correctness checks
- **humanizer-agent:** text rewriting, tone, readability
- **No agent may self-certify changes** — evaluator validates all infra mutations
- **All infra changes require CHANGELOG.md entry + MEMORY.md update + wiki compile**
### Change workflow
- Infra/config changes → delegate to setup-agent (per AGENTS.md routing)
- Agent MUST update CHANGELOG.md after infra changes
- Agent MUST update MEMORY.md with final state only (not history)
- All files loaded at session start via project context
- No agent may self-certify changes; evaluator-agent validates infra mutations
### Wiki Ingestion (event-driven, per AGENTS.md §16)
<!-- wiki-ingest:wiki-ingestion -->
- Механизм: fingerprint-based trigger (path + mtime_ns + size + sha256 контента), НЕ mtime-сравнение; один file-change-батч = одно событие с детерминированным event_id
- State: skills/wiki-ingest/state/events.db (SQLite WAL; таблицы processed_events/event_files/file_state/pipeline_state); last_ingest.json — только маркер/отладка
- Протокол: trigger → claim (claim_token, **lease 7200s** — страховка, max attempts 3) → ingest → complete/fail; dead-letter skills/wiki-ingest/events/failed.jsonl; rearm для перезапуска
- **renew — основной механизм защиты длинного ingest:** worker ОБЯЗАН во время обработки каждые 300с вызывать `renew <event_id> <claim_token>`; при `ok:false` (чужой токен / истёкший lease / другой статус) → НЕМЕДЛЕННЫЙ abort: worker перестаёт считать себя владельцем, обработку НЕ продолжает, логирует "lost ownership, aborting"
- `complete` и `fail` в JSON-ответе пишут: `duration_seconds` (int, = now - created_at), `attempts` (int), `batch_size` (int = число файлов батча)
- reason-словарь classify_reason: `stale_token` (приоритет), `lease_expired`, `wrong_state`, `not_found` (row is None), `already_done` (status done)
- Тесты: skills/wiki-ingest/tests/test_wiki_ingest_check.py (62) + test_wiki_ingest_backup.py (12); полный сьют 74/74
- Оба пути (event-driven §16 и cron wiki-ingest-event 30m) конкурируют за один event_id — дедуплицированы; cron-страховка: trigger-скрипт wiki_ingest_check.py --trigger, timeoutSeconds=7200 (2026-08-23, Step 1e; было 600 — убивал длинные ingest >10м), delivery none
- Контракт идемпотентности downstream: skills/wiki-ingest/README.md (upsert по event_id; одна CHANGELOG-запись на event_id; MEMORY.md — только через заменяемые маркеры)
- Volatile-state ban (2026-08-22): в MEMORY.md НЕ писать volatile-числа (counts/last-ingest timestamps) — они живут в CHANGELOG.md + wiki vault
- **Step 2 (2026-08-23):** наблюдаемость — `ingest_metrics` (10 метрик; fire идемпотентен per event_id) + критичные Telegram-алерты (fail, lease_expired_reclaim, manual_rearm, renew_lost_ownership; дедуп 1ч через `alert_suppression`; fail-open — алерт никогда не роняет пайплайн). `send_telegram_alert` = per-IP retry (до 8 IP, 3с/IP, hard deadline 25с; True только при HTTP 200 + ok:true; иначе stderr без токена + False); токен из env TELEGRAM_BOT_TOKEN/TELEGRAM_CHAT_ID иначе openclaw.json. Диагностика: `--alert-test [text]`. Примечание: при DNS-аномалии Telegram (зона отдаёт только мёртвый IP) прямой алерт-путь скрипта может не доставлять (sent:false, non-fatal); пайплайн и gateway-канал не затрагиваются.
- **Step 3 (2026-08-23):** read-only CLI: `--show-failed` (failed-события + dead-letter journal), `--show-event <id>` (детали+метрики+dead-letter entry), `--verify` (8 проверок: integrity/FK/trigger_state/pending/failed/dead-letter/fire-idempotency/marker; ok:false только реальная деградация); `rearm <id>` [--confirm] (алиас `--rearm`): failed→pending (attempts=0, dead-letter entry удаляется); pending→refusal; done без --confirm→needs_confirm; done+--confirm → ПОЛНЫЙ РЕПЛЕЙ ТОЛЬКО если все source-файлы не менялись после complete (fingerprint read-only сверка) — purge file_state+event_files+processed_events, trigger fire:true с ТОМ ЖЕ event_id; расхождение/файл удалён → отказ без изменений. Prod: 4 done-события, md5 events.db e41fb939e08168d075eb9caebd315008 (2026-08-23). Тест-сьют: 62/62. Evaluator: PASS.
- **Step 4 (2026-08-24):** бэкап state-БД — `skills/wiki-ingest/scripts/wiki_ingest_backup.py` (stdlib-only, 1 JSON stdout, rc 0/2): default = wal_checkpoint(TRUNCATE) → атомарная копия в `skills/wiki-ingest/backups/events-<UTC-ts>.db` → restore-verification (копия бэкапа в tempdir + `--verify --workspace <tmp>`) → pruning retention=7; команды `--list`, `--verify <path>`. Мутации ТОЛЬКО в backups/+tempdir; prod state — только wal_checkpoint (логически-ноль). Тесты: +12 (test_wiki_ingest_backup.py); полный сьют 74/74. Evaluator: PASS (0 критичных). Baseline md5 events.db: 0ab2475e7d4e961b4fecc8f59c70e4a6 (2026-08-24, после Step 3 закрытия).
- **Step 2A (2026-08-24):** full backup — `wiki_full_backup.py` (vault + векторные sqlite через backup API; lease-guard SKIP; verify из архива; retention 7d+4w; `backups-full/`); cron `wiki-full-backup` 0 5 * * * MSK (после PASS evaluator + ручного прогона), лог `/home/owner/wiki-full-backup/`.
<!-- /wiki-ingest:wiki-ingestion -->
### Cron Jobs (routing policy reminder — 2026-06-12)
- **CRITICAL:** Cron config changes = infrastructure task → delegate to setup-agent (AGENTS.md §5.1)
- Main-agent MUST NOT modify cron jobs directly
- Violation example: main-agent updated check-dreaming delivery manually on 2026-06-12
- Future cron changes → setup-agent only
## Agent Behavior Rules
### Cron Management Protocol (Actualized 2026-07-03)
- Тайное или автоматическое создание скрытых cron-задач без ведома пользователя ЗАПРЕЩЕНО (Удалено старое конфликтное правило от 2026-06-11).
- Если требуется отложенная проверка системы, агент обязан сформулировать задачу, запросить явное текстовое согласие пользователя в чате, после чего делегировать создание задачи для `setup-agent`.
### Rule Creation (2026-06-11)
- If the agent decides that a new rule needs to be created or an existing one modified, it formulates the rule and requests the user's permission to write it.
- Does not make changes to MEMORY.md / AGENTS.md without the user's explicit consent.
- Upon approval, it writes the final state to MEMORY.md and updates CHANGELOG.md.
## Email Addresses
- **Arno (Agent):** arno@eurostela.ru (via Beget)
- **Sergey (Owner):** sergey@eurostela.ru
## Nextcloud Mail
- **Account:** arno@eurostela.ru
- **IMAP:** ://beget.com (SSL)
- **SMTP:** ://beget.com (SSL)
- **Script:** /home/owner/.openclaw/workspace/skills/nextcloud-aio-oc/scripts/mail.py
- **Capabilities:** inbox, get, send, reply, folders, search, delete
- **Status:** connected ✅
- **Password (IMAP):** env-chain `IMAP_PASS_ARN → IMAP_PASS → NEXTCLOUD_MAIL_PASS` (рабочая: IMAP_PASS; /etc/environment + env gateway). User/host fallback: IMAP_USER/IMAP_HOST
### Email Behavior Rule (2026-06-17) (v2.0)
- **1. Deleting a specific message (by UID):** MOVE from INBOX to Trash folder via UID MOVE. DO NOT use `\Deleted` + EXPUNGE to avoid data loss. Verify removal from INBOX.
- **2. Clearing the INBOX:** MOVE all UIDs to Trash in batches of 500-1000. Verify INBOX (EXISTS) = 0. Roll back completely on error.
- **3. Clearing the Trash:** Require strict explicit user confirmation. Set `\Deleted` flag + EXPUNGE. Verify Trash is empty (EXISTS = 0). Log counts to CHANGELOG.
### Email Script Fix (2026-06-17)
- `mail.py` — fixed `\Deleted` escape in IMAP STORE command; added `--all` support for `cmd_delete`.
### Email Script Update (2026-07-26)
- `mail.py` — all commands now support `--folder <folder>` parameter (inbox, get, search, delete, reply). Default: "INBOX" for backward compatibility.
- All commands use UID-based API (`m.uid('FETCH')`, `m.uid('STORE')`) instead of sequence-based for Trash/Junk compatibility with Beget IMAP.
- Added reference doc: `/home/owner/.openclaw/workspace/skills/nextcloud-aio-oc/docs/mail-py-reference.md`
### Mail.py multipart Fix (2026-08-03)
- `mail.py` — функция `get_text_body()` теперь рекурсивно обрабатывает вложенные multipart/alternative структуры (Gmail вложенные контейнеры).
- Письма с картинками внутри вложений извлекаются корректно.
### Mail Photo Attachments Handling (2026-08-03) v2
- **Правило:** Когда в письме есть вложение-картинка (image/jpeg, image/png и т.д.) → сохранить файл на диск, затем проанализировать через `ollama-local/qwen3-vl:32b` (vision model).
- **Где сохранять:** `/home/owner/.openclaw/workspace/skills/nextcloud-aio-oc/tmp/mail_<UID>_<filename>`
- **Процесс:** 1) imap fetch UID (RFC822), 2) найти part с image/ Content-Type, 3) decode payload, 4) write binary to tmp, 5) vision model analysis.
- **Решение о выдаче (v2):** Не показывать результат анализа автоматически. Сначала проанализировать — если на фото есть полезная информация (координаты, текст, документы, данные) → выдать в чат. Если картинка бессмысленная (интерфейс, скриншот без данных, подпись, decorative image) → не показывать результат, просто сохранить файл.
### Beget IMAP Limitations (verified 2026-08-17)
- **Баточный UID MOVE не работает:** `UID MOVE 119 120 INBOX.Trash` → сервер отвечает `NO` ("Client tried to access nonexistent namespace") — даже с корректным префиксом INBOX. 2026-08-17 20:26 ранее наблюдался silent no-op (OK, но ничего не перенеслось). Одно-UID MOVE работает стабильно (подтверждено дважды 2026-08-17: UID 119, 120). Вывод: перенос/удаление — только по одному UID за команду (mail.py delete так и работает).
- **SEARCH SUBJECT не парсится:** `UID SEARCH SUBJECT "текст"` → `BAD: Unknown argument TEST`. Для поиска по теме — client-side фильтрация.
- **Имена папок:** всегда с префиксом `INBOX.` (INBOX.Trash, INBOX.Junk, INBOX.Sent); "Trash" без префикса → NO. В mail.py добавлена `_normalize_folder()` (2026-08-17).
### Email Decision (2026-07-26)
- **Decision:** Keep `mail.py` as utility for cron and automation — confirmed by user.
- Rationale: provides JSON output, cron integration (`check-email-daily`), and standardized access to all folders (INBOX, Trash, Junk, Sent, Drafts).
- All commands now support `--folder <folder>` parameter with UID-based API (m.uid('FETCH'), m.uid('STORE')) for Trash/Junk compatibility.
### Mail Check Cron
- Mail check теперь через cron **mail-check** (every 15m, trigger-скрипт) — см. секцию "Cron Jobs — Mail & Heartbeat". Отчёт в 9:00 (mail-daily-report-9am) отменён, не восстанавливается.
## Nextcloud AIO (2026-06-14)
- **Skill:** nextcloud-aio-oc (installed in workspace/skills/nextcloud-aio-oc)
- **URL:** https://datacloudport.ru
- **User:** Arno
- **Auth:** Basic Auth (NEXTCLOUD TOKEN account password)
- **Timezone:** Europe/Moscow
- **Status:** ✅ connected — OCS API + Notes list + WebDAV all working
- **Env:** /etc/environment (NEXTCLOUD_URL, NEXTCLOUD_USER, NEXTCLOUD_TOKEN, NEXTCLOUD_TIMEZONE)
- **Capabilities:** Notes, Tasks, Calendar (CalDAV), Files (WebDAV), Contacts (CardDAV)
- **Office libraries:** python-docx 0.8.11, openpyxl 3.1.5, python-pptx 1.0.2, reportlab 4.4.4, pypdf 5.6.0
- Fully supports .docx/.xlsx/.pptx files (read/edit/create)
- PDF reading and editing
- **Contacts:** 13 entries (8 user, 5 system)
- **OCS fix (2026-06-14):** OCS API returns 412 without `OCS-APIRequest: true` header (Nextcloud 30+ CSRF protection). Added to bundled request() function in nextcloud.js — all OCS endpoints now return 200. WebDAV unaffected.
- **Warning:** fix applied to compiled bundle; will be lost if skill is updated or reinstalled.
### Nextcloud Behavior Rule (2026-06-15)
- When a user requests an action with "Nextcloud" without specifying an account, immediately use Arno's account on datacloudport.ru without asking for confirmation or clarification.
### WordPress — Eurostela.ru (2026-06-15)
- **URL:** https://eurostela.ru
- **Тип:** WordPress (3+ года), Elementor + ACF
- **Пользователь:** Arno, role: editor
- **Application Password:** arno — LwZFmiWyCrhPHlUwAShq7qFD (имя: Arno-API)
- **API endpoint:** https://eurostela.ru/wp-json/wp/v2/
- **Статус:** ✅ Connected, REST API is working, authorization completed
- **Категория по умолчанию:** "User information" (id=100)
- **Назначение:** content, SEO optimization, website promotion
### WooCommerce REST API — Eurostela.ru (2026-06-24) ⚠️ ЧАСТИЧНО УСТАРЕЛО
- **API base:** https://eurostela.ru/wp-json/wc/v3/
- **Consumer Key:** `ck_6ae9d729f33e1672ffed8bd41c042b14db74aabf`
- **Consumer Secret:** в окружении `WOOCOMMERCE_API_SECRET` (не разглашать)
- **Auth:** Basic Auth (key:secret) — обязательны оба ключа
- **Пример запроса:**
- Поиск по SKU: `GET /wc/v3/products?sku=MR-038`
- Список товаров: `GET /wc/v3/products?per_page=10&orderby=date&order=desc`
- Один товар: `GET /wc/v3/products/{id}`
- **SKU форматы:** кириллические (МР-xxx) и латинские (MR/MP-xxx) — разные коды
- **Статус:** ✅ API keys working, read access confirmed
- **⚠️ Обновлено 2026-07-25:** категории обновлены (было 60, стало 71). Новые: Caggiati буквы/цифры, знаки препинания, медали/ордена, ретушь. Пустых категорий: 6.
### WordPress Application Password (2026-07-04)
- **User:** arno (id=6)
- **Password:** OvuC DhcN q3Vn MLBs JXPj 7Vok
- **Stored in:** /etc/environment → WORDPRESS_APP_PASS
### WooCommerce Behavior Rule (2026-07-04)
- **CRITICAL:** Any state-changing actions in WooCommerce (creating products, editing product descriptions, editing prices, updating stock, changing order statuses) require explicit user permission in chat ("yes", "да").
- Read-only actions (fetching orders, tracking SKU, checking stock) are allowed without permission.
### SEO Endpoint — Eurostela.ru (2026-07-04)
- **URL:** https://eurostela.ru/wp-json/openclaw/v1/seo-optimize
- **Method:** POST
- **Headers:**
- `Content-Type: application/json`
- `x-openclaw-key: 4f2c1d1b4bb2452db92b7fd3d6d86d8d`
- **Body:** { "post_id": <ID>, "seo_title": "<Title>", "seo_description": "<Description>" }
- **Purpose:** Автоматическая запись SEO meta (rank_math_title, rank_math_description) для товаров Eurostela.ru через WordPress PHP hooks
- **Status:** ✅ работает
### Sitemap — Eurostela.ru (2026-07-25)
- **URL:** https://eurostela.ru/sitemap_index.xml
- **Генератор:** Rank Math SEO Plugin
- **Состав:**
- `https://eurostela.ru/post-sitemap.xml` — посты (lastmod: 2026-07-20)
- `https://eurostela.ru/product-sitemap.xml` — товары (lastmod: 2026-07-24)
- `https://eurostela.ru/category-sitemap.xml` — категории WordPress (lastmod: 2026-07-20)
- `https://eurostela.ru/product_cat-sitemap.xml` — WooCommerce категории (lastmod: 2026-07-24)
- **Статус:** ✅ работает, доступен через https://
### Пустые/малополезные категории ⚠️ (2026-07-25 актуально)
- id=32 "Памятник валун" — **0 товаров** (пусто!)
- id=16 "Разное - без категории" — **0 товаров**
- id=241 "Ремонт, реставрация памятников" — **0 товаров**
- id=622 "Ретушь фото для памятника" — **0 товаров**
- id=157 "Столы и лавочки" — **0 товаров**
- id=158 "Шары и наконечники" — **0 товаров**
- id=64 "Памятник часовня" — **1 товар** (крайне мало)
- id=298 "Памятники колонны и обелиски" — **2 товара**
- id=71 "Цветной портрет на памятник" — **1 товар**
- id=77 "Позолота букв" — **3 товара**
### API Keys — eurostela.ru
- **WooCommerce CK:** ck_6ae9d729f33e1672ffed8bd41c042b14db74aabf
- **WooCommerce CS:** в окружении WOOCOMMERCE_API_SECRET
- **WP App Pass (arno):** OvuC DhcN q3Vn MLBs JXPj 7Vok
- **SEO Key:** 4f2c1d1b4bb2452db92b7fd3d6d86d8d
## Active Projects
| Project | Status | Path |
|---------|--------|------|
| eurostela.ru | active | projects/eurostela.ru/ |
| sing-box | active | projects/sing-box/ |
| ai-server | planning (полная спецификация 2026-08-04) | projects/ai-server/ |
## Project Creation and Storage Policy
Reference: /home/owner/.openclaw/workspace/project-rules.md
### Project Registry
All projects are registered in: /home/owner/.openclaw/workspace/projects/index.md
### Project Statuses
Allowed values: planning, active, paused, completed, archived
### Required Project Files
Every project must contain:
PROJECT.md → current project state
README.md → human-readable overview
CHANGELOG.md → project history
### Required Project Directories
```text
tasks/
decisions/
audit/
reports/
assets/
content/
docs/
notes/
contracts/
tmp/
archive/
```
### Project Statuses
Allowed values:
```text
planning
active
paused
completed
archived
```
### Project Registry
All projects tracked in:
```text
/home/owner/.openclaw/workspace/projects/index.md
```
### Context Loading Policy
Before working on a project:
1. Read PROJECT.md
2. Read open tasks
3. Read latest CHANGELOG entries
4. Read latest notes
5. Load additional files only if required
Never load the entire project by default.
### Storage Policy
Primary storage:
```text
workspace/projects/
```
Backup:
```text
Nextcloud /Projects/
```
Sync direction:
```text
local → Nextcloud
```
Automatic reverse synchronization is prohibited.
### Workspace File Policy
- **Корень `/workspace/`** — только файлы конфигурации OpenClaw (AGENTS.md, MEMORY.md, SOUL.md и т.д.) и папки `projects/`, `skills/`, `memory-core/`.
- **Запрещено**: создавать файлы вне папок проектов и skills. Все создаваемые файлы должны идти внутрь `/projects/<project>/` или `/skills/`.
- **При нарушении** — автоматически перенести файл в соответствующую папку проекта.
### Research and Decisions
- Research → facts, tests, evaluations (Location: notes/research/)
- Decisions → approved choices (Location: decisions/)
- Never mix them.
### Project Registry
See:
/home/owner/.openclaw/workspace/projects/index.md
### Agent Boundaries
Agents may: create/modify project files, update PROJECT.md/CHANGELOG.md, create reports/decisions/tasks
Agents may not: modify archived projects, delete archives, access unrelated projects without permission, modify system configuration without approval, move files between projects without approval
### Project Versioning Policy (2026-06-20)
#### Scope
- **All regular files** inside `workspace/projects/<project-name>/`, at any nesting level.
- Excludes: Cache/temporary files, Hidden VCS directories (.git), archive/ directories themselves
#### Core idea
- Active (current) file stays **in place** with its original name — **no revision suffix**.
- Every edit creates a **dated, numbered snapshot** in a **local `archive/` subfolder** located **in the same directory** as the file being edited.
- Archive filenames preserve the original filename **and extension** to avoid collisions: `<filename>.<ext>-<YYYY-MM-DD>-BU_<N>.<ext>`.
- Note for AI developers: Local project archive/ directories are not subject to the global system log and cache ban for coder-agent.
#### Pattern per file:
```
/home/owner/.openclaw/workspace/projects/<project-name>/content/
├── article.md ← active file
├── notes.md ← active file
├── articleassets.md ← active file
└── archive/
├── article-2026-06-20-BU_1.md
├── notes-2026-06-20-BU_1.md
├── article-2026-06-20-BU_2.md
└── notes-2026-06-22-BU_2.md
```
#### Behavior on edit
##### First edit (no archive exists for this file)
- In the same folder as `<file>.md`, create `archive/` if it doesn't exist.
- Copy the current content of `<filename>.<ext>` into `archive/<filename>-<YYYY-MM-DD>-BU_1.<ext>`.
- Keep editing the original `<filename>.<ext>` — it remains the active version.
(No data loss, no empty active file.)
##### Subsequent edits
- Ensure the local `archive/` folder exists.
- Find all revisions for this file in that `archive/` folder (by `<filename>-*.<ext>` pattern) and determine the highest revision number `N`.
- Copy the current active `<filename>.<ext>` into `archive/<filename>-<current-date>-BU_<N+1>.<ext>`.
- Continue editing `<filename>.<ext>` as the active version.
##### Important notes
- The **active file is never moved** — only **copied** into the `archive/`.
This guarantees the working copy is always ready and unchanged.
- Revision names include the original filename (e.g. `readme-2026-06-20-BU_1.md`), ensuring unique identification even if multiple `.md` files share the same `archive/` folder.
- There is no separate "base" file after the first edit — the original file remains the single active version.
- The archive/ directory appears once per working directory (e.g., assets/archive/, content/archive/), not once per file.
#### Relationship with storage/backup policy
- Archive revisions are part of the project and **are pushed to Nextcloud** together with all other files during manual sync or at natural checkpoints (task completion, milestone).
- No automatic background sync of archives.
- See `Storage Policy (2026-06-16)` for overall backup rules.
### Memory Audit — Cleanup (2026-08-17)
- Удалено: 5 legacy migrated DBs (~27MB), пустые файлы (workspace/2026-08-12, memory/2026-07-15.md, memory/2026-07-23.md, vault Untitled.canvas ×2)
- Перенесено: notes/*.md → skills/nextcloud-aio-oc/docs/ (Workspace File Policy)
- HEARTBEAT.md переписан под фактическое состояние (check-email-daily 9:00 отменён)
- Live cron (актуально 2026-09-06): active — mail-check (15m trigger-скрипт), wiki-ingest-event (30m, активен — re-enabled 2026-09-06), wiki-ingest-backup (ежедневно 04:00 MSK, command-джоб: wrapper + wiki_ingest_backup.py, flock -n, лог /home/owner/wiki-ingest-backup/), wiki-full-backup (ежедневно 05:00 MSK, command-джоб: wrapper + wiki_full_backup.py, flock -n, лог /home/owner/wiki-full-backup/), check-dreaming, dreaming-sweep (03:00 MSK), searxng-weekly-update (вс 04:00), trash-cleanup (1-е число 06:00 MSK, модель qwen3.8-27b-q5xl, обязательное подтверждение Сергея перед удалением); Memory Dreaming Promotion — удалён 2026-08-22 (при disable native dreaming); legacy disabled jobs — удалены 2026-08-21 (запрос пользователя)
## Tool Caveats
### wiki_apply op=metadata (fixed 2026-08-25, TASK-001 closed)
- Инцидент 2026-08-24 (тихая потеря evidence/claims: подмножество в payload → REPLACE всего массива) исправлен: `dist/cli-DwyScdE_.js` — claims upsert по identity (id, fallback normalized text); evidence: absent/`[]` в payload = сохранение, non-empty = замена только для этого claim; `claims: []` = no-op. Явной delete-семантики для claims/evidence не изобретено (протокол).
- Идемпотентность: повторный идентичный apply → без перезаписи (bytes/updatedAt не меняются); per-page write lock + per-vault serializация мутаций (evaluator: deadlock-free).
- Верификация: regression 16/16 (pre-fix anchors fail на backup-чанке), независимый evaluator PASS, 0 counterexamples destructive loss. Backup+diff: projects/openclaw-tooling/tests/fixtures/cli-DwyScdE_.js.task001-pre.bak, patches/TASK-001-dist-patch.diff.
- Residual: патч теряется при npm update openclaw (re-apply по diff); cross-process race не покрыт (in-process lock); claims synthesis-страниц — REPLACE (out of scope).
### Eurostela SEO endpoint (с 2026-08-30)
- **Runbook обязателен перед любой SEO-задачей:** `projects/eurostela.ru/seo-endpoint-runbook.md` (+ копия в Nextcloud `eurostela.ru/`).
- Endpoint `POST /wp-json/openclaw/v1/seo-optimize` (плагин MCP SEO Endpoint, v1.8 на хостинге): категории ставить ТОЛЬКО с `object_type: "term"` (коллизия wp_posts.ID = term_id: 227/240/258). Ключ: `EUROSTELA_SEO_API_KEY` из /etc/environment. Лимиты title 70 / desc 160.
- Live-проверка — только с cache-buster (edge-кэш ~1ч): `?t=<ts>`, UA Chrome.
- 30.08: 9/9 категорий (30,67,227,37,240,618,619,258,68) — согласованные title+desc live.
- Инцидент: rank_math-мета скрытых постов 227/240/258 перезаписана (v1.7 auto-ветка); старые значения только из дампа БД хостинга. Backup'ы плагина BU_1..BU_3 не удалять, посты не трогать до закрытия вопроса.
Notes
Related
Referenced By
- Concept: Active Projects
- Concept: Bridge Mode
- Concept: Eurostela SEO Endpoint (MCP SEO Endpoint)
- Concept: Mail Pipeline (arno@eurostela.ru)
- Concept: Nextcloud Sync Folder (arno.nextcloud)
- Concept: Routing
- Concept: Search Tool Priority
- Concept: VRAM Management
- Concept: Workspace File Policy
- Entity: Beget (хостинг / IMAP)
- Entity: Dream Diary (DREAMS.md)
- Entity: Eurostela (евростела.ru)