wiki/tasks/workspace-structure.md

Workspace — полное описание файловой структуры

Рабочая директория: /home/node/.openclaw/workspace

---

📁 Корневые файлы

Файл	Описание
AGENTS.md	Инструкция для всех агентов: порядок сессий, память, правила работы, heartbeats
SOUL.md	Личность ассистента Стрим: стиль, ценности, подход к работе
USER.md	Профиль Славы: имя, интересы, предпочтения в общении
TOOLS.md	Заметки по конкретной конфигурации инструментов (камеры, SSH, голоса и т.д.)
IDENTITY.md	Идентичность ассистента: имя, пол, эмодзи, vibe
MEMORY.md	Долгосрочная память: правила, люди, проекты, принятые решения
HEARTBEAT.md	Список задач, выполняемых каждые 30–60 минут в фоне
BACKLOG_GENERAL.md	Общий бэклог идей и задач
BACKLOG_NOISEMAP.md	Бэклог проекта noisemap (шумовая карта)

---

📁 memory/ — Дневные записи памяти

Файл	Описание
2026-03-27.md	События за 27 марта 2026 (текущий день)

Создаётся memory/YYYY-MM-DD.md для каждого дня. Содержит сырые заметки: что делали, что приняли, что решили. Обновляется после компакции контекста.

---

📁 data/ — Данные скиллов

data/telegram-collector/raw/

Сырые дампы сообщений из Telegram-каналов, разделённые по каналу и топику.

• Каналы: snowbikerussia/, snowbike_msk/, crossmania/
• В каждом топике: файлы сообщений (messages_*.jsonl), медиафайлы, метаданные

---

📁 skills/ — Скиллы (AgentSkills)

skills/telegram-collector/

Сбор и анализ сообщений из Telegram-каналов через Telethon (пользовательский аккаунт).

• SKILL.md — инструкция по запуску
• scripts/collector.py — основной скрипт
• scripts/analyzer.py — двухпроходный анализ (GPT-4o mini → Claude Sonnet)

skills/telegram-monitor/

Мониторинг публичных каналов (bots API, чтение через Meilisearch + токенизатор).

skills/summarize-chat/

Генерация саммари сообщений из Telegram-чатов.

skills/summarize-pdf/

Извлечение и суммаризация текста из PDF-файлов.

skills/summarize-url/

Извлечение текста из веб-страниц и его суммаризация.

skills/weather/

Получение погоды через wttr.in или Open-Meteo.

skills/rag/

Retrieval-Augmented Generation — поиск по векторной базе.

skills/openai-image-gen/

Генерация изображений через OpenAI Images API.

---

📁 scripts/ — Общие скрипты

Файл	Описание
scripts/send_video_note.sh	Pipeline для отправки видео-кружочков (TTS → fal.ai → VEED → Telegram)

---

📁 tasks/ — Задачи и проекты

tasks/flightradar24/

Проект «Карта шумового загрязнения» — визуализация трёков самолётов над МО.

Файл	Описание
prototype/app.py	Flask-сервер (порт 5555)
prototype/index.html	Карта: OpenLayers, треки, зоны шума
prototype/noise_model.py	Модель шума (радиус по высоте)
prototype/density_model.py	Плотность пролётов (рейсов/час)
prototype/fr24_client.py	Клиент для Flightradar24 API
prototype/fetch_tablo.py	Скачивание табло вылетов из Яндекс.Расписаний
prototype/fetch_strategy_b.py	Загрузка рейсов через табло + live-снимки
prototype/fetch_strategy_b_v2.py	Тот же скрипт, с исправлениями (CLI-дата, sys)
prototype/fetch_airport.py	Стратегия А: снимки зоны аэропорта
prototype/fetch_tracks.py	Загрузка трёков по fr24_id
prototype/fetch_svo_tracks.py	Загрузка трёков SVO (Серпухов)
prototype/generate_sample_data.py	Генерация тестовых данных
prototype/sample_flights.json	Пример данных трёков

Документация:

Файл	Описание
prototype/docs/FR24_API.md	Описание API Flightradar24
prototype/docs/ARCHITECTURE.md	Архитектура приложения
prototype/docs/NOISE_MODEL.md	Модель шума
prototype/docs/DATA_LOADING.md	Загрузка данных
prototype/docs/UI.md	Описание UI карты
prototype/docs/TZ_DENSITY_LAYER.md	ТЗ слоя плотности
prototype/docs/DEVLOG.md	dev-журнал
reports/ТЗ_Карта_шумового_загрязнения_Flightradar24.md	Главное ТЗ

