ClickClack

​

Configuration rapide

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

openclaw gateway

openclaw onboard

​

Alternative : jeton basé sur une variable d’environnement

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

​

Référence JSON5

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

​

Clés de configuration du compte

​

Plusieurs bots

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

​

Modes de réponse

• replyMode: "agent" (par défaut) transmet les messages entrants au pipeline normal de l’agent, notamment l’enregistrement de la session et la politique des outils.
• replyMode: "model" contourne le pipeline de l’agent et utilise le llm.complete de l’environnement d’exécution du plugin pour les réponses directes du bot, éventuellement structurées par model et systemPrompt. Le fournisseur et le modèle sélectionnés déterminent le budget de complétion.

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

​

Menu des commandes

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

​

Livraison durable des médias

• GET /api/uploads/by-nonce avec X-ClickClack-Upload-Nonce: supported pour les résultats trouvés et manquants.
• GET /api/messages/by-nonce avec X-ClickClack-Message-Nonce: supported pour les résultats trouvés et manquants.
• La création idempotente des messages et l’association des pièces jointes pour le même nonce limité au propriétaire et le même téléversement.

​

Lignes d’activité de l’agent

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

• Désactivé par défaut. Les configurations standard et les anciens serveurs ClickClack ne sont pas affectés.
• Nécessite la portée de jeton agent_activity:write. Cette portée est distincte de bot:write et n’en est pas héritée ; créez le jeton du bot avec --scopes bot:write,agent_activity:write (ou accordez cette portée à un jeton existant) avant d’activer l’option.
• Dégradation au mieux. Si le jeton ne dispose pas de agent_activity:write ou si le serveur rejette les écritures d’activité, les échecs sont consignés et la réponse finale est tout de même livrée normalement ; aucune ligne d’activité n’apparaît.
• Les lignes sont regroupées par tour (turn_id), fusionnées afin qu’une étape logique corresponde à une ligne, et les lignes d’outil utilisent la même mise en forme de progression que Discord/Slack/Telegram (nom de l’outil suivi des détails de la commande).
• Métadonnées d’attribution. Les publications rédigées par l’agent (lignes d’activité et réponse finale) comportent les champs author_model et author_thinking, résolus à partir du modèle réellement utilisé pour le tour (y compris après un repli). Les serveurs qui ne définissent pas ces colonnes ignorent les champs JSON inconnus ; ceux qui les conservent peuvent déterminer « quel modèle a produit cette ligne, et à quel niveau de réflexion » pour chaque message.

​

Cibles

• channel:<name-or-id> envoie vers un canal de l’espace de travail. Les cibles sans préfixe utilisent channel: par défaut.
• dm:<user_id> crée ou réutilise une conversation directe avec cet utilisateur.
• thread:<message_id> répond dans le fil de discussion dont ce message est la racine.

openclaw message send --channel clickclack --target channel:general --message "bonjour"
openclaw message send --channel clickclack --target dm:usr_123 --message "bonjour"
openclaw message send --channel clickclack --target thread:msg_123 --message "je reviens vers vous"

​

Autorisations

• bot:read : lecture des données de l’espace de travail, des canaux, des messages, des fils de discussion, des messages privés, du temps réel et des profils.
• bot:write : bot:read, ainsi que les messages de canal, les réponses dans les fils de discussion, les messages privés, les téléversements et la publication du menu de commandes.
• bot:admin : bot:write, ainsi que la création de canaux.
• commands:write : publication du menu de commandes du bot. Inclus dans les ensembles bot:write et bot:admin actuels et pouvant être accordé individuellement.
• agent_activity:write : lignes durables d’activité de l’agent (agent_commentary / agent_tool). Non hérité par bot:write ni bot:admin ; requis uniquement lorsque agentActivity: true est défini.

​

Dépannage

• ClickClack is not configured for account "<id>" : définissez baseUrl, token (par exemple via CLICKCLACK_BOT_TOKEN) et workspace pour ce compte.
• ClickClack workspace not found: <value> : définissez workspace sur l’identifiant, le slug ou le nom de l’espace de travail renvoyé par ClickClack.
• Aucune réponse entrante : vérifiez que le jeton dispose d’un accès en lecture en temps réel et notez que le bot ignore ses propres messages ainsi que ceux des autres bots.
• Échec des envois vers les canaux : vérifiez que le bot est membre de l’espace de travail et dispose de bot:write.
• Aucun menu de commandes : vérifiez que commandMenu n’est pas false, que le serveur ClickClack prend en charge PUT /api/bots/self/commands et que le jeton dispose de commands:write.