Preciso do Paperclip junto com o OpenClaw ou o Hermes, ou no lugar deles?

O README do Paperclip resume a relação em uma linha: If OpenClaw is an employee, Paperclip is the company. Hermes e OpenClaw têm, cada um, um adaptador integrado no Paperclip, então o agente que você já usa pode entrar nele como um dos funcionários.

Em uma VM de teste de 4 GB (não um servidor da DreamHost), a verificação de conexão do Paperclip para o Hermes passou quando informamos uma chave errada. A mesma verificação se recusou a chamar o Hermes pelo nome do contêiner, e a verificação do OpenClaw retornou warn mesmo com o token certo. Você encontra o que cada verificação disse na tabela abaixo.

O que cada um faz

As linhas vêm da documentação de cada projeto, lida em 16 de outubro de 2026, e das nossas páginas de produto, reverificadas em 22 de outubro, exceto a memória ociosa, que nós medimos.

Nosso guia Hermes vs. OpenClaw ajuda você a escolher um worker. Se todos os agentes que você rodaria são sessões do Claude Code, veja Equipes de agentes do Claude Code ou Paperclip, que explica o que as equipes de agentes do próprio Claude Code fazem e quando o Paperclip é o próximo passo.

O OpenClaw e o Hermes já fazem isso?

Em parte, sim. O FAQ do OpenClaw lista roteamento multiagente, com agentes separados por canal, conta ou tarefa.

O Hermes vem com habilidades incluídas para Claude Code e Codex, então um agente Hermes já pode passar trabalho de programação para qualquer um dos dois. O Paperclip fica acima de todos eles, com seu agente Claude Code, seu agente Codex e seu worker Hermes em um só organograma, pegando tickets de uma única fila. Os agentes acordam quando você atribui trabalho ou em heartbeats opcionais por temporizador.

O Paperclip lançou três versões entre 2 e 12 de outubro de 2026, e a nossa própria página do Paperclip o descreve como licenciado sob MIT e evoluindo rápido. Comece com um worker e um orçamento pequeno.

O que as verificações de conexão do Paperclip nos mostraram

O Paperclip pode testar as configurações de um adaptador antes de uma tarefa rodar. Executamos essa verificação pela API dele (POST /api/companies/<id>/adapters/<type>/test-environment) sem nenhuma chave de modelo, apontando para o Hermes em 127.0.0.1:8642 ou pelo nome, e para o OpenClaw em uma rede Docker compartilhada.

A verificação só consulta a página de saúde do Hermes. Essa página não exige chave, então um API_SERVER_KEY digitado errado passa despercebido até a primeira tarefa falhar.

O adaptador Hermes do Paperclip aceita um endereço http:// só na mesma máquina, como 127.0.0.1 ou localhost, e exige https:// para qualquer outro. O endereço da bridge do Docker 172.17.0.1 recebeu a mesma resposta que o nome do contêiner, então, em um único servidor, o Hermes compartilha o namespace de rede do Paperclip, como nos passos abaixo.

No OpenClaw, o status geral ficou em warn com o token certo, errado ou ausente. É a linha do teste de conexão que diferencia os casos e, sem token, você também recebe uma linha dizendo que nenhuma credencial foi encontrada.

Como rodar o Paperclip e um executor no mesmo servidor

Nosso servidor Paperclip não inclui o OpenClaw nem o Hermes, então você adiciona um deles com acesso root e cuida das atualizações por conta própria. Testamos estas etapas com o arquivo compose de início rápido do Paperclip, no qual o serviço do Paperclip se chama paperclip. No nosso servidor, o Paperclip guarda os dados em /opt/paperclip, então primeiro encontre o projeto compose dele com docker compose ls e confira o nome do serviço com docker compose ps.

Se o seu executor for o Hermes

1. Adicione uma chave de provedor e defina dois limites de gastos

   Pegue seu login via SSH, dê um nome à sua empresa e adicione uma chave de provedor, já que os campos da Anthropic, OpenAI e Gemini vêm vazios.

   Antes de ativar o heartbeat de qualquer agente, dê a cada agente um orçamento mensal, como recomenda o guia dos primeiros cinco minutos do Paperclip. Os orçamentos aparecem em Audit, na aba Budgets, mas um agente contratado pelo app chega sem orçamento, então defina-o com o comando budget agent:update da CLI ou pela API, como explica o guia de custos. Depois, limite os gastos no seu provedor de modelos.