Данные:

• prototype/data/cache_SVO/ — кэш трёков SVO
• prototype/data/cache_svo/ — кэш трёков SVO (стратегия А)
• prototype/data/cache_SVO_b/ — кэш рейсов SVO (стратегия Б)
• prototype/data/cache_DME/ — кэш трёков DME
• prototype/data/cache_VKO/ — кэш трёков VKO
• prototype/data/cache_ZIA/ — кэш трёков ZIA
• prototype/data/cache_SVO_offset90m/ — кэш SVO, смещение на 90 мин
• prototype/data/cache_VKO_offset90m/ — кэш VKO, смещение на 90 мин
• prototype/data/flights_SVO_2026-03-20_offset90m.json — рейсы SVO за 20 марта
• prototype/data/flights_SVO_2026-03-21.json — рейсы SVO за 21 марта
• prototype/data/flights_DME_*.json — рейсы DME
• prototype/data/flights_VKO_*.json — рейсы VKO
• prototype/data/flights_ZIA_*.json — рейсы ZIA
• prototype/data/flights_SVO_2026-03-21_strategy_b.json — SVO, стратегия Б
• prototype/data/flights_SVO_2026-03-26_strategy_b.json — пустой файл (дубль 21.03)
• prototype/data/tablo_SVO_2026-03-21.json — табло вылетов SVO
• prototype/data/tablo_SVO_2026-03-26.json — табло вылетов SVO (26.03)
• prototype/data/tablo_need_load.json — табло, данные для загрузки
• prototype/data/density_cache*.json/.gz — кэш слоя плотности (gzip сжатие)
• prototype/data/raw_*.json — сырые данные с API

Кредиты FR24: потрачены (~16 161 из 120 000 промо), все попытки загрузить 26 марта → HTTP 402.

---

tasks/snowbike-rag/

RAG-система для базы знаний о сноубайках.

Файл	Описание
server.py	Flask-сервер поиска
scripts/parse_messages.py	Парсинг сообщений
scripts/index_chromadb.py	Индексация в ChromaDB
scripts/index_meilisearch.py	Индексация в Meilisearch
scripts/search.py	Скрипт поиска
start.sh	Запуск всего
templates/index.html	UI для поиска
config/docker-compose.yml	Docker для Meilisearch
data/messages.jsonl	Сообщения из Telegram
data/chromadb/	База ChromaDB
data/meilisearch/	База Meilisearch
bin/meilisearch	Бинарник Meilisearch
BRD.md, TZ.md	ТЗ и Бизнес-требования
README.md	Документация

---

tasks/snowbike-kb/

Веб-просмотрщик базы знаний о сноубайках.

Файл	Описание
server.py	Flask-сервер (порт 5556)
viewer/index.html	UI просмотра
run_analysis.sh	Скрипт запуска анализа

---

tasks/video-notes/

Видеокружочки (lip sync).

Файл	Описание
TZ.md	ТЗ для генерации видео-кружочков

---

tasks/legal-agent/

Юрист по законам РФ.

Файл	Описание
AGENTS.md	Инструкции для юриста
SOUL.md	Личность юриста

---

tasks/planner-agent/

Агент-планировщик (подготовлен промпт, не развёрнут).

Файл	Описание
SOUL.md	Личность планировщика

---

tasks/scripts/

Файл	Описание
token_summary.py	Суммаризация расходов токенов
usage_summary.py	Суммаризация использования

---

tasks/token-log.md

Лог расхода токенов по задачам (DEV-XXX / XK in / XK out → $X.XX).

---

📁 dumps/

Пустая папка (для backup-ов).

---

📁 temp/

Пустая папка (временные файлы).

---

Вне workspace (system)

Путь	Описание
~/.openclaw/.env	Секреты: OPENROUTER_API_KEY, TELEGRAM_BOT_TOKEN, OPENSKY_CLIENT_ID/SECRET, YANDEX_API_KEY и др.
~/.openclaw/openclaw.json	Конфиг OpenClaw: модель, каналы, скиллы
/app/docs/	Документация OpenClaw
/app/skills/	Встроенные скиллы (voice-tts, node-connect, healthcheck)