Guia do Agente Autônomo OpenClaw: Arquitetura, Docker e Custos

### Resposta Rápida: O que é o OpenClaw e quais suas vantagens?

O OpenClaw é um assistente de IA pessoal autônomo e de código aberto com arquitetura Gateway desacoplada, integração nativa a mais de 20 canais de mensagens e execução multiagente em sandbox. Ao contrário de plataformas SaaS fechadas de US$ 20 a US$ 50/mês, o OpenClaw não tem mensalidade (US$ 0) e custa apenas US$ 0,003 a US$ 0,042 por execução via API direta.

1. Visão Geral: O que representa o OpenClaw em 2026?

Em 2026, a tecnologia de agentes de IA superou as simples caixas de diálogo para se consolidar em loops contínuos de execução autônoma orientados a eventos, ativos 24 horas por dia. Enquanto Claude Code e OpenAI Codex operam no terminal do desenvolvedor, o OpenClaw (anteriormente openclaw.ai) firmou-se como a principal plataforma open-source para assistentes pessoais integrados a múltiplos aplicativos de mensagens, rotinas agendadas (Cron) e orquestração multiagente protegida por sandbox.

O OpenClaw sustenta-se em três pilares:

1. Protocolo Gateway Desacoplado: Um daemon central na porta 18789 encarregado de rotear mensagens, persistir sessões, executar tarefas agendadas e processar webhooks.
2. Integração Multicanal Nativa: Conexão com mais de 20 plataformas de comunicação, como Telegram, WhatsApp (Baileys), Discord (Bot API + Gateway), Slack (Bolt SDK), Signal, iMessage, Matrix e WebChat.
3. Mecanismo de Skills e Sandboxing: Padrão de habilidades em Markdown (SKILL.md) no ecossistema ClawHub, aliado ao isolamento estrito via contêineres Docker e restrição de privilégios POSIX.

2. Arquitetura do OpenClaw: Gateway, Canais e Workspace

O núcleo do OpenClaw é a separação entre plano de controle e plano de execução. O daemon em segundo plano (OpenClaw Gateway) se comunica via WebSockets e sockets de domínio Unix com clientes e APIs de mensageria.

+-----------------------------------------------------------------------------------+
|                            Canais Externos de Mensagens                           |
|   Telegram  |  WhatsApp  |  Discord  |  Slack  |  Signal  |  iMessage  |  Matrix  |
+-----------------------------------------------------------------------------------+
                                          | (Webhook / WebSocket / Bot API)
                                          v
+-----------------------------------------------------------------------------------+
|                            OpenClaw Gateway (Porta 18789)                         |
|  - Emparelhamento DM e validação Allowlist - Memória de contexto e sessões        |
|  - Mecanismo agendador Cron (CronTab)     - Roteamento e ingestão de Webhooks     |
|  - Atualização dinâmica (Hybrid Watch)    - Tolerância a falhas e troca de modelos|
+-----------------------------------------------------------------------------------+
       |                                      |                              |
       v                                      v                              v
+------------------+                  +------------------+         +-------------------+
|  Agente: Casa    |                  |  Agente: Trabalho|         |  Agente: DevOps   |
|  - Workspace-Home|                  |  - Workspace-Work|         |  - Workspace-Ops  |
|  - SOUL.md       |                  |  - SOUL.md       |         |  - SOUL.md        |
|  - CRM Pessoal   |                  |  - Jira / Linear |         |  - CI/CD e SSH    |
+------------------+                  +------------------+         +-------------------+
       |                                      |                              |
       +--------------------------------------+------------------------------+
                                          |
                                          v
+-----------------------------------------------------------------------------------+
|                       Camada de Execução Multiagente em Sandbox                   |
|  - Isolamento em contêineres Docker (`mode: non-main` / `mode: all`)              |
|  - Privilégios POSIX descartados (`cap_drop: ALL`, UID não privilegiado 10001)    |
|  - Montagens somente leitura (`:ro`) e memória volátil Tmpfs (`/tmp:noexec`)      |
|  - Runtime de Skills ClawHub (parser de `SKILL.md` e verificação de binários)     |
+-----------------------------------------------------------------------------------+

Estrutura de Diretórios do Workspace

~/.openclaw/
├── openclaw.json          # Configuração declarativa principal (JSON5)
├── cron.json              # Tarefas agendadas e rotinas recorrentes
├── state/                 # Banco SQLite de sessões, cache e tokens
├── skills/                # Habilidades compartilhadas globalmente
└── workspace/             # Diretório de trabalho padrão do agente
    ├── AGENTS.md          # Diretrizes gerais de comportamento do agente
    ├── SOUL.md            # Persona, tom, diretrizes de segurança e estilo
    ├── TOOLS.md           # Definições de ferramentas locais
    └── skills/            # Habilidades exclusivas do espaço de trabalho
        └── repo-analyzer/
            └── SKILL.md   # Declaração executável da habilidade

Comandos de Operação do Gateway

# Inspecionar status do Gateway, portas e consumo de RAM
openclaw gateway status

# Inicializar o Gateway em segundo plano
openclaw gateway start

# Executar em primeiro plano com logs detalhados
openclaw gateway --port 18789 --verbose

# Diagnóstico de integridade e auditoria de configuração
openclaw doctor

# Correção automática de permissões e diretórios ausentes
openclaw doctor --fix

3. Guia de Deploy em Produção com Docker

Executar agentes autônomos com acesso à linha de comando diretamente no sistema operacional hospedeiro expõe a infraestrutura a sérios riscos. A prática padrão consiste em utilizar Docker Compose com rede isolada.

