> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zapbip.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw

> Escreva para o OpenClaw no WhatsApp e ele responde, sem limite de tempo.

## O que funciona

O OpenClaw fica ouvindo seu WhatsApp por um pequeno canal do zapbip. Você escreve primeiro ou responde uma pergunta depois, e a mensagem chega na sessão do OpenClaw.

WhatsApp: OpenClaw

### Mensagens encaminhadas

Uma mensagem que você encaminhou de outra pessoa chega ao OpenClaw com um aviso de que não foi você quem escreveu, e ela não consegue executar comandos.

## Como ela escuta

Tipo: Local. Enquanto uma pergunta está aberta, o OpenClaw espera até 50 segundos por vez. Se você não respondeu, a espera termina como pendente e o OpenClaw chama de novo, quantas vezes for preciso, sem limite de tempo.

O canal mantém uma conexão aberta com o zapbip, sem limite de tempo. Se a rede cair, ele reconecta sozinho, esperando um pouco mais a cada tentativa que falha (1 segundo no começo, 30 segundos no máximo). As mensagens que você enviar nesse meio tempo esperam na sua caixa de entrada do zapbip, e o canal pega todas as que ficaram sem resposta assim que volta.

### Se o canal não puder ser instalado

O OpenClaw pode consultar a caixa de entrada. Adicione o servidor MCP da configuração e crie uma tarefa a cada 1 minuto que chama `check_inbox`. Suas mensagens esperam até um minuto, e a resposta volta do mesmo jeito.

## Configure do zero

### O que você precisa

* O OpenClaw 2026.10.10 ou mais novo, com o gateway rodando.
* Seu link de conexão, o mesmo link `https://.../c/<secret>/mcp` que sua IA usa para falar com o zapbip. Trate-o como uma senha.

### Instale o canal

O plugin lê as suas mensagens para este agente no zapbip e publica as respostas do agente de volta. Ele não faz mais nada. O comando de instalação precisa de `--accept-capabilities` para que o OpenClaw instale sem perguntar de novo.

```bash theme={null}
openclaw plugins install @zapbip/openclaw-plugin@0.1.0 --force --accept-capabilities
```

Depois defina o link no canal `zapbip` e ative o plugin no `openclaw.json`:

```json theme={null}
{
  "channels": { "zapbip": { "connectionLink": "https://<host>/c/<secret>/mcp" } },
  "plugins": { "entries": { "zapbip": { "enabled": true } } }
}
```

O arquivo que guarda seu link de conexão funciona como uma senha. Dê a ele a permissão `600`, para que só o seu usuário consiga ler, e nunca o compartilhe nem o envie para o Git:

```bash theme={null}
chmod 600 <arquivo>
```

Reinicie o gateway.

Rode apenas um listener por agente: o plugin ou `npx zapbip@0.1.0 listen`, nunca os dois. Um segundo listener substitui o primeiro.

### Como o OpenClaw responde

As respostas do OpenClaw às suas mensagens voltam pelo próprio canal, sem configuração extra. Se o envio de uma resposta falhar, o canal escreve `plugin_reply_failed` no log do gateway e não tenta de novo, então essa resposta pode se perder.

Adicione o zapbip como servidor MCP para o OpenClaw também puxar conversa com você, fazer uma pergunta com botões e esperar a resposta, e usar a consulta periódica abaixo:

```json theme={null}
{
  "mcp": {
    "servers": {
      "zapbip": { "url": "https://<host>/c/<secret>/mcp", "transport": "streamable-http" }
    }
  }
}
```

Depois peça ao OpenClaw no WhatsApp para enviar `✅ instalado`. Se essa mensagem chegar, está funcionando.

WhatsApp: zapbip

## Confira se funciona

| O que você vê | O que significa |
| - | - |
| Nenhuma resposta à sua mensagem | O gateway não está rodando, `channels.zapbip` não tem `connectionLink`, ou `plugins.entries.zapbip.enabled` não é `true`. |
| O canal para sozinho | Outro canal ou conector começou para a mesma conexão e o substituiu. |
| O OpenClaw ouve, mas a resposta não chega | O log do gateway mostra `plugin_reply_failed`: o envio da resposta falhou e não é repetido. Escreva de novo. |
| O OpenClaw não puxa conversa nem pergunta | O servidor MCP `zapbip` não está em `mcp.servers`. |
| O canal para com erro | O link é desconhecido ou a conexão foi revogada. Peça um novo. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.