ClickClack

​

Schnelleinrichtung

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

​

Alternative: Manuelles Token

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

​

Alternative: Umgebungsbasiertes Token

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

​

JSON5-Referenz

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

​

Konfigurationsschlüssel für Konten

​

Einen öffentlich authentifizierungsgeschützten Hostnamen beibehalten

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

​

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

​

Sitzungsdiskussionen

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

​

Antwortmodi

• replyMode: "agent" (Standard) leitet eingehende Nachrichten durch die normale Agent-Pipeline, einschließlich Sitzungsaufzeichnung und Tool-Richtlinie.
• replyMode: "model" überspringt die Agent-Pipeline und verwendet llm.complete der Plugin-Laufzeit für direkte Bot-Antworten, die optional durch model und systemPrompt gestaltet werden. Der ausgewählte Provider und das Modell bestimmen das Completion-Budget.

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

​

Befehlsmenü

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

​

Dauerhafte Medienzustellung

• GET /api/uploads/by-nonce mit X-ClickClack-Upload-Nonce: supported bei gefundenen und fehlenden Ergebnissen.
• GET /api/messages/by-nonce mit X-ClickClack-Message-Nonce: supported bei gefundenen und fehlenden Ergebnissen.
• Idempotente Nachrichtenerstellung und Zuordnung von Anhängen für dieselbe eigentümerbezogene Nonce und denselben Upload.

​

Agent-Aktivitätszeilen

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

• Standardmäßig deaktiviert. Standardkonfigurationen und ältere ClickClack-Server bleiben unverändert.
• Erfordert den Token-Berechtigungsumfang agent_activity:write. Dieser Berechtigungsumfang ist von bot:write getrennt und wird nicht davon übernommen; erstellen Sie das Bot-Token mit --scopes bot:write,agent_activity:write (oder gewähren Sie einem vorhandenen Token den Berechtigungsumfang), bevor Sie die Option aktivieren.
• Beeinträchtigung nach bestem Bemühen. Wenn dem Token agent_activity:write fehlt oder der Server Aktivitätsschreibvorgänge ablehnt, werden die Fehler protokolliert und die endgültige Antwort dennoch normal zugestellt; es erscheinen keine Aktivitätszeilen.
• Zeilen werden pro Turn gruppiert (turn_id) und so zusammengeführt, dass ein logischer Schritt einer Zeile entspricht. Tool-Zeilen verwenden dieselbe Fortschrittsformatierung wie Discord/Slack/Telegram (Tool-Name plus Befehlsdetails).
• Attributionsmetadaten. Vom Agent verfasste Beiträge (Aktivitätszeilen und die endgültige Antwort) enthalten die Felder author_model und author_thinking, die anhand des tatsächlich für den Turn verwendeten Modells aufgelöst werden (auch nach einem Fallback). Server, die diese Spalten nicht definieren, ignorieren die unbekannten JSON-Felder; Server, die sie dauerhaft speichern, können pro Nachricht beantworten, „welches Modell diese Zeile auf welcher Denkstufe ausgegeben hat“.

​

Ziele

• channel:<name-or-id> sendet an einen Workspace-Kanal. Ziele ohne Präfix verwenden standardmäßig channel:.
• dm:<user_id> erstellt eine direkte Unterhaltung mit diesem Benutzer oder verwendet eine vorhandene.
• thread:<message_id> antwortet in dem Thread, dessen Wurzel diese Nachricht ist.

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"

​

Berechtigungen

• bot:read: Workspace-, Kanal-, Nachrichten-, Thread-, Direktnachrichten-, Echtzeit- und Profildaten lesen.
• bot:write: bot:read sowie Kanalnachrichten, Thread-Antworten, Direktnachrichten, Uploads und die Veröffentlichung des Befehlsmenüs.
• bot:admin: bot:write sowie die Kanalerstellung.
• commands:write: das Befehlsmenü des Bots veröffentlichen. In den aktuellen Paketen bot:write und bot:admin enthalten und einzeln gewährbar.
• agent_activity:write: dauerhafte Agent-Aktivitätszeilen (agent_commentary / agent_tool). Wird nicht von bot:write oder bot:admin übernommen; nur erforderlich, wenn agentActivity: true festgelegt ist.

​

Fehlerbehebung

• ClickClack is not configured for account "<id>": Legen Sie für dieses Konto baseUrl, token (beispielsweise über CLICKCLACK_BOT_TOKEN) und workspace fest.
• ClickClack workspace not found: <value>: Legen Sie workspace auf die von ClickClack zurückgegebene Workspace-ID, den Slug oder den Namen fest.
• Keine eingehenden Antworten: Vergewissern Sie sich, dass das Token über Echtzeit-Lesezugriff verfügt, und beachten Sie, dass der Bot seine eigenen Nachrichten und Nachrichten anderer Bots ignoriert.
• Kanal-Sendevorgänge schlagen fehl: Stellen Sie sicher, dass der Bot Mitglied des Workspace ist und über bot:write verfügt.
• Kein Befehlsmenü: Vergewissern Sie sich, dass commandMenu nicht false ist, der ClickClack-Server PUT /api/bots/self/commands unterstützt und das Token über commands:write verfügt.