OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Guides

Налаштування персонального асистента

OpenClaw — це самостійно розміщуваний Gateway, який підключає Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo та інші сервіси до ШІ-агентів. У цьому посібнику описано налаштування «особистого помічника»: окремий номер WhatsApp, який працює як ваш постійно доступний ШІ-помічник.

Передусім — безпека

Надання агенту каналу дає йому змогу виконувати команди на вашому комп’ютері (залежно від політики інструментів), читати й записувати файли в робочій області та надсилати повідомлення через будь-який підключений канал. Починайте з обмежених налаштувань:

  • Завжди задавайте channels.whatsapp.allowFrom (ніколи не відкривайте доступ усьому світу на особистому Mac).
  • Використовуйте для помічника окремий номер WhatsApp.
  • За замовчуванням Heartbeat виконується кожні 30 хвилин. Вимкніть його, доки не переконаєтеся в надійності налаштування, задавши agents.defaults.heartbeat.every: "0m".

Передумови

  • OpenClaw установлено й виконано початкове налаштування — див. Початок роботи, якщо ви ще цього не зробили
  • Другий номер телефону (SIM/eSIM/передплачений) для помічника

Налаштування з двома телефонами (рекомендовано)

Потрібна така схема:

flowchart TB
    A["<b>Ваш телефон (особистий)<br></b><br>Ваш WhatsApp<br>+1-555-YOU"] -- повідомлення --> B["<b>Другий телефон (помічник)<br></b><br>WhatsApp помічника<br>+1-555-ASSIST"]
    B -- з’єднано через QR-код --> C["<b>Ваш Mac (openclaw)<br></b><br>ШІ-агент"]

Якщо підключити особистий WhatsApp до OpenClaw, кожне адресоване вам повідомлення стане «вхідними даними агента». Зазвичай це не те, що потрібно.

Швидкий запуск за 5 хвилин

  1. Підключіть WhatsApp Web (з’явиться QR-код; відскануйте його телефоном помічника):
bash
openclaw channels login
  1. Запустіть Gateway (залиште його запущеним):
bash
openclaw gateway --port 18789
  1. Додайте мінімальну конфігурацію до ~/.openclaw/openclaw.json:
json5
{  gateway: { mode: "local" },  channels: { whatsapp: { allowFrom: ["+15555550123"] } },}

Тепер надішліть повідомлення на номер помічника з телефону, доданого до списку дозволених.

Після завершення початкового налаштування OpenClaw автоматично відкриває панель керування та виводить чисте посилання (без токена). Якщо панель керування запитує автентифікацію, вставте налаштований спільний секрет у параметрах Control UI. За замовчуванням для початкового налаштування використовується токен (gateway.auth.token), але автентифікація за паролем також працює, якщо gateway.auth.mode змінено на password. Щоб відкрити панель пізніше: openclaw dashboard.

Надайте агенту робочу область (AGENTS)

OpenClaw зчитує інструкції з роботи та «пам’ять» із каталогу робочої області.

За замовчуванням OpenClaw використовує ~/.openclaw/workspace як робочу область агента й автоматично створює її (разом із початковими файлами AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md) під час початкового налаштування або першого запуску агента. BOOTSTRAP.md створюється лише для абсолютно нової робочої області й не має з’являтися знову після видалення. MEMORY.md є необов’язковим і ніколи не створюється автоматично; якщо він наявний, то завантажується для звичайних сеансів. У сеанси субагентів додаються лише AGENTS.md та TOOLS.md.

Щоб створити папки робочої області та конфігурації без запуску повного майстра початкового налаштування:

bash
openclaw setup --baseline

(Команда openclaw setup без аргументів є псевдонімом для openclaw onboard і запускає повний інтерактивний майстер.)

Повна структура робочої області та посібник із резервного копіювання: Робоча область агента Робочий процес пам’яті: Пам’ять

Необов’язково: виберіть іншу робочу область за допомогою agents.defaults.workspace (підтримує ~).

json5
{  agents: {    defaults: {      workspace: "~/.openclaw/workspace",    },  },}

Якщо власні файли робочої області вже постачаються з репозиторію, створення початкових файлів можна повністю вимкнути:

json5
{  agents: {    defaults: {      skipBootstrap: true,    },  },}

Конфігурація, яка перетворює його на «помічника»

OpenClaw за замовчуванням має вдале налаштування помічника, але зазвичай варто відкоригувати:

  • особистість та інструкції в SOUL.md
  • стандартні параметри міркування (за потреби)
  • Heartbeats (коли ви вже довіряєте налаштуванню)

Приклад:

