ClickClack

​

Configuração rápida

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

openclaw gateway

openclaw onboard

​

Alternativa: token baseado em variável de ambiente

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

​

Referência JSON5

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

​

Chaves de configuração da conta

​

Vários 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",
        },
      },
    },
  },
}

​

Modos de resposta

• replyMode: "agent" (padrão) encaminha as mensagens recebidas pelo pipeline normal do agente, incluindo o registro da sessão e a política de ferramentas.
• replyMode: "model" ignora o pipeline do agente e usa llm.complete do runtime do plugin para respostas diretas do bot, opcionalmente configuradas por model e systemPrompt. O provedor e o modelo selecionados controlam o orçamento de conclusão.

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

​

Menu de comandos

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

​

Entrega durável de mídia

• GET /api/uploads/by-nonce com X-ClickClack-Upload-Nonce: supported em resultados encontrados e ausentes.
• GET /api/messages/by-nonce com X-ClickClack-Message-Nonce: supported em resultados encontrados e ausentes.
• Criação idempotente de mensagens e associação de anexos para o mesmo nonce com escopo do proprietário e o mesmo upload.

​

Linhas de atividade do agente

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

• Desativado por padrão. As configurações padrão e os servidores ClickClack mais antigos não são afetados.
• Exige o escopo de token agent_activity:write. Esse escopo é separado de bot:write e não é herdado por ele; crie o token do bot com --scopes bot:write,agent_activity:write (ou conceda o escopo a um token existente) antes de habilitar a opção.
• Degradação com melhor esforço. Se o token não tiver agent_activity:write ou se o servidor rejeitar gravações de atividade, as falhas serão registradas e a resposta final ainda será entregue normalmente; nenhuma linha de atividade aparecerá.
• As linhas são agrupadas por turno (turn_id), combinadas de modo que uma etapa lógica corresponda a uma linha, e as linhas de ferramentas usam a mesma formatação de progresso do Discord/Slack/Telegram (nome da ferramenta mais detalhes do comando).
• Metadados de atribuição. As publicações criadas pelo agente (linhas de atividade e a resposta final) incluem os campos author_model e author_thinking, resolvidos com base no modelo realmente usado no turno (inclusive após um fallback). Servidores que não definem essas colunas ignoram os campos JSON desconhecidos; servidores que os persistem podem responder “qual modelo disse esta linha e em qual nível de raciocínio” por mensagem.

​

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 na thread cuja mensagem raiz é essa.

openclaw message send --channel clickclack --target channel:general --message "olá"
openclaw message send --channel clickclack --target dm:usr_123 --message "olá"
openclaw message send --channel clickclack --target thread:msg_123 --message "dando continuidade"

​

Permissões

• bot:read: lê dados de espaço de trabalho, canal, mensagem, thread, DM, tempo real e perfil.
• bot:write: bot:read mais mensagens de canal, respostas em threads, DMs, uploads e publicação do menu de comandos.
• bot:admin: bot:write mais criação de canais.
• commands:write: publica o menu de comandos do bot. Incluído nos pacotes atuais bot:write e bot:admin e pode ser concedido individualmente.
• agent_activity:write: linhas persistentes de atividade do agente (agent_commentary / agent_tool). Não é herdado por bot:write nem bot:admin; necessário somente quando agentActivity: true está definido.

​

Solução de problemas

• ClickClack is not configured for account "<id>": defina baseUrl, token (por exemplo, por meio de CLICKCLACK_BOT_TOKEN) e workspace para essa conta.
• ClickClack workspace not found: <value>: defina workspace como o id, slug ou nome do espaço de trabalho retornado pelo ClickClack.
• Sem respostas recebidas: confirme se o token tem acesso de leitura em tempo real e observe que o bot ignora as próprias mensagens e as mensagens de outros bots.
• Falha nos envios para canais: verifique se o bot é membro do espaço de trabalho e tem bot:write.
• Sem menu de comandos: confirme que commandMenu não é false, que o servidor ClickClack oferece suporte a PUT /api/bots/self/commands e que o token tem commands:write.