Canais de Chat

Conecte o PicoClaw a plataformas de mensagens através do modo gateway.

picoclaw gateway

Canais Suportados

Canal	Dificuldade	Observações
Telegram	Fácil	Recomendado. Suporta transcrição de voz com Groq.
Discord	Fácil	Token de bot + intents. Suporta acionamento em grupo.
Slack	Fácil	Socket mode, sem necessidade de IP público.
QQ	Fácil	API oficial do QQ bot (AppID + AppSecret).
DingTalk	Médio	Stream mode, sem necessidade de IP público.
WeCom	Fácil	Integração unificada do WeCom baseada em WebSocket via AI Bot API. Login por QR suportado.
Feishu	Difícil	Plataforma de colaboração corporativa.
LINE	Difícil	Webhook via porta compartilhada do gateway.
OneBot	Médio	Compatível com NapCat/Go-CQHTTP.
Matrix	Fácil	Protocolo aberto e descentralizado. Suporta typing, placeholder e mídia.
WhatsApp	Médio	Modo bridge ou nativo (whatsmeow).
MaixCam	Fácil	Câmera de IA com integração de hardware.
VK	Fácil	Bot de comunidade do VKontakte via Long Poll API.
Pico	Fácil	Canal WebSocket nativo para clientes personalizados.

Como Funciona

1. Configure um ou mais canais em ~/.picoclaw/config.json sob a chave channels
2. Defina "enabled": true para cada canal que deseja usar
3. Execute picoclaw gateway para começar a escutar
4. O gateway gerencia todos os canais simultaneamente

Controle de Acesso

Todos os canais suportam o campo allow_from para restringir o acesso a usuários específicos:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_TOKEN",
      "allow_from": ["123456789"]
    }
  }
}

Defina allow_from como um array vazio [] para permitir todos os usuários. Você também pode usar allow_from: ["*"] para permitir explicitamente todos os usuários (um aviso será registrado no log na inicialização).

Campos Comuns dos Canais

Todos os canais suportam estes campos opcionais:

Campo	Descrição
reasoning_channel_id	Direcionar a saída de raciocínio/pensamento para um canal separado
group_trigger	Controlar o comportamento do bot em chats de grupo (somente menção, prefixos)

Gateway Compartilhado

Todos os canais baseados em webhook (LINE, DingTalk, etc.) compartilham o único servidor HTTP do gateway na porta 18790. Os campos webhook_host/webhook_port por canal não são mais necessários — basta configurar webhook_path para diferenciar os endpoints. O WeCom agora usa WebSocket outbound e não requer um webhook público.

A verbosidade dos logs é controlada por gateway.log_level (padrão: warn). Valores suportados: debug, info, warn, error, fatal.