ClickClack

​

Configurazione rapida

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

openclaw gateway

openclaw onboard

​

Alternativa: token basato su variabile d’ambiente

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

​

Riferimento JSON5

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

​

Chiavi di configurazione dell’account

​

Più bot

{
  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",
        },
      },
    },
  },
}

​

Modalità di risposta

• replyMode: "agent" (predefinita) invia i messaggi in ingresso attraverso la normale pipeline dell’agente, inclusi la registrazione della sessione e i criteri degli strumenti.
• replyMode: "model" ignora la pipeline dell’agente e utilizza llm.complete del runtime del Plugin per le risposte dirette del bot, facoltativamente configurate da model e systemPrompt. Il provider e il modello selezionati determinano il budget del completamento.

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

​

Menu dei comandi

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

​

Recapito durevole dei contenuti multimediali

• GET /api/uploads/by-nonce con X-ClickClack-Upload-Nonce: supported per i risultati trovati e mancanti.
• GET /api/messages/by-nonce con X-ClickClack-Message-Nonce: supported per i risultati trovati e mancanti.
• Creazione idempotente dei messaggi e associazione degli allegati per lo stesso nonce con ambito limitato al proprietario e lo stesso caricamento.

​

Righe delle attività dell’agente

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

• Disattivata per impostazione predefinita. Le configurazioni standard e i server ClickClack meno recenti non vengono modificati.
• Richiede l’ambito del token agent_activity:write. Questo ambito è distinto da bot:write e non viene ereditato da esso; creare il token del bot con --scopes bot:write,agent_activity:write (oppure concedere l’ambito a un token esistente) prima di abilitare l’opzione.
• Degradazione basata sul massimo impegno. Se il token non include agent_activity:write o il server rifiuta le scritture delle attività, gli errori vengono registrati e la risposta finale viene comunque recapitata normalmente; non vengono visualizzate righe delle attività.
• Le righe vengono raggruppate per turno (turn_id), accorpate in modo che un passaggio logico corrisponda a una riga, e le righe degli strumenti utilizzano la stessa formattazione di avanzamento di Discord/Slack/Telegram (nome dello strumento più dettagli del comando).
• Metadati di attribuzione. I messaggi creati dall’agente (righe delle attività e risposta finale) includono i campi author_model e author_thinking, risolti dal modello effettivamente utilizzato per il turno (anche dopo un fallback). I server che non definiscono queste colonne ignorano i campi JSON sconosciuti; i server che li conservano possono rispondere, per ogni messaggio, alla domanda «quale modello ha prodotto questa riga e a quale livello di ragionamento».

​

Destinazioni

• channel:<name-or-id> invia a un canale dell’area di lavoro. Le destinazioni senza prefisso usano per impostazione predefinita channel:.
• dm:<user_id> crea o riutilizza una conversazione diretta con tale utente.
• thread:<message_id> risponde nel thread che ha origine da tale messaggio.

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"

​

Autorizzazioni

• bot:read: legge i dati relativi ad area di lavoro, canali, messaggi, thread, messaggi diretti, tempo reale e profili.
• bot:write: bot:read più messaggi dei canali, risposte nei thread, messaggi diretti, caricamenti e pubblicazione del menu dei comandi.
• bot:admin: bot:write più creazione dei canali.
• commands:write: pubblica il menu dei comandi del bot. Incluso negli attuali pacchetti bot:write e bot:admin e concedibile singolarmente.
• agent_activity:write: righe persistenti delle attività dell’agente (agent_commentary / agent_tool). Non ereditato da bot:write o bot:admin; richiesto solo quando è impostato agentActivity: true.

​

Risoluzione dei problemi

• ClickClack is not configured for account "<id>": impostare baseUrl, token (ad esempio tramite CLICKCLACK_BOT_TOKEN) e workspace per tale account.
• ClickClack workspace not found: <value>: impostare workspace sull’ID, sullo slug o sul nome dell’area di lavoro restituito da ClickClack.
• Nessuna risposta in entrata: verificare che il token disponga dell’accesso in lettura in tempo reale e tenere presente che il bot ignora i propri messaggi e quelli di altri bot.
• Gli invii ai canali non riescono: verificare che il bot sia membro dell’area di lavoro e disponga di bot:write.
• Nessun menu dei comandi: verificare che commandMenu non sia false, che il server ClickClack supporti PUT /api/bots/self/commands e che il token disponga di commands:write.