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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

⚠️ Спершу безпека

• виконувати команди на вашій машині (залежно від вашої політики інструментів)
• читати/записувати файли у вашому робочому просторі
• надсилати повідомлення назад через WhatsApp/Telegram/Discord/Mattermost та інші вбудовані канали

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

​

Передумови

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

​

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

​

Швидкий старт за 5 хвилин

1. Спарте WhatsApp Web (показує QR; проскануйте його телефоном асистента):

openclaw channels login

2. Запустіть Gateway (залиште його працювати):

openclaw gateway --port 18789

3. Додайте мінімальну конфігурацію в ~/.openclaw/openclaw.json:

{
  gateway: { mode: "local" },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

​

Дайте агенту робочий простір (AGENTS)

openclaw setup

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

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

​

Конфігурація, яка перетворює це на “асистента”

• persona/інструкції в SOUL.md
• стандартні параметри мислення (за потреби)
• Heartbeat-и (коли ви вже довірятимете цьому)

{
  logging: { level: "info" },
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      workspace: "~/.openclaw/workspace",
      thinkingDefault: "high",
      timeoutSeconds: 1800,
      // Start with 0; enable later.
      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>/sessions/{{SessionId}}.jsonl
• Метадані сесій (використання токенів, останній маршрут тощо): ~/.openclaw/agents/<agentId>/sessions/sessions.json (застаріле: ~/.openclaw/sessions/sessions.json)
• /new або /reset починає нову сесію для цього чату (налаштовується через resetTriggers). Якщо надіслано окремо, OpenClaw підтверджує скидання без виклику моделі.
• /compact [instructions] ущільнює контекст сесії та повідомляє залишковий бюджет контексту.

​

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

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

{
  agents: {
    defaults: {
      heartbeat: { every: "30m" },
    },
  },
}

​

Медіа на вхід і вихід

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

Here's the screenshot.
MEDIA:https://example.com/screenshot.png

• Якщо tools.fs.workspaceOnly має значення true, вихідні локальні шляхи MEDIA: залишаються обмеженими тимчасовим коренем OpenClaw, медіакешем, шляхами робочого простору агента та файлами, згенерованими в sandbox.
• Якщо tools.fs.workspaceOnly має значення false, вихідні MEDIA: можуть використовувати локальні файли хоста, які агенту вже дозволено читати.
• Локальні шляхи можуть бути абсолютними, відносними до робочого простору або відносними до home із ~/.
• Надсилання локальних файлів хоста все одно дозволяє лише медіа та безпечні типи документів (зображення, аудіо, відео, PDF і документи Office). Звичайний текст і файли, схожі на секрети, не вважаються медіа, які можна надсилати.

​

Операційний чекліст

openclaw status          # local status (creds, sessions, queued events)
openclaw status --all    # full diagnosis (read-only, pasteable)
openclaw status --deep   # asks the gateway for a live health probe with channel probes when supported
openclaw health --json   # gateway health snapshot (WS; default can return a fresh cached snapshot)

​

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

• WebChat: WebChat
• Операції Gateway: Runbook Gateway
• Cron + пробудження: Cron jobs
• Компаньйон у рядку меню macOS: застосунок OpenClaw для macOS
• Застосунок iOS node: застосунок iOS
• Застосунок Android node: застосунок Android
• Статус Windows: Windows (WSL2)
• Статус Linux: застосунок Linux
• Безпека: Безпека

​

Пов’язане

• Початок роботи
• Налаштування
• Огляд каналів