Arquivo docker-compose.yml

version: "3.9"

services:
  openclaw-gateway:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw-gateway
    restart: unless-stopped
    user: "10001:10001"
    security_opt:
      - no-new-privileges:true
    cap_drop:
      - ALL
    cap_add:
      - CHOWN
      - SETUID
      - SETGID
    environment:
      - NODE_ENV=production
      - OPENCLAW_HOME=/home/openclaw/.openclaw
      - OPENCLAW_STATE_DIR=/home/openclaw/.openclaw/state
      - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}
      - OPENCLAW_GATEWAY_PASSWORD=${OPENCLAW_GATEWAY_PASSWORD}
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - OPENAI_API_KEY=${OPENAI_API_KEY}
      - DEEPSEEK_API_KEY=${DEEPSEEK_API_KEY}
    volumes:
      - openclaw-config:/home/openclaw/.openclaw
      - openclaw-workspace:/home/openclaw/.openclaw/workspace
      - /var/run/docker.sock:/var/run/docker.sock:ro
    ports:
      - "127.0.0.1:18789:18789"
    networks:
      - openclaw-net
    healthcheck:
      test: ["CMD", "openclaw", "health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 20s

  openclaw-sandbox:
    image: ghcr.io/openclaw/sandbox-runner:latest
    container_name: openclaw-sandbox
    restart: always
    network_mode: none
    read_only: true
    tmpfs:
      - /tmp:rw,noexec,nosuid,size=256m
    security_opt:
      - no-new-privileges:true
    cap_drop:
      - ALL
    volumes:
      - openclaw-workspace:/workspace:rw
    environment:
      - RUNNER_UID=10001
      - RUNNER_GID=10001

volumes:
  openclaw-config:
    driver: local
  openclaw-workspace:
    driver: local

networks:
  openclaw-net:
    driver: bridge

Configuração openclaw.json para Produção

{
  agents: {
    defaults: {
      workspace: "/home/openclaw/.openclaw/workspace",
      model: {
        primary: "anthropic/claude-sonnet-4-6",
        fallbacks: ["deepseek/deepseek-chat", "openai/gpt-5.4"],
      },
      thinking: "high",
      sandbox: {
        mode: "non-main", // off | non-main | all
        scope: "agent",   // session | agent | shared
        dockerImage: "ghcr.io/openclaw/sandbox-runner:latest",
        timeoutSeconds: 300,
        memoryLimitMb: 1024,
      },
    },
    list: [
      {
        id: "main",
        default: true,
        workspace: "/home/openclaw/.openclaw/workspace",
      },
      {
        id: "devops",
        workspace: "/home/openclaw/.openclaw/workspace-devops",
        sandbox: { mode: "all" },
      },
    ],
  },
  channels: {
    telegram: {
      enabled: true,
      botToken: "7123456789:AAFq_example_token_secret",
      dmPolicy: "pairing", // pairing | allowlist | open | disabled
      allowFrom: ["tg:987654321"],
    },
    discord: {
      enabled: true,
      botToken: "MTI4OTexampleDiscordBotToken",
      dmPolicy: "allowlist",
      allowFrom: ["dc:382910394857291029"],
    },
  },
  cron: {
    enabled: true,
    maxConcurrentRuns: 4,
  },
  hotReload: "hybrid",
}

4. Orquestração Multiagente e Segurança em Sandbox

Políticas de DM e Modos de Sandbox

1. Controle de Mensagens (DM Policy):

• pairing (Padrão): Remetentes não reconhecidos recebem um código de emparelhamento, aprovado pelo admin via openclaw pairing approve .
• allowlist: Aceita exclusivamente comandos de contas listadas em allowFrom.
• open: Aberto a todos os usuários (somente indicado para bots públicos com sandbox em all).
• disabled: Desativa o recebimento de mensagens diretas, limitando o agente a alertas agendados.

---
name: github-pr-analyzer
description: Analisa pull requests no GitHub, roda suítes de testes e gera relatórios de revisão.
metadata: {
  "openclaw": {
    "requires": {
      "bins": ["gh", "jq", "git"],
      "env": ["GITHUB_TOKEN"],
      "config": ["sandbox.enabled"]
    },
    "os": ["linux", "darwin"],
    "always": false,
    "primaryEnv": "GITHUB_TOKEN"
  }
}
---

# Habilidade de Análise de PR no GitHub

Ao ser ativada por usuário ou webhook:
1. Obter o diff do PR com `gh pr diff <pr_number>`.
2. Listar arquivos alterados e verificar testes.
3. Formatar relatório detalhado em Markdown com citações de código.

# Consultar habilidades disponíveis
openclaw skills list

# Instalar skill do repositório oficial ClawHub
openclaw skills install web-researcher

# Instalar a partir de um repositório GitHub específico
openclaw skills install git:github.com/openclaw-community/postgres-inspector@v1.4.0

# Verificar autenticidade e permissões da skill
openclaw skills verify web-researcher

# Atualizar todas as habilidades instaladas
openclaw skills update --all

# Monitorar status do Gateway e conexões
openclaw gateway status

# Acompanhar logs em tempo real
openclaw logs --follow --lines 50

# Validar sintaxe da configuração
openclaw config validate

# Executar tarefa com alto nível de reflexão
openclaw agent --message "Faça uma auditoria de segurança das dependências do projeto" --thinking high

# Enviar notificação direta para o Telegram
openclaw message send --target "tg:987654321" --message "Deploy realizado com sucesso."