ClickClack

ClickClack menghubungkan OpenClaw ke workspace ClickClack yang di-host sendiri melalui token bot ClickClack kelas satu.

Gunakan ini saat Anda ingin agen OpenClaw muncul sebagai pengguna bot ClickClack. ClickClack mendukung bot layanan independen dan bot milik pengguna; bot milik pengguna mempertahankan owner_user_id dan hanya menerima cakupan token yang Anda berikan.

Penyiapan cepat

Buat token bot di ClickClack:

clickclack admin bot create \  --workspace <workspace_id_or_slug> \  --name "OpenClaw" \  --handle openclaw \  --scopes bot:write \  --plain

Untuk bot milik pengguna, tambahkan --owner <user_id>.

Konfigurasikan OpenClaw:

{  plugins: {    entries: {      clickclack: {        llm: {          allowAgentIdOverride: true,        },      },    },  },  channels: {    clickclack: {      enabled: true,      baseUrl: "https://app.clickclack.chat",      token: { source: "env", provider: "default", id: "CLICKCLACK_BOT_TOKEN" },      workspace: "default",      defaultTo: "channel:general",      agentId: "clickclack-bot",      replyMode: "model",    },  },}

Lalu jalankan:

export CLICKCLACK_BOT_TOKEN="ccb_..."openclaw gateway

Jika plugins.allow adalah daftar pembatas yang tidak kosong, memilih ClickClack secara eksplisit dalam penyiapan saluran atau menjalankan openclaw plugins enable clickclack akan menambahkan clickclack ke daftar tersebut. Instalasi saat onboarding menggunakan perilaku pemilihan eksplisit yang sama. Jalur ini tidak menimpa plugins.deny atau pengaturan global plugins.enabled: false. Perintah langsung openclaw plugins install @openclaw/clickclack mengikuti kebijakan normal instalasi plugin dan juga mencatat ClickClack dalam allowlist yang sudah ada.

Beberapa bot

Setiap akun membuka koneksi realtime ClickClack miliknya sendiri dan menggunakan token bot miliknya sendiri.

{  plugins: {    entries: {      clickclack: {        llm: {          allowAgentIdOverride: true,        },      },    },  },  channels: {    clickclack: {      enabled: true,      baseUrl: "https://app.clickclack.chat",      defaultAccount: "service",      accounts: {        service: {          token: { source: "env", provider: "default", id: "CLICKCLACK_SERVICE_BOT_TOKEN" },          workspace: "default",          defaultTo: "channel:general",          agentId: "service-bot",          replyMode: "model",        },        peter: {          token: { source: "env", provider: "default", id: "CLICKCLACK_PETER_BOT_TOKEN" },          workspace: "default",          defaultTo: "dm:usr_...",          agentId: "peter-bot",          replyMode: "model",        },      },    },  },}

replyMode: "model" menggunakan api.runtime.llm.complete secara langsung untuk balasan bot singkat. Saat sebuah akun menetapkan agentId, OpenClaw memerlukan bit kepercayaan eksplisit plugins.entries.clickclack.llm.allowAgentIdOverride agar plugin dapat menjalankan completion untuk agen bot tersebut. Biarkan nonaktif jika Anda hanya menggunakan rute agen default.

Target

• channel:<name-or-id> mengirim ke saluran workspace. Target polos default ke channel:.
• dm:<user_id> membuat atau menggunakan ulang percakapan langsung dengan pengguna tersebut.
• thread:<message_id> membalas di thread yang sudah ada.

Contoh:

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"

Izin

Cakupan token ClickClack diterapkan oleh API ClickClack.

• bot:read: membaca data workspace/saluran/pesan/thread/DM/realtime/profil.
• bot:write: bot:read ditambah pesan saluran, balasan thread, DM, dan unggahan.
• bot:admin: bot:write ditambah pembuatan saluran.

OpenClaw hanya membutuhkan bot:write untuk chat agen normal.

Pemecahan masalah

• ClickClack is not configured: atur channels.clickclack.token atau CLICKCLACK_BOT_TOKEN.
• workspace not found: atur workspace ke id atau slug workspace yang dikembalikan oleh ClickClack.
• Tidak ada balasan masuk: pastikan token memiliki akses baca realtime dan bot tidak membalas pesannya sendiri.
• Pengiriman saluran gagal: verifikasi bot adalah anggota workspace dan memiliki bot:write.