2. Inicie o Hermes dentro da rede do Paperclip

   O servidor de API do Hermes escuta em 127.0.0.1 dentro do contêiner por padrão, então você vai rodar a imagem Docker oficial dele no namespace de rede do Paperclip, onde esse endereço também é o próprio 127.0.0.1 do Paperclip. Não é preciso publicar uma porta. Adicionamos este serviço ao projeto compose do Paperclip, fixado na versão do Hermes que testamos, e ele subiu ao lado do Paperclip sem porta própria. Você também vai precisar de uma chave de provedor para o Hermes, que o nosso teste não usou.

   yamlCopiar

   services:
     hermes:
       image: nousresearch/hermes-agent:v0.22.2
       restart: unless-stopped
       network_mode: "service:paperclip"
       volumes:
         - ./data/hermes:/opt/data
       environment:
         API_SERVER_ENABLED: "true"
         API_SERVER_KEY: "${API_SERVER_KEY}"
         # plus one provider key, e.g. OPENROUTER_API_KEY
       command: ["gateway", "run"]
       depends_on:
         - paperclip

3. Adicione um agente Hermes Gateway e dê a ele uma tarefa simples

   Adicione um agente. Escolha o adaptador Hermes Gateway. Informe http://127.0.0.1:8642 como URL base da API e a API_SERVER_KEY do Hermes como chave, como descrevem as notas de onboarding do Paperclip. Rode a verificação. Depois, atribua uma tarefa pequena.

Se o seu executor for o OpenClaw

O formulário de agentes do Paperclip mostra o adaptador OpenClaw Gateway como Coming soon. Em vez disso, o OpenClaw entra por convite. Nosso teste cobriu a etapa de rede e a verificação do adaptador. Deixamos o convite de fora, já que o agente do OpenClaw o lê com uma chave de modelo e nosso teste não usou nenhuma.

1. Coloque o OpenClaw na rede do Paperclip

   Inicie o OpenClaw com os arquivos Docker do próprio projeto, encontre os nomes dos dois contêineres com docker ps e conecte-os em uma rede compartilhada, como fizemos no teste:

   bashCopiar

   docker network create agents
   docker network connect agents <paperclip>
   docker network connect --alias openclaw-gateway \
     agents <openclaw-gateway>

2. Envie o convite ao OpenClaw

   Nas configurações da empresa no Paperclip, encontre a seção Invites e clique em Generate OpenClaw Invite Prompt. Cole o prompt no chat principal do OpenClaw como uma única mensagem e depois aprove a solicitação de entrada no Paperclip. O OpenClaw precisa acessar o Paperclip por um hostname permitido. Recebemos um 403, This hostname is not allowed, quando chamamos o Paperclip pelo endereço IP, e a documentação do adaptador OpenClaw do Paperclip mostra como permitir um com paperclipai allowed-hostname. Se a primeira tarefa parar em pairing required, aprove também o novo dispositivo dentro do OpenClaw, já que é uma aprovação separada.

3. Leia a linha do teste de conexão

   Rode a verificação do adaptador. Procure por Gateway connect probe succeeded. Em uma rede Docker compartilhada, espere também uma nota sugerindo wss://.

De quanta memória a dupla precisa

A maior parte da memória vai para o próprio Paperclip. Um worker Hermes usa cerca de 310 MiB. A imagem de início rápido do Paperclip roda um servidor Node, com cerca de 890 MiB sozinho, ao lado de um banco de dados PostgreSQL embutido. O guia de instalação do Paperclip diz que qualquer VPS Linux com 1 vCPU e 2 GB de RAM basta para começar, e nossa página do Paperclip cita o mesmo número. Em um servidor de 2 GB, sobraria bem menos de 1 GB para as execuções dos agentes.

Os dois pares cabem em 4 GB em repouso. As execuções dos agentes usam o que sobra. O Paperclip inicia cada execução do Claude Code ou do Codex como um processo filho dentro do próprio contêiner e, a partir de alguns agentes ocupados, o guia de VPS do Paperclip sugere mover essas execuções para máquinas separadas. Não medimos uma execução em andamento, então não sabemos dizer quantos agentes ocupados cabem no Stack 8. O Stack 8 adiciona memória com os mesmos 2 vCPU do Stack 4, e o Stack 16 é o primeiro plano com 4 vCPU. Você pode migrar para um plano maior a partir do Stack 4 depois, mas não é possível migrar para um menor.

Nossa imagem do Paperclip adiciona swap, que a nossa VM não tinha. Isso dá a um pico curto um lugar para onde ir, mas o swap é muito mais lento que a memória, então não conte com ele no dimensionamento.

