ClickClack

ClickClack conecta o OpenClaw a um espaço de trabalho ClickClack auto-hospedado por meio de tokens de bot do ClickClack de primeira classe.

Use isto quando você quiser que um agente do OpenClaw apareça como um usuário bot do ClickClack. O ClickClack oferece suporte a bots de serviço independentes e bots pertencentes a usuários; bots pertencentes a usuários mantêm um owner_user_id e recebem apenas os escopos de token que você concede.

Configuração rápida

Crie um token de bot no ClickClack:

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

Para um bot pertencente a um usuário, adicione --owner <user_id>.

Configure o 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",    },  },}

Em seguida, execute:

export CLICKCLACK_BOT_TOKEN="ccb_..."openclaw gateway

Vários bots

Cada conta abre sua própria conexão em tempo real com o ClickClack e usa seu próprio token de bot.

{  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" usa api.runtime.llm.complete diretamente para respostas curtas do bot. Quando uma conta define agentId, o OpenClaw exige o bit de confiança explícito plugins.entries.clickclack.llm.allowAgentIdOverride para que o plugin possa executar conclusões para esse agente bot. Mantenha desativado se você usa apenas a rota do agente padrão.

Destinos

• channel:<name-or-id> envia para um canal do espaço de trabalho. Destinos sem prefixo usam channel: por padrão.
• dm:<user_id> cria ou reutiliza uma conversa direta com esse usuário.
• thread:<message_id> responde em uma thread existente.

Exemplos:

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"

Permissões

Os escopos de token do ClickClack são aplicados pela API do ClickClack.

• bot:read: lê dados de espaço de trabalho/canal/mensagem/thread/DM/tempo real/perfil.
• bot:write: bot:read mais mensagens de canal, respostas em threads, DMs e uploads.
• bot:admin: bot:write mais criação de canais.

O OpenClaw precisa apenas de bot:write para conversas normais de agente.

Solução de problemas

• ClickClack is not configured: defina channels.clickclack.token ou CLICKCLACK_BOT_TOKEN.
• workspace not found: defina workspace como o ID ou slug do espaço de trabalho retornado pelo ClickClack.
• Sem respostas recebidas: confirme que o token tem acesso de leitura em tempo real e que o bot não está respondendo às próprias mensagens.
• Falhas ao enviar para canais: verifique se o bot é membro do espaço de trabalho e tem bot:write.