// dokumentacja openclaw

Integracja OpenClaw z IRC — klasyczny protokół czatowy

Wprowadzenie

OpenClaw integruje się z IRC — klasycznym protokołem czatowym — obsługując zarówno kanały, jak i wiadomości prywatne. IRC działa jako wtyczka rozszerzenia konfigurowana w sekcji channels.irc pliku konfiguracyjnego.

Szybka konfiguracja

Konfiguracja wymaga trzech kroków:

  1. Włącz konfigurację IRC w pliku ~/.openclaw/openclaw.json
  2. Ustaw wymagane pola:
    • enabled: true — aktywacja kanału
    • host — adres serwera IRC
    • port — port połączenia
    • tls — włączenie/wyłączenie szyfrowania
    • nick — pseudonim bota
    • channels — tablica pokoi do dołączenia
  3. Uruchom Gateway: openclaw gateway run

Zalecamy korzystanie z prywatnego serwera IRC do koordynacji botów. Jeśli świadomie wybierasz publiczną sieć, popularne opcje to Libera.Chat, OFTC i Snoonet.

Przykład konfiguracji

{
  channels: {
    irc: {
      enabled: true,
      host: "irc.libera.chat",
      port: 6697,
      tls: true,
      nick: "openclaw-bot",
      channels: ["#moj-kanal", "#testowy"]
    }
  }
}

Kontrola dostępu

Dwie oddzielne warstwy zarządzają interakcjami IRC:

Dostęp do kanału

Kontroluje, czy bot przetwarza wiadomości z określonych kanałów.

Dostęp nadawcy

Określa, kto może wyzwalać odpowiedzi bota w obrębie dozwolonych kanałów.

Opcje konfiguracyjne:

  • allowFrom — lista dozwolonych nadawców DM
  • groupAllowFrom — globalna lista nadawców na kanałach
  • Kontrole per kanał przez groups["#kanal"]
  • groupPolicy — ustaw na open lub allowlist

Domyślna polityka DM to tryb parowania, a wiadomości grupowe domyślnie korzystają z trybu allowlist.

Uwaga: Dopasowywanie po samym nicku jest niestabilne (nick można zmienić) i jest dostępne tylko przy jawnym ustawieniu dangerouslyAllowNameMatching: true.

Wymaganie wzmianki

Domyślnie bot wymaga wzmianki na kanałach. Aby wyłączyć: ustaw requireMention: false dla konkretnych kanałów lub użyj konfiguracji wildcard dla wszystkich kanałów.

Ograniczenia narzędzi

Możesz ograniczyć możliwości bota na kanałach na dwa sposoby:

Jednolite ograniczenia

Te same ograniczenia narzędzi dla wszystkich użytkowników na kanale.

Ograniczenia per nadawca

Różny dostęp do narzędzi w zależności od tożsamości nadawcy, konfigurowany przez toolsBySender z kluczami prefiksowanymi id:.

Integracja NickServ

Opcjonalne uwierzytelnianie przez NickServ obejmuje:

  • Identyfikacja hasłem przy połączeniu
  • Jednorazowa rejestracja podczas pierwszego połączenia
  • Wyłączenie flagi rejestracji po początkowej konfiguracji

Zmienne środowiskowe

Obsługiwane zmienne:

  • IRC_HOST, IRC_PORT, IRC_TLS — dane połączenia
  • IRC_NICK, IRC_USERNAME, IRC_REALNAME — tożsamość bota
  • IRC_PASSWORD — hasło serwera
  • IRC_CHANNELS — lista kanałów
  • IRC_NICKSERV_PASSWORD — hasło NickServ
  • IRC_NICKSERV_REGISTER_EMAIL — e-mail do rejestracji

Rozwiązywanie problemów

  • Brak odpowiedzi — sprawdź konfigurację grupy i bramkowanie wzmiankami
  • Błędy logowania — zweryfikuj dostępność nicku i ustawienia NickServ
  • Problemy z TLS — sprawdź ustawienia hosta i portu
  • Szyfrowanie — upewnij się, że tls: true jest ustawione, jeśli serwer wymaga TLS
Wróc do dokumentacji