ClickClack

​

Szybka konfiguracja

openclaw channels add clickclack --base-url https://clickclack.example.com --token ccb_... --workspace default

openclaw gateway

openclaw onboard

​

Alternatywa: token ze zmiennej środowiskowej

export CLICKCLACK_BOT_TOKEN="ccb_..."
openclaw channels add clickclack --base-url https://clickclack.example.com --workspace default --use-env
openclaw gateway

​

Dokumentacja referencyjna JSON5

{
  channels: {
    clickclack: {
      enabled: true,
      baseUrl: "https://clickclack.example.com",
      token: { source: "env", provider: "default", id: "CLICKCLACK_BOT_TOKEN" },
      workspace: "default",
      defaultTo: "channel:general",
    },
  },
}

​

Klucze konfiguracji konta

​

Wiele botów

{
  channels: {
    clickclack: {
      enabled: true,
      baseUrl: "https://clickclack.example.com",
      defaultAccount: "service",
      accounts: {
        service: {
          token: { source: "env", provider: "default", id: "CLICKCLACK_SERVICE_BOT_TOKEN" },
          workspace: "default",
          defaultTo: "channel:general",
          agentId: "service-bot",
        },
        support: {
          token: { source: "env", provider: "default", id: "CLICKCLACK_SUPPORT_BOT_TOKEN" },
          workspace: "default",
          defaultTo: "dm:usr_...",
          agentId: "support-bot",
        },
      },
    },
  },
}

​

Tryby odpowiedzi

• replyMode: "agent" (domyślnie) przekazuje wiadomości przychodzące przez standardowy potok agenta, w tym rejestrowanie sesji i politykę narzędzi.
• replyMode: "model" pomija potok agenta i używa llm.complete środowiska uruchomieniowego pluginu do bezpośrednich odpowiedzi bota, opcjonalnie kształtowanych przez model i systemPrompt. Wybrany dostawca i model określają budżet uzupełnienia.

{
  plugins: {
    entries: {
      clickclack: {
        llm: {
          allowAgentIdOverride: true,
        },
      },
    },
  },
}

​

Menu poleceń

{
  channels: {
    clickclack: {
      enabled: true,
      token: { source: "env", provider: "default", id: "CLICKCLACK_BOT_TOKEN" },
      workspace: "default",
      commandMenu: false,
    },
  },
}

​

Trwałe dostarczanie multimediów

• GET /api/uploads/by-nonce z X-ClickClack-Upload-Nonce: supported zarówno dla wyników znalezionych, jak i brakujących.
• GET /api/messages/by-nonce z X-ClickClack-Message-Nonce: supported zarówno dla wyników znalezionych, jak i brakujących.
• Idempotentne tworzenie wiadomości i powiązanie załącznika dla tego samego identyfikatora jednorazowego i przesłania w zakresie właściciela.

​

Wiersze aktywności agenta

{
  channels: {
    clickclack: {
      enabled: true,
      token: { source: "env", provider: "default", id: "CLICKCLACK_BOT_TOKEN" },
      workspace: "default",
      agentActivity: true,
    },
  },
}

• Domyślnie wyłączone. Standardowe konfiguracje i starsze serwery ClickClack pozostają bez zmian.
• Wymaga zakresu tokenu agent_activity:write. Ten zakres jest niezależny od bot:write i nie jest przez niego dziedziczony; przed włączeniem opcji należy utworzyć token bota z --scopes bot:write,agent_activity:write (lub przyznać ten zakres istniejącemu tokenowi).
• Łagodne ograniczanie funkcjonalności. Jeśli token nie ma agent_activity:write lub serwer odrzuca zapisy aktywności, awarie są rejestrowane, a końcowa odpowiedź nadal jest dostarczana normalnie; wiersze aktywności nie są wyświetlane.
• Wiersze są grupowane według tury (turn_id) i scalane tak, aby jeden logiczny krok odpowiadał jednemu wierszowi, a wiersze narzędzi używały tego samego formatowania postępu co Discord/Slack/Telegram (nazwa narzędzia i szczegóły polecenia).
• Metadane atrybucji. Wpisy utworzone przez agenta (wiersze aktywności i końcowa odpowiedź) zawierają pola author_model i author_thinking ustalone na podstawie modelu faktycznie użytego w danej turze (również po użyciu rozwiązania rezerwowego). Serwery, które nie definiują tych kolumn, ignorują nieznane pola JSON; serwery, które je utrwalają, mogą dla każdej wiadomości odpowiedzieć na pytanie „który model wypowiedział ten wiersz i na jakim poziomie rozumowania”.

​

Cele

• channel:<name-or-id> wysyła do kanału obszaru roboczego. Cele bez prefiksu domyślnie wskazują channel:.
• dm:<user_id> tworzy lub ponownie wykorzystuje bezpośrednią konwersację z tym użytkownikiem.
• thread:<message_id> odpowiada w wątku rozpoczętym przez tę wiadomość.

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

• bot:read: odczyt danych obszaru roboczego, kanałów, wiadomości, wątków, wiadomości prywatnych, komunikacji w czasie rzeczywistym i profili.
• bot:write: bot:read oraz wiadomości na kanałach, odpowiedzi w wątkach, wiadomości prywatne, przesyłanie plików i publikowanie menu poleceń.
• bot:admin: bot:write oraz tworzenie kanałów.
• commands:write: publikowanie menu poleceń bota. Uwzględnione w obecnych pakietach bot:write i bot:admin oraz możliwe do przyznania osobno.
• agent_activity:write: trwałe wiersze aktywności agenta (agent_commentary / agent_tool). Nie są dziedziczone przez bot:write ani bot:admin; wymagane tylko wtedy, gdy ustawiono agentActivity: true.

​

Rozwiązywanie problemów

• ClickClack is not configured for account "<id>": ustaw baseUrl, token (na przykład za pomocą CLICKCLACK_BOT_TOKEN) oraz workspace dla tego konta.
• ClickClack workspace not found: <value>: ustaw workspace na identyfikator, uproszczoną nazwę lub nazwę obszaru roboczego zwróconą przez ClickClack.
• Brak odpowiedzi przychodzących: upewnij się, że token ma uprawnienia do odczytu w czasie rzeczywistym, i pamiętaj, że bot ignoruje własne wiadomości oraz wiadomości od innych botów.
• Wysyłanie do kanału kończy się niepowodzeniem: sprawdź, czy bot jest członkiem obszaru roboczego i ma bot:write.
• Brak menu poleceń: upewnij się, że commandMenu nie ma wartości false, serwer ClickClack obsługuje PUT /api/bots/self/commands, a token ma commands:write.