Konfiguracja osobistego asystenta

​

Najpierw bezpieczeństwo

• Zawsze ustawiaj channels.whatsapp.allowFrom (nigdy nie uruchamiaj publicznie dostępnej usługi na prywatnym Macu).
• Używaj dedykowanego numeru WhatsApp dla asystenta.
• Domyślnie Heartbeat jest uruchamiany co 30 minut. Do czasu uzyskania zaufania do konfiguracji wyłącz go, ustawiając agents.defaults.heartbeat.every: "0m".

​

Wymagania wstępne

• Zainstalowany i skonfigurowany OpenClaw — jeśli nie zostało to jeszcze zrobione, zobacz Pierwsze kroki
• Drugi numer telefonu (SIM/eSIM/karta przedpłacona) dla asystenta

​

Konfiguracja z dwoma telefonami (zalecana)

​

Szybki start w 5 minut

1. Sparuj WhatsApp Web (zostanie wyświetlony kod QR; zeskanuj go telefonem asystenta):

openclaw channels login

2. Uruchom Gateway (pozostaw go uruchomionego):

openclaw gateway --port 18789

3. Umieść minimalną konfigurację w ~/.openclaw/openclaw.json:

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

​

Udostępnianie agentowi przestrzeni roboczej (AGENTS)

openclaw setup --baseline

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

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

​

Konfiguracja zmieniająca go w „asystenta”

• osobowość/instrukcje w SOUL.md
• domyślne ustawienia rozumowania (w razie potrzeby)
• Heartbeat (po uzyskaniu zaufania do konfiguracji)

{
  logging: { level: "info" },
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-8" },
      workspace: "~/.openclaw/workspace",
      thinkingDefault: "high",
      timeoutSeconds: 1800,
      // Zacznij od 0; włącz później.
      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,
    },
  },
}

​

Sesje i pamięć

• Wiersze sesji, wiersze transkrypcji i metadane (użycie tokenów, ostatnia trasa itp.): ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite
• Starsze/archiwalne artefakty transkrypcji: ~/.openclaw/agents/<agentId>/sessions/
• Źródło migracji starszych wierszy: ~/.openclaw/agents/<agentId>/sessions/sessions.json
• /new lub /reset rozpoczyna nową sesję dla danego czatu (można to skonfigurować za pomocą session.resetTriggers). Jeśli polecenie zostanie wysłane samodzielnie, OpenClaw potwierdzi zresetowanie bez wywoływania modelu.
• /compact [instructions] wykonuje Compaction kontekstu sesji i podaje pozostały budżet kontekstu.

​

Heartbeat (tryb proaktywny)

• Jeśli plik HEARTBEAT.md istnieje, ale jest faktycznie pusty (zawiera tylko puste wiersze, komentarze Markdown/HTML, nagłówki Markdown takie jak # Heading, znaczniki ogrodzeń lub puste elementy listy kontrolnej), OpenClaw pomija uruchomienie Heartbeat, aby ograniczyć liczbę wywołań API.
• Jeśli plik nie istnieje, Heartbeat nadal jest uruchamiany, a model decyduje, co zrobić.
• Jeśli agent odpowie HEARTBEAT_OK (opcjonalnie z krótkim dopełnieniem; zobacz agents.defaults.heartbeat.ackMaxChars), OpenClaw wstrzymuje dostarczenie wychodzące dla tego Heartbeat.
• Domyślnie dozwolone jest dostarczanie Heartbeat do celów user:<id> typu wiadomości bezpośredniej. Ustaw agents.defaults.heartbeat.directPolicy: "block", aby wstrzymać dostarczanie do celów bezpośrednich bez wyłączania uruchomień Heartbeat.
• Heartbeat uruchamia pełne tury agenta — krótsze odstępy zużywają więcej tokenów.

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

​

Multimedia przychodzące i wychodzące

• {{MediaPath}} (ścieżka lokalnego pliku tymczasowego)
• {{MediaUrl}} (pseudo-URL)
• {{Transcript}} (jeśli transkrypcja dźwięku jest włączona)

{
  "message": "Oto zrzut ekranu.",
  "mediaUrl": "https://example.com/screenshot.png"
}

• Jeśli tools.fs.workspaceOnly ma wartość true, wychodzące ścieżki lokalnych multimediów pozostają ograniczone do katalogu tymczasowego OpenClaw, pamięci podręcznej multimediów, ścieżek przestrzeni roboczej agenta oraz plików wygenerowanych w piaskownicy.
• Jeśli tools.fs.workspaceOnly ma wartość false, wychodzące lokalne multimedia mogą korzystać z lokalnych plików hosta, które agent ma już prawo odczytywać.
• Ścieżki lokalne mogą być bezwzględne, względne wobec przestrzeni roboczej lub względne wobec katalogu domowego przy użyciu ~/.
• Wysyłanie plików lokalnych hosta nadal dopuszcza wyłącznie multimedia i bezpieczne typy dokumentów (obrazy, dźwięk, wideo, PDF, dokumenty pakietów biurowych oraz zweryfikowane dokumenty tekstowe, takie jak Markdown/MD, TXT, JSON, YAML i YML). Jest to rozszerzenie istniejącej granicy zaufania dotyczącej odczytu z hosta, a nie skaner sekretów: jeśli agent może odczytać lokalny plik hosta secret.txt lub config.json, może go załączyć, gdy rozszerzenie i weryfikacja zawartości są zgodne.

​

Lista kontrolna operacji

openclaw status          # stan lokalny (dane uwierzytelniające, sesje, zdarzenia w kolejce)
openclaw status --all    # pełna diagnostyka (tylko do odczytu, możliwa do wklejenia)
openclaw status --deep   # sprawdzanie kanałów (WhatsApp Web + Telegram + Discord + Slack + Signal)
openclaw health --json   # migawka kondycji Gateway przez połączenie WS

​

Następne kroki

• WebChat: WebChat
• Obsługa Gateway: Podręcznik operacyjny Gateway
• Cron i wybudzenia: Zadania Cron
• Narzędzie towarzyszące na pasku menu macOS: Aplikacja OpenClaw dla macOS
• Aplikacja Node dla systemu iOS: Aplikacja dla systemu iOS
• Aplikacja Node dla systemu Android: Aplikacja dla systemu Android
• Centrum systemu Windows: Windows
• Stan systemu Linux: Aplikacja dla systemu Linux
• Bezpieczeństwo: Bezpieczeństwo

​

Powiązane

• Pierwsze kroki
• Konfiguracja
• Przegląd kanałów