ClickClack

ClickClack menghubungkan OpenClaw ke ruang kerja 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

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 mewajibkan 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 kanal ruang kerja. Target polos secara default menjadi channel:.
• dm:<user_id> membuat atau menggunakan kembali 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 diberlakukan oleh API ClickClack.

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

OpenClaw hanya memerlukan bot:write untuk chat agen normal.

Pemecahan masalah

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