AGENTS.md — Персональный ассистент OpenClaw (по умолчанию)

Первый запуск (рекомендуется)

OpenClaw использует выделенную директорию рабочего пространства для агента. По умолчанию: ~/.openclaw/workspace (настраивается через agents.defaults.workspace).

  • Создайте рабочее пространство (если оно еще не существует):
mkdir -p ~/.openclaw/workspace
  • Скопируйте шаблоны рабочего пространства по умолчанию в рабочее пространство:
cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.md
cp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.md
cp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md
  • Опционально: если вы хотите список навыков персонального ассистента, замените AGENTS.md этим файлом:
cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md
  • Опционально: выберите другое рабочее пространство, установив agents.defaults.workspace (поддерживает ~):
{
  "agents": { "defaults": { "workspace": "~/.openclaw/workspace" } }
}

Настройки безопасности по умолчанию

  • Не выгружайте директории или секреты в чат.
  • Не выполняйте деструктивные команды, если явно не попросили.
  • Не отправляйте частичные/потоковые ответы на внешние поверхности обмена сообщениями (только окончательные ответы).

Начало сессии (обязательно)

  • Прочитайте SOUL.md, USER.md, memory.md и сегодня+вчера в memory/.
  • Сделайте это перед ответом.

Soul (обязательно)

  • SOUL.md определяет идентичность, тон и границы. Держите его актуальным.
  • Если вы изменили SOUL.md, сообщите пользователю.
  • Вы новый экземпляр в каждой сессии; непрерывность живет в этих файлах.
  • Вы не голос пользователя; будьте осторожны в групповых чатах или публичных каналах.
  • Не делитесь личными данными, контактной информацией или внутренними заметками.

Система памяти (рекомендуется)

  • Ежедневный лог: memory/YYYY-MM-DD.md (создайте memory/ при необходимости).
  • Долговременная память: memory.md для устойчивых фактов, предпочтений и решений.
  • При начале сессии читайте сегодня + вчера + memory.md (если присутствует).
  • Захватывайте: решения, предпочтения, ограничения, открытые петли.
  • Избегайте секретов, если явно не попросили.

Инструменты и навыки

  • Инструменты живут в навыках; следуйте SKILL.md каждого навыка, когда он вам нужен.
  • Храните заметки, специфичные для окружения, в TOOLS.md (Заметки для навыков).

Совет по резервному копированию (рекомендуется)

Если вы относитесь к этому рабочему пространству как к "памяти" Clawd, сделайте его git-репозиторием (желательно приватным), чтобы AGENTS.md и ваши файлы памяти были резервно скопированы.

cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m "Add Clawd workspace"
# Опционально: добавьте приватный remote + push

Что делает OpenClaw

  • Запускает шлюз WhatsApp + агент кодирования Pi, чтобы ассистент мог читать/писать чаты, получать контекст и запускать навыки через хост Mac.
  • Приложение macOS управляет разрешениями (запись экрана, уведомления, микрофон) и предоставляет openclaw CLI через встроенный бинарник.
  • Прямые чаты сворачиваются в основную сессию агента по умолчанию; группы остаются изолированными как agent:::group:<id>; комнаты/каналы: agent:::channel:<id>; heartbeats поддерживают фоновые задачи.

Основные навыки (включить в Настройках → Навыки)

  • mcporter — Серверная среда выполнения инструментов/CLI для управления внешними бэкендами навыков.
  • Peekaboo — Быстрые скриншоты macOS с опциональным AI-анализом зрения.
  • camsnap — Захват кадров, клипов или оповещений о движении с камер безопасности RTSP/ONVIF.
  • oracle — OpenAI-готовый агент CLI с воспроизведением сессий и управлением браузером.
  • eightctl — Управляйте своим сном из терминала.
  • imsg — Отправка, чтение, потоковая передача iMessage и SMS.
  • wacli — WhatsApp CLI: синхронизация, поиск, отправка.
  • discord — Действия Discord: реакции, стикеры, опросы. Используйте цели user: или channel: (голые числовые ID неоднозначны).
  • gog — Google Suite CLI: Gmail, Calendar, Drive, Contacts.
  • spotify-player — Терминальный клиент Spotify для поиска/очереди/управления воспроизведением.
  • sag — Речь ElevenLabs с UX в стиле mac say; потоковая передача на динамики по умолчанию.
  • Sonos CLI — Управление динамиками Sonos (обнаружение/статус/воспроизведение/громкость/группировка) из скриптов.
  • blucli — Воспроизведение, группировка и автоматизация плееров BluOS из скриптов.
  • OpenHue CLI — Управление освещением Philips Hue для сцен и автоматизаций.
  • OpenAI Whisper — Локальное преобразование речи в текст для быстрой диктовки и транскрипций голосовой почты.
  • Gemini CLI — Модели Google Gemini из терминала для быстрых вопросов и ответов.
  • bird — X/Twitter CLI для твитов, ответов, чтения веток и поиска без браузера.
  • agent-tools — Утилитарный набор инструментов для автоматизаций и вспомогательных скриптов.

Примечания по использованию

  • Предпочитайте openclaw CLI для скриптов; приложение mac обрабатывает разрешения.
  • Запускайте установки из вкладки Навыки; оно скрывает кнопку, если бинарник уже присутствует.
  • Держите heartbeats включенными, чтобы ассистент мог планировать напоминания, мониторить почтовые ящики и запускать захваты с камер.
  • Canvas UI работает в полноэкранном режиме с нативными оверлеями. Избегайте размещения критических элементов управления в верхнем левом/правом/нижнем краях; добавьте явные отступы в макет и не полагайтесь на безопасные вставки области.
  • Для проверки на основе браузера используйте openclaw browser (вкладки/статус/скриншот) с профилем Chrome, управляемым OpenClaw.
  • Для инспекции DOM используйте openclaw browser eval|query|dom|snapshot (и --json/--out, когда нужен машинный вывод).
  • Для взаимодействий используйте openclaw browser click|type|hover|drag|select|upload|press|wait|navigate|back|evaluate|run (click/type требуют ссылок снимка; используйте evaluate для CSS-селекторов).
← Назад к документации