json5
{  logging: { level: "info" },  agents: {    defaults: {      model: { primary: "anthropic/claude-opus-4-8" },      workspace: "~/.openclaw/workspace",      thinkingDefault: "high",      timeoutSeconds: 1800,      // Спочатку встановіть 0; увімкніть пізніше.      heartbeat: { every: "0m" },    },    list: [      {        id: "main",        default: true,        groupChat: {          mentionPatterns: ["@openclaw", "openclaw"],        },      },    ],  },  channels: {    whatsapp: {      allowFrom: ["+15555550123"],      groups: {        "*": { requireMention: true },      },    },  },  session: {    scope: "per-sender",    resetTriggers: ["/new", "/reset"],    reset: {      mode: "daily",      atHour: 4,      idleMinutes: 10080,    },  },}

Сеанси та пам’ять

  • Рядки сеансів, рядки стенограм і метадані (використання токенів, останній маршрут тощо): ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite
  • Застарілі або архівні артефакти стенограм: ~/.openclaw/agents/<agentId>/sessions/
  • Джерело міграції застарілих рядків: ~/.openclaw/agents/<agentId>/sessions/sessions.json
  • /new або /reset починає новий сеанс для цього чату (налаштовується через session.resetTriggers). Якщо надіслати команду окремо, OpenClaw підтвердить скидання без виклику моделі.
  • /compact [instructions] ущільнює контекст сеансу та повідомляє про залишок бюджету контексту.

Heartbeats (проактивний режим)

За замовчуванням OpenClaw запускає Heartbeat кожні 30 хвилин із запитом: Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK. Щоб вимкнути, задайте agents.defaults.heartbeat.every: "0m".

  • Якщо HEARTBEAT.md існує, але фактично порожній (містить лише порожні рядки, коментарі Markdown/HTML, заголовки Markdown на кшталт # Heading, маркери блоків або порожні заготовки списків перевірки), OpenClaw пропускає запуск Heartbeat, щоб заощадити виклики API.
  • Якщо файл відсутній, Heartbeat усе одно запускається, а модель вирішує, що робити.
  • Якщо агент відповідає HEARTBEAT_OK (необов’язково з коротким доповненням; див. agents.defaults.heartbeat.ackMaxChars), OpenClaw не надсилає вихідне повідомлення для цього Heartbeat.
  • За замовчуванням доставлення Heartbeat до цілей user:<id> типу особистих повідомлень дозволено. Задайте agents.defaults.heartbeat.directPolicy: "block", щоб вимкнути доставлення безпосереднім адресатам, не припиняючи запуски Heartbeat.
  • Heartbeats виконують повні цикли роботи агента — коротші інтервали витрачають більше токенів.
json5
{  agents: {    defaults: {      heartbeat: { every: "30m" },    },  },}

Вхідні та вихідні медіафайли

Вхідні вкладення (зображення, аудіо й документи) можна передавати команді через шаблони:

  • {{MediaPath}} (шлях до локального тимчасового файла)
  • {{MediaUrl}} (псевдо-URL)
  • {{Transcript}} (якщо ввімкнено транскрибування аудіо)

Вихідні вкладення від агента використовують структуровані поля медіаданих інструмента повідомлень або корисного навантаження відповіді, як-от media, mediaUrl, mediaUrls, path або filePath. Приклад аргументів інструмента повідомлень:

json
{  "message": "Ось знімок екрана.",  "mediaUrl": "https://example.com/screenshot.png"}

OpenClaw надсилає структуровані медіадані разом із текстом. Застарілі фінальні відповіді помічника все ще можуть нормалізуватися задля сумісності, але вивід інструментів, вивід браузера, потокові блоки та дії з повідомленнями не розбирають текст як команди вкладень.

Поведінка локальних шляхів відповідає тій самій моделі довіри до читання файлів, що й для агента:

  • Якщо tools.fs.workspaceOnly має значення true, вихідні шляхи до локальних медіафайлів залишаються обмеженими тимчасовим кореневим каталогом OpenClaw, кешем медіафайлів, шляхами робочої області агента та файлами, створеними в пісочниці.
  • Якщо tools.fs.workspaceOnly має значення false, для вихідних локальних медіафайлів можна використовувати локальні файли хоста, які агенту вже дозволено читати.
  • Локальні шляхи можуть бути абсолютними, відносними щодо робочої області або відносними щодо домашнього каталогу з ~/.
  • Під час надсилання локальних файлів хоста все одно дозволяються лише медіафайли та безпечні типи документів (зображення, аудіо, відео, PDF, документи Office і перевірені текстові документи, як-от Markdown/MD, TXT, JSON, YAML та YML). Це розширення наявної межі довіри до читання з хоста, а не сканер секретів: якщо агент може прочитати локальний файл хоста secret.txt або config.json, він може прикріпити цей файл, якщо розширення та перевірка вмісту відповідають вимогам.

Зберігайте конфіденційні файли поза доступною агенту файловою системою або залиште tools.fs.workspaceOnly: true для суворіших обмежень на надсилання локальних шляхів.

Контрольний список експлуатації

bash
openclaw status          # локальний стан (облікові дані, сеанси, події в черзі)openclaw status --all    # повна діагностика (лише читання, можна вставляти)openclaw status --deep   # перевірка каналів (WhatsApp Web + Telegram + Discord + Slack + Signal)openclaw health --json   # знімок стану Gateway через з’єднання WS

Журнали зберігаються в /tmp/openclaw/ (за замовчуванням: openclaw-YYYY-MM-DD.log).

Наступні кроки

Пов’язані матеріали

Was this useful?
On this page

On this page