ClickClack

ClickClack łączy OpenClaw z samodzielnie hostowanym obszarem roboczym ClickClack za pomocą pełnoprawnych tokenów botów ClickClack.

Użyj tego, gdy chcesz, aby agent OpenClaw pojawiał się jako użytkownik-bot ClickClack. ClickClack obsługuje niezależne boty usługowe i boty należące do użytkowników; boty należące do użytkowników zachowują owner_user_id i otrzymują tylko te zakresy tokena, które im przyznasz.

Szybka konfiguracja

Utwórz token bota w ClickClack:

clickclack admin bot create \  --workspace <workspace_id_or_slug> \  --name "OpenClaw" \  --handle openclaw \  --scopes bot:write \  --plain

W przypadku bota należącego do użytkownika dodaj --owner <user_id>.

Skonfiguruj OpenClaw:

{  plugins: {    entries: {      clickclack: {        llm: {          allowAgentIdOverride: true,        },      },    },  },  channels: {    clickclack: {      enabled: true,      baseUrl: "https://app.clickclack.chat",      token: { source: "env", provider: "default", id: "CLICKCLACK_BOT_TOKEN" },      workspace: "default",      defaultTo: "channel:general",      agentId: "clickclack-bot",      replyMode: "model",    },  },}

Następnie uruchom:

export CLICKCLACK_BOT_TOKEN="ccb_..."openclaw gateway

Jeśli plugins.allow jest niepustą listą restrykcyjną, jawne wybranie ClickClack podczas konfiguracji kanału albo uruchomienie openclaw plugins enable clickclack dopisuje clickclack do tej listy. Instalacja podczas onboardingu używa tego samego zachowania opartego na jawnym wyborze. Te ścieżki nie nadpisują plugins.deny ani globalnego ustawienia plugins.enabled: false. Bezpośrednie openclaw plugins install @openclaw/clickclack działa zgodnie ze standardową polityką instalacji pluginów i także zapisuje ClickClack w istniejącej allowliście.

Wiele botów

Każde konto otwiera własne połączenie realtime z ClickClack i używa własnego tokena bota.

{  plugins: {    entries: {      clickclack: {        llm: {          allowAgentIdOverride: true,        },      },    },  },  channels: {    clickclack: {      enabled: true,      baseUrl: "https://app.clickclack.chat",      defaultAccount: "service",      accounts: {        service: {          token: { source: "env", provider: "default", id: "CLICKCLACK_SERVICE_BOT_TOKEN" },          workspace: "default",          defaultTo: "channel:general",          agentId: "service-bot",          replyMode: "model",        },        peter: {          token: { source: "env", provider: "default", id: "CLICKCLACK_PETER_BOT_TOKEN" },          workspace: "default",          defaultTo: "dm:usr_...",          agentId: "peter-bot",          replyMode: "model",        },      },    },  },}

replyMode: "model" używa bezpośrednio api.runtime.llm.complete do krótkich odpowiedzi bota. Gdy konto ustawia agentId, OpenClaw wymaga jawnego bitu zaufania plugins.entries.clickclack.llm.allowAgentIdOverride, aby plugin mógł uruchamiać uzupełnienia dla tego agenta bota. Pozostaw to wyłączone, jeśli używasz tylko domyślnej trasy agenta.

Cele

• channel:<name-or-id> wysyła do kanału obszaru roboczego. Cele bez prefiksu domyślnie używają channel:.
• dm:<user_id> tworzy lub ponownie wykorzystuje bezpośrednią rozmowę z tym użytkownikiem.
• thread:<message_id> odpowiada w istniejącym wątku.

Przykłady:

openclaw message send --channel clickclack --target channel:general --message "hello"openclaw message send --channel clickclack --target dm:usr_123 --message "hello"openclaw message send --channel clickclack --target thread:msg_123 --message "following up"

Uprawnienia

Zakresy tokenów ClickClack są egzekwowane przez API ClickClack.

• bot:read: odczyt danych obszaru roboczego/kanału/wiadomości/wątku/DM/realtime/profilu.
• bot:write: bot:read oraz wiadomości kanału, odpowiedzi w wątkach, DM i przesyłanie plików.
• bot:admin: bot:write oraz tworzenie kanałów.

OpenClaw potrzebuje tylko bot:write do zwykłego czatu agenta.

Rozwiązywanie problemów

• ClickClack is not configured: ustaw channels.clickclack.token albo CLICKCLACK_BOT_TOKEN.
• workspace not found: ustaw workspace na identyfikator obszaru roboczego albo slug zwrócony przez ClickClack.
• Brak odpowiedzi przychodzących: potwierdź, że token ma dostęp do odczytu realtime i że bot nie odpowiada na własne wiadomości.
• Wysyłanie do kanału kończy się niepowodzeniem: sprawdź, czy bot jest członkiem obszaru roboczego i ma bot:write.