Файлы рабочей области OpenClaw (SOUL.md, MEMORY.md) на облачном Mac 2026: безопасная конфигурация для команд

Платформенные команды, запускающие OpenClaw на арендованных Mac Apple Silicon, быстро понимают: выбор модели и аптайм шлюза — лишь половина истории; поведение агента задаётся markdown-файлами в рабочей области. Промпты в духе SOUL задают тон и ограничения безопасности; файлы памяти фиксируют устойчивые факты для межсессионного использования; сопутствующие файлы описывают инструменты и субагентов. Практика 2026 — относиться к каталогу как к infrastructure-as-code: версионировать безопасные части, исключать секреты и документировать, какой пользователь macOS владеет LaunchAgent, который их читает. Руководство описывает каждый ключевой файл, даёт семишаговый bootstrap, шаблоны песочниц для нескольких инженеров, правила гигиены Git и сопоставляет симптомы с исправлениями, со ссылками на укрепление шлюза и webhooks, когда проблема не в markdown.

Грамотный текст рабочей области снижает расход токенов: лаконичные абзацы SOUL избавляют от повторения политики в каждом чате, а подрезанный MEMORY не заставляет платить за повторное поглощение устаревших абзацев на каждую задачу.

Запланируйте ежемесячный обзор «долга промптов» так же, как устаревших cron-заданий: удаляйте эксперименты, архивируйте устаревший тон, оставляйте только то, что соответствует продакшен-API и голосу бренда.

Почему markdown рабочей области важен на headless облачном Mac

В отличие от чисто чатового ассистента, агенты OpenClaw на узлах MacLogin могут вызывать команды shell, следить за папками и отвечать на webhooks. Без явных ограничений SOUL полезная модель может удалить файлы, отправить сообщение не в тот канал Slack или просочить внутренние имена хостов в ответы, видимые клиенту. Память при неаккуратном использовании превращается в свалку устаревших слухов, перекрывающих свежие данные тикет-системы. Правильно оформленные файлы сильнее снижают число инцидентов, чем простое расширение контекста.

Перед правкой текста стабилизируйте шлюз шагами из руководства по устранению неполадок launchd для демона шлюза — иначе вы будете охотиться за markdown-призраками, пока Node перезапускается снова и снова.

Ключевые файлы рабочей области: справочная таблица

Сборки OpenClaw меняются, но большинство установок выставляет папку workspace под сервисным пользователем (часто в скрытом дереве .openclaw). Используйте таблицу как контракт команды — меняйте имена файлов только если это задокументировано в вашем релизе.

Файл	Назначение	Не хранить
SOUL.md (или аналог)	Персона, отказы, триггеры эскалации	API-ключи, ПДн клиентов, неверифицированные сторонние инструкции
MEMORY.md	Долгоживущие факты, соглашения, карта репозиториев	Пароли, сырые токены, чувствительные ко времени секреты
AGENTS.md / TOOLS.md	Объявленные субагенты и вызываемые инструменты	Экспериментальные плагины без ревью рисков в духе ClawHub

Семь шагов bootstrap рабочей области

1. Выбрать владельца: должен совпадать с учётной записью macOS, запускающей LaunchAgent — смешанное владение даёт тихие ошибки чтения.
2. Снимок каталога: скопируйте права через ls -la; каждый markdown читается только нужной группой.
3. Черновик SOUL.md: включите «никогда не запускать rm -rf вне корней workspace» и требуйте подтверждения для исходящих webhooks.
4. Засеять MEMORY.md: URL репозиториев, ветки по умолчанию, дежурства; удаляйте записи старше 90 дней на спринт-ревью.
5. Согласовать манифесты инструментов: уберите то, что хост не должен публиковать наружу — особенно при входящем HTTPS от webhooks с TLS на обратном прокси.
6. Подключить gitignore: исключите локальные черновые пути; не коммитьте копии .env рядом с markdown.
7. Перезапуск и пробный прогон: перезагрузите шлюз, отправьте безобидный запрос со ссылкой на MEMORY и убедитесь в логах по ожидаемым хешам или маркерам загрузки.

Песочницы команд на одном Mac mini

Когда бюджет ограничивает одним Mac mini M4 в Сингапуре, а инженеры в Сеуле и Сан-Франциско, разделяйте контексты вместо общего изменяемого MEMORY. Варианты: подпапки по проектам с symlink в активный workspace при выкладке или ветки Git, продвигаемые CI после ревью. Фиксируйте передачи во внутренней вики, чтобы дежурный в выходные знал, какая ветка в продакшене.

Git, резервные копии и гигиена секретов

Даже «внутренние» репозитории утекают при клонировании подрядчиками. Относитесь к MEMORY как к конфигурации приложения: редактируйте имена клиентов, если они не нужны, используйте ID тикетов вместо транскриптов, pre-commit-хук против приватных ключей. Резервные копии шифруйте офлайн — markdown часто содержит архитектурные подсказки для атакующих.

Операционные цели: держать SOUL + MEMORY вместе примерно под 8000 токенов эквивалента, если нет retrieval; ежеквартально удалять ссылки на автоматизацию к выведенным из эксплуатации микросервисам.

Когда несколько человек правят один markdown по SSH, используйте блокировки или ревью в стиле pull-request даже при неформальном «репозитории» — последний записавший победил уже смешивал наполовину старые правила безопасности и наполовину новый маркетинговый тон в одной сессии.

Матрица устранения неполадок

Симптом	Вероятная причина	Исправление
Агент игнорирует новое правило SOUL	Шлюз не перезапущен или неверный путь пользователя	Проверить ProgramArguments LaunchAgent и перезагрузить
Противоречивые ответы из часа в час	Устаревший MEMORY против живых API-данных	Датировать пункты MEMORY; для изменчивого состояния вызывать инструменты
Ошибки «инструмент не найден»	TOOLS.md не совпадает с установленными плагинами	Сверить с выводом openclaw doctor
Чувствительный текст в чате с клиентом	MEMORY без правил редактирования	Добавить в SOUL требование очистки перед внешними каналами

Частые вопросы

Должен ли SOUL ссылаться на голос бренда? Да — примеры приветствий и запрещённых формулировок сокращают циклы ревью.

Может ли MEMORY автоматически тянуть из Notion? Только через явные доверенные инструменты; не вставляйте целые экспорты вики без разбиения на фрагменты.

Когда сбрасывать эксперименты workspace? После крупных обновлений macOS или миграций между регионами MacLogin (HK, JP, KR, SG, US) — пути и права могут сместиться.

Почему Mac mini M4 на MacLogin подходит для больших workspace

Крупные SOUL и MEMORY загружаются быстрее, когда диск и unified memory не конкурируют с чужой индексацией Xcode. Узлы Mac mini M4 дают предсказуемую однопоточную производительность для разбора markdown и запуска дочерних процессов инструментов. Размещение в Гонконге, Японии, Корее, Сингапуре или США снижает задержку для операторов чата и отправителей webhooks.

Арендуйте отдельные хосты для продакшен-агентов и R&D-песочниц, чтобы экспериментальные черновики SOUL не ушли в прод по ошибке. Масштабируйте память и CPU на странице цен при добавлении инструментов и держите VNC для разовых GUI-подтверждений, которые headless markdown не заменяет.