OpenClaw · e-mail de entrada

Um e-mail chega. Seu agente OpenClaw acorda.

Instale uma habilidade, forneça ao agente uma caixa de entrada gratuita e encaminhe o correio de entrada para um gancho de gateway dedicado com autenticação somente de cabeçalho.

Pré-requisito: um agente OpenClaw funcional com um provedor de modelo configurado · sem pesquisa · domínio personalizado posteriormente

OpenClaw · instalação atual
$openclaw skills install @gwendall/domani
Instalado · @gwendall/domani
$openclaw skills verify @gwendall/domani
Verificado · versão mais recente
$npx domani-cli login --surface skill
Aprovado · credencial armazenada nas chaves do sistema

O caminho do evento

O acionamento do webhook substitui um loop de pesquisa da caixa de entrada.

01

O e-mail chega

Uma mensagem chega a agent@domani.run.

02

Domani autentica

Authorization mais X-Domani-Signature acompanham o evento.

03

Mapas de gateway

/hooks/domani-email transforma a carga útil em uma tarefa de agente isolada.

04

Atos do agente

OpenClaw pode entregar a resposta final ao canal configurado.

Votação

Leituras repetidas, solicitações ociosas e atraso definido pelo intervalo de sondagem.

Webhook

Um push quando o correio é processado; reconciliar a caixa de entrada armazenada somente após o tempo de inatividade do receptor.

1 · Entrada de gateway

Mapeie a carga útil de Domani em uma execução de agente isolada.

Mesclar isso em `~/.openclaw/openclaw.json`; preservar configurações existentes mais rigorosas. Coloque dois valores aleatórios longos diferentes no ambiente Gateway ou `~/.openclaw/.env`: `OPENCLAW_GATEWAY_TOKEN` para autenticação do plano de controle e `OPENCLAW_HOOK_TOKEN` para esta entrada. As execuções de gancho do agente são isoladas por padrão. Reinicie após a validação.

openclaw.json · mesclar, não substituir
${ gateway: { mode: "local", bind: "loopback", auth: { mode: "token", token: "${OPENCLAW_GATEWAY_TOKEN}" } }, hooks: { enabled: true, token: "${OPENCLAW_HOOK_TOKEN}", path: "/hooks", allowRequestSessionKey: false, allowedAgentIds: ["main"], mappings: [{ match: { path: "domani-email" }, action: "agent", agentId: "main", wakeMode: "now", name: "Domani email", messageTemplate: "New email for {{email}}\nFrom: {{message.from}}\nSubject: {{message.subject}}\n\n{{message.text}}", deliver: true, channel: "last" }] } }

Token dedicado

Use um valor aleatório longo e não reutilize OPENCLAW_GATEWAY_TOKEN. O OpenClaw sinaliza a reutilização como uma descoberta crítica de segurança.

Exposição confiável

Mantenha o Gateway restrito ao loopback e exponha o hook por HTTPS usando uma tailnet ou um proxy reverso confiável. Configure trustedProxies com os IPs exatos dos proxies, quando aplicável.

Agente restrito

Trate o e-mail como uma entrada não confiável. Use uma política de ferramentas restritas e mantenha os desvios de conteúdo inseguro desativados.

Referência oficial do webhook do OpenClawConfiguração oficial de segurança

2 · Caixa de correio Domani

Passe o token pela variável de ambiente e comprove a entrega.

Use o formulário HTTPS acessível externamente do seu gancho mapeado. O prompt oculto mantém o valor do portador fora do histórico do shell e a CLI o lê sem imprimi-lo.

Domani CLI · seguro em segredo
$read -rsp 'OpenClaw hook token: ' OPENCLAW_HOOK_TOKEN; echo
$export OPENCLAW_HOOK_AUTH="Bearer $OPENCLAW_HOOK_TOKEN"
$domani email webhook agent@domani.run --url 'https://YOUR_GATEWAY/hooks/domani-email' --authorization-env OPENCLAW_HOOK_AUTH
Webhook configurado · Authorization
$domani email webhook-test agent@domani.run
Teste entregue · HTTP 200
$unset OPENCLAW_HOOK_TOKEN OPENCLAW_HOOK_AUTH

Teste primeiro

Exija um resultado 2xx antes de enviar e-mail ativo.

Ao vivo em segundo lugar

Envie um e-mail real e confirme exatamente o início de uma tarefa isolada.

Reconciliar após tempo de inatividade

Os retornos de chamada da caixa de correio ativa são tentados até três vezes. Ainda leia a caixa de entrada armazenada após um tempo de inatividade mais longo do Gateway porque a entrega do webhook ocorre pelo menos uma vez e as janelas de nova tentativa são limitadas.

Solução de problemas

Quatro limites para verificar.

401 / 429Verifique o token de gancho dedicado. A taxa do OpenClaw limita falhas repetidas de autenticação; espere por Retry-After em vez de tentar novamente com mais força.
404Confirme hooks.enabled, hooks.path e o caminho de mapeamento. O URL Domani deve terminar em /hooks/domani-email para este exemplo.
Tempo limiteAceitação de devolução antes de um longo trabalho do agente. O teste de Domani tem um tempo limite do receptor de 10 segundos.
Agente não é executadoValide a configuração, reinicie o Gateway, verifique allowedAgentIds e inspecione os logs do Gateway para identificar rejeições de mapeamento ou da política de modelo.

O teste Domani comprova que o Gateway aceitou o evento HTTP. Ele não mede o tempo de conclusão do modelo downstream.

Primeiro resultado

Crie a caixa de entrada. Teste o gancho. Envie o e-mail.

Mantenha a decisão do domínio personalizado para depois que o loop de eventos funcionar.

Integração comunitária usando interfaces OpenClaw e Domani documentadas.

API de webhook DomaniListagem do ClawHub