ClickClack

​

Snelle installatie

openclaw channels add clickclack --code 'https://clickclack.example.com/#XXXX-XXXX-XXXX'

openclaw channels add clickclack --code 'https://api.example.com/services/clickclack/api/bot-setup-codes/claim#XXXX-XXXX-XXXX'

openclaw gateway

openclaw channels add clickclack --code XXXX-XXXX-XXXX --base-url https://clickclack.example.com

openclaw onboard

​

Alternatief: handmatig token

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

​

Alternatief: omgevingsvariabele voor token

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

​

JSON5-referentie

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

​

Configuratiesleutels voor accounts

​

Een door authenticatie afgeschermde openbare hostnaam behouden

{
  channels: {
    clickclack: {
      baseUrl: "https://clack.openclaw.ai",
      apiBaseUrl: "http://127.0.0.1:8484",
      token: { source: "env", provider: "default", id: "CLICKCLACK_BOT_TOKEN" },
      workspace: "default",
    },
  },
}

​

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

​

Sessiediscussies

{
  channels: {
    clickclack: {
      enabled: true,
      baseUrl: "https://clickclack.example.com",
      token: { source: "env", provider: "default", id: "CLICKCLACK_BOT_TOKEN" },
      workspace: "default",
      discussions: {
        enabled: true,
        workspace: "default",
        controlUrlBase: "https://team.openclaw.ai",
        section: "Sessions",
      },
    },
  },
}

​

Antwoordmodi

• replyMode: "agent" (standaard) verwerkt inkomende berichten via de normale agentpijplijn, inclusief sessieregistratie en toolbeleid.
• replyMode: "model" slaat de agentpijplijn over en gebruikt de llm.complete van de Plugin-runtime voor rechtstreekse botantwoorden, eventueel vormgegeven door model en systemPrompt. De geselecteerde provider en het geselecteerde model bepalen het voltooiingsbudget.

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

​

Opdrachtmenu

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

​

Duurzame medialevering

• GET /api/uploads/by-nonce met X-ClickClack-Upload-Nonce: supported voor gevonden en ontbrekende resultaten.
• GET /api/messages/by-nonce met X-ClickClack-Message-Nonce: supported voor gevonden en ontbrekende resultaten.
• Idempotent maken van berichten en koppelen van bijlagen voor dezelfde eigenaarsgebonden nonce en upload.

​

Rijen met agentactiviteit

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

• Standaard uitgeschakeld. Standaardconfiguraties en oudere ClickClack-servers blijven ongewijzigd.
• Vereist het tokenbereik agent_activity:write. Dit bereik staat los van bot:write en wordt er niet door overgenomen; maak het bottoken met --scopes bot:write,agent_activity:write (of ken het bereik toe aan een bestaand token) voordat je de optie inschakelt.
• Degradatie naar beste vermogen. Als het token agent_activity:write niet heeft of de server schrijfacties voor activiteit weigert, worden fouten gelogd en wordt het uiteindelijke antwoord nog steeds normaal geleverd; er verschijnen geen activiteitsrijen.
• Rijen worden per beurt gegroepeerd (turn_id) en samengevoegd zodat één logische stap één rij vormt. Toolrijen gebruiken dezelfde voortgangsopmaak als Discord/Slack/Telegram (toolnaam plus opdrachtdetails).
• Toeschrijvingsmetadata. Door agents geschreven berichten (activiteitsrijen en het uiteindelijke antwoord) bevatten de velden author_model en author_thinking, bepaald op basis van het model dat daadwerkelijk voor de beurt is gebruikt (ook na een fallback). Servers die deze kolommen niet definiëren, negeren de onbekende JSON-velden; servers die ze opslaan, kunnen per bericht antwoord geven op de vraag “welk model zei deze regel, op welk denkniveau”.

​

Doelen

• channel:<name-or-id> verzendt naar een werkruimtekanaal. Kale doelen gebruiken standaard channel:.
• dm:<user_id> maakt of hergebruikt een rechtstreeks gesprek met die gebruiker.
• thread:<message_id> antwoordt in de thread die bij dat bericht begint.

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"

​

Machtigingen

• bot:read: werkruimte-, kanaal-, bericht-, thread-, privébericht-, realtime- en profielgegevens lezen.
• bot:write: bot:read plus kanaalberichten, antwoorden in threads, privéberichten, uploads en publicatie van opdrachtmenu’s.
• bot:admin: bot:write plus het maken van kanalen.
• commands:write: het opdrachtmenu van de bot publiceren. Opgenomen in de huidige bundels bot:write en bot:admin en afzonderlijk toekenbaar.
• agent_activity:write: duurzame rijen met agentactiviteit (agent_commentary / agent_tool). Wordt niet overgenomen door bot:write of bot:admin; alleen vereist wanneer agentActivity: true is ingesteld.

​

Probleemoplossing

• ClickClack is not configured for account "<id>": stel voor dat account baseUrl, token (bijvoorbeeld via CLICKCLACK_BOT_TOKEN) en workspace in.
• ClickClack workspace not found: <value>: stel workspace in op de werkruimte-id, slug of naam die ClickClack retourneert.
• Geen inkomende antwoorden: controleer of het token realtime leestoegang heeft en houd er rekening mee dat de bot zijn eigen berichten en berichten van andere bots negeert.
• Verzending naar kanalen mislukt: controleer of de bot lid is van de werkruimte en bot:write heeft.
• Geen opdrachtmenu: controleer of commandMenu niet false is, of de ClickClack-server PUT /api/bots/self/commands ondersteunt en of het token commands:write heeft.