O disco aperta menos que a memória. Descompactadas, as imagens ocupam 9,19 GB para o Paperclip, 4,5 GB para o Hermes e 5,18 GB para o OpenClaw. Você vai precisar de 14 a 15 GB de disco para o Paperclip e um worker, dos 75 GB do Stack 4 ou dos 150 GB do Stack 8. Em repouso, o Paperclip manteve cerca de 5,6% de uma vCPU ocupada com o temporizador de heartbeat e o banco de dados, e cada worker ficou abaixo de 2%.

O que os orçamentos do Paperclip não enxergam

No Paperclip, você define um limite mensal em dólares para cada agente, e a empresa inteira também ganha um teto mensal. Aos 80%, você recebe um aviso e o agente continua trabalhando. Aos 100%, o Paperclip pausa o agente e não inicia mais heartbeats até você aumentar o orçamento ou o mês reiniciar no dia 1º (UTC). Na versão que lemos, o card dos 80% diz erroneamente que o agente está pausado, algo que, segundo o guia de custos do Paperclip, uma versão posterior corrige.

O limite conta só os gastos registrados, e o README do Paperclip avisa que o relatório de uso e o trabalho já em andamento podem atrasar a parada. No OpenClaw, o código do adaptador do Paperclip registra o custo de uma execução como US$ 0 quando o relatório do OpenClaw não traz um valor em dólares. Nossa página do Paperclip alerta sobre essa mesma lacuna e destaca que um orçamento do Paperclip pausa o Paperclip sem afetar a cobrança do seu provedor.

Já tem um servidor com OpenClaw ou Hermes?

Você pode manter esse servidor como está. O Paperclip consegue chamar um worker em outro servidor e, com o worker em um servidor próprio, uma falha ou atualização ali deixa seu quadro de comando funcionando.

Para o Hermes em outro servidor, o Paperclip precisa de um endereço https://, já que o adaptador aceita http:// só na mesma máquina. Nossa imagem do Hermes já serve o painel pelo Caddy com HTTPS automático, e o adaptador Hermes do Paperclip aceita um endereço de painel e o mapeia para a API do Hermes. Ative o servidor de API com uma chave própria e depois teste com uma primeira tarefa pequena.

Para o OpenClaw, o Paperclip aceita um endereço ws:// ou wss:// que consiga alcançar, e a verificação sugere wss:// entre servidores. Nossa imagem do OpenClaw fica vinculada ao localhost e você acessa o painel por um túnel SSH, então vai precisar configurar seu próprio endereço HTTPS ou uma rede privada antes que o Paperclip consiga se conectar. Para iniciar o OpenClaw em um servidor próprio, siga o guia de instalação do OpenClaw.

Como medimos

A VM rodava Ubuntu 24.04.4 no Colima em um Mac com Apple M2: arm64, 2 vCPU, 4 GB de memória (3.904 MiB visíveis), sem swap e com Docker 29.5.2. A DreamHost fez o teste nela em 16 de outubro de 2026. Nenhum servidor da DreamHost foi usado. Cada app veio da imagem publicada pelo próprio desenvolvedor, em uma versão fixa, e registramos cada digest. O Paperclip 2026.1012.0 rodou a partir do arquivo compose de início rápido, o Hermes Agent v0.22.2 dentro da rede do Paperclip e o OpenClaw 2026.10.4 a partir do próprio script de instalação, em uma rede Docker compartilhada. Cada número é a mediana de 12 leituras de MEM USAGE do docker stats, feitas com 5 segundos de intervalo depois de 10 minutos de estabilização. O número do OpenClaw sozinho e o do Hermes com o painel vêm da execução na mesma VM para o nosso guia sobre OpenClaw ou Hermes. Em 22 de outubro de 2026, conferimos todos os planos, preços e informações de produto da DreamHost citados aqui nas páginas atuais de hospedagem VPS para Paperclip, OpenClaw e Hermes Agent.

Nossos servidores usam processadores x86 AMD EPYC, e a nossa imagem do Paperclip adiciona o Caddy e pode ter uma estrutura diferente da do arquivo de início rápido, então você não vai ver números idênticos lá. Nenhum agente recebeu tarefa, e nenhum modelo respondeu porque não havia chave para chamá-lo. Cada configuração rodou uma vez. Não rodamos os três apps juntos e não testamos o convite do OpenClaw.

Perguntas frequentes sobre Paperclip, OpenClaw e Hermes