Fundo
O que é OpenClaw?

Se você nunca usou um agente de IA antes, aqui está a explicação mais breve possível: O ChatGPT é um cérebro em um frasco. O OpenClaw dá mãos a esse cérebro.

O OpenClaw é um agente de IA de código aberto e auto-hospedado. Enquanto o ChatGPT só pode conversar com você, o OpenClaw pode de fato interagir com você. fazer coisas — leia seus arquivos, envie e-mails, navegue na web, publique em mídias sociais — tudo isso conectando-se a ferramentas externas por meio do “Skills”. Ele é executado localmente no seu computador, o que significa que seus dados permanecem na sua máquina.

🦞
Por que o logotipo da lagosta?
O OpenClaw começou como "Clawdbot" em novembro de 2025, tornou-se brevemente "Moltbot" e, finalmente, adotou o nome "OpenClaw". O logotipo da lagosta sobreviveu a todas as mudanças de nome. Em fevereiro de 2026, já contava com mais de 200.000 estrelas no GitHub — um dos projetos de código aberto de crescimento mais rápido da história.

Neste tutorial, vamos usar o OpenClaw para conectar ao X (Twitter) e publicar tweets automaticamente usando um agente de IA. Ao final, seu OpenClaw será capaz de escrever, agendar e publicar tweets em seu nome.

Antes de começar
O que você vai precisar

Prepare estes itens antes de começar — isso evitará que você precise parar no meio do caminho:

💻
A Computador Mac ou Windows Com pelo menos 8 GB de RAM. O OpenClaw é executado localmente em sua máquina.
🔧
Node.js instalado (versão 18 ou superior). Baixe gratuitamente em nodejs.org. Se você nunca usou, basta baixar e executar o instalador — nenhuma configuração é necessária.
🤖
Um Chave da API do modelo de IA - qualquer OpenAI (GPT-4) ou Antrópico (Claude). O OpenClaw precisa de um cérebro para funcionar. Créditos gratuitos estão disponíveis para novas contas em ambas as plataformas.
🐦
Um X / Conta do Twitter Com um número de telefone verificado. Você precisará dele para solicitar acesso à API na Etapa 2.
⏱
Sobre 30 a 45 minutos Na primeira vez. A maior parte desse tempo é gasto aguardando a aprovação do desenvolvedor X, que geralmente é instantânea.
⚠️
Atenção aos custos: O plano básico da API X/Twitter custa $100/mês e é necessário para publicar tweets programaticamente. O plano gratuito permite apenas acesso de leitura com limitações rigorosas. Abordaremos uma solução alternativa usando o OpenTweet como intermediário (teste gratuito de 7 dias, depois $5,99/mês) que evita o uso direto da API do Twitter.
1
Instalação
Instale o OpenClaw no seu computador.

A maneira mais rápida de instalar o OpenClaw é através de Ollama, que cuida de toda a configuração automaticamente. Abra o Terminal (Mac) ou o Prompt de Comando (Windows) e execute este único comando:

terminal
ollama lança garra aberta

O Ollama detectará se o OpenClaw não está instalado no seu sistema e o instalará automaticamente. Após a instalação, o OpenClaw será aberto no seu terminal, pronto para conversar.

✓
Se você ainda não tem o Ollama, instale-o primeiro em ollama.com — É um instalador de um clique. Em seguida, execute o comando acima.

Após a instalação, o OpenClaw solicitará que você... configurar um modelo. Quando solicitado, insira sua chave de API de IA:

Instruções de configuração do OpenClaw
# Quando o OpenClaw solicitar a chave da API do seu modelo: # para OpenAI (GPT-4): OPENAI_API_KEY=sk-your-openai-key-here# OU para Antrópico (Claude — recomendado): ANTROPIC_API_KEY=sk-ant-your-anthropic-key-here

Após a configuração, teste se tudo está funcionando digitando uma mensagem simples como Olá no terminal. Se o OpenClaw responder, você está pronto para a Etapa 2.

💡
O OpenClaw armazena tudo localmente em ~/.openclaw/ No seu computador. Suas conversas, memória e preferências ficam todas nesta pasta — nada é enviado para a nuvem.
2
Acesso à API
Configurar acesso à API do X/Twitter

Em vez de lidar diretamente com a API $100/mês do X, usaremos OpenTweet como uma ponte. O OpenTweet fornece ao seu agente OpenClaw uma chave de API simples para publicar tweets — suas credenciais reais do Twitter nunca saem dos servidores do OpenTweet, o que é significativamente mais seguro.

1
Vá para opentweet.io Crie uma conta gratuita. O período de teste de 7 dias oferece acesso completo — sem necessidade de cartão de crédito.
2
Durante o processo de integração, clique “Conectar conta X.” Isso abre o fluxo OAuth oficial do X — a mesma tela de login que você vê ao conectar qualquer aplicativo ao Twitter. Faça login com suas credenciais do X. Este é o apenas tempo em que você interagirá diretamente com sua senha do Twitter.
3
Após conectar-se, acesse o seu Painel do OpenTweet → Chaves de API → Criar nova chave.
4
Copie sua chave de API — ela se parece com isto: ot_a1b2c3d4e5f6... (48 caracteres). Guarde isto em um lugar seguro. Só aparece uma vez.
⚠️
Não feche a página. até que você tenha copiado sua chave de API. Se você a perder, precisará gerar uma nova no painel do OpenTweet.
3
Instalação de Habilidades
Instale a Skill do Twitter através do ClawHub

O OpenClaw usa "Skills" para se conectar a serviços externos — pense neles como aplicativos que você instala no seu celular. O ClawHub é o mercado oficial de Skills. Vamos instalar a skill OpenTweet, que ensina o OpenClaw a se comunicar com o serviço X.

No seu terminal, execute:

Terminal — Instalar Skill do Twitter
clawhub instalar openclaw/skills/twitter

O ClawHub baixa e instala a skill automaticamente. Quando terminar, você verá uma mensagem de confirmação. Reinicie o OpenClaw para carregar a nova skill.

terminal
reiniciar openclaw
✓
Prefere configuração manual? Crie uma pasta em ~/.openclaw/skills/twitter/, adicione um HABILIDADE.md Em seguida, abra o arquivo com a documentação da API OpenTweet e reinicie o OpenClaw. O método ClawHub acima faz isso automaticamente.
4
Configuração
Adicione sua chave de API do OpenTweet ao OpenClaw.

Agora, indique ao OpenClaw onde encontrar suas credenciais da API do Twitter. Abra seu arquivo de configuração do OpenClaw:

Terminal — Abrir arquivo de configuração
# Mac / Linux: nano ~/.openclaw/openclaw.json# Windows: bloco de notas %USERPROFILE%\.openclaw\openclaw.json

Encontre o ""segredos"" seção (ou adicione-a se não existir) e insira sua chave da API OpenTweet:

~/.openclaw/openclaw.json
{ ""modelo"": ""claude-3-5-soneto"", ""segredos"": { ""OPENTWEET_API_KEY"": ""ot_a1b2c3d4e5f6sua-chave-aqui"" } }

Salve o arquivo e reinicie o OpenClaw. Para verificar se as credenciais estão funcionando, execute o comando de verificação de autenticação:

Terminal — Verificar conexão
verificação de autenticação twclaw

Você deverá ver uma confirmação em verde: ✓ Conectado a X como @seu_nome_de_usuário. Se você vir um erro, verifique se sua chave de API foi copiada corretamente, sem espaços extras.

💡
O segredos A seção no arquivo openclaw.json nunca é enviada para nenhum modelo de IA — ela permanece em sua máquina. Sua chave de API é usada apenas para autenticar com os servidores do OpenTweet ao publicar.
5
Primeiro tweet
Publique seu primeiro tweet com o OpenClaw

Você está conectado. Agora vamos postar. No seu terminal OpenClaw, você pode usar linguagem natural ou o garra dupla comando direto.

Opção A — Linguagem natural (mais fácil): Basta dizer ao OpenClaw o que fazer:

Chat do OpenClaw
Publique um tweet dizendo: "Acabei de configurar meu agente de IA para postar automaticamente em X. O futuro é agora. 🤖""

O OpenClaw confirmará antes de publicar. Digite sim Para confirmar.

Opção B — Comando direto:

Terminal — Postar diretamente
twclaw postou "Acabei de configurar meu agente de IA para postar automaticamente no X. O futuro chegou. 🤖""

Confira seu perfil no Google X — o tweet deve aparecer em segundos.

Você também pode ler sua linha do tempo, pesquisar tweets e verificar menções:

Terminal — Outros comandos
# Leia sua linha do tempo inicial (últimos 20 tweets) twclaw home -n 20# Verifique suas menções twclaw menciona -n 10# Pesquisar tweets por palavra-chave pesquisa twclaw ""Produção cinematográfica com IA"" --recente# Ver o perfil de alguém usuário twclaw @lidar# Leia um tweet específico twclaw leu tweet-url-ou-id
6
Automação
Agende Tweets automáticos com o OpenClaw.

O verdadeiro poder do OpenClaw não está em tweets isolados, mas sim na automação completa da sua programação de postagens. Veja como configurar um fluxo de trabalho de conteúdo recorrente.

Agende um tweet específico para um horário futuro:

Chat do OpenClaw
Agende um tweet para amanhã às 9h dizendo: "Novo post no blog acabou de ser publicado — link na bio 🔗""

Estabeleça uma rotina diária de conteúdo: Edite seu SOUL.md arquivo — este é o arquivo que o OpenClaw lê sempre que é iniciado, como um documento de instruções permanente:

~/.openclaw/SOUL.md — Adicione estas linhas
Rotina diária do Twitter ##Todas as manhãs às 9h: - Publique um tweet original sobre criatividade em IA ou produção cinematográfica - Mantenha-o com menos de 200 caracteres - Use um tom conversacional e curioso - NÃO inclua hashtags, a menos que o tópico esteja em alta. Todas as sextas-feiras às 17h: - Publique um breve tweet de reflexão semanal, resumindo o que você criou nesta semana.

Salve o arquivo. De agora em diante, sempre que o OpenClaw for executado, ele seguirá essas instruções automaticamente.

✓
Dica profissional: Quanto mais específicas forem as suas instruções no arquivo SOUL.md, melhor será o resultado. Inclua a identidade de marca da sua empresa, os tópicos que lhe interessam, os assuntos que você nunca deve publicar e quaisquer preferências de formatação. O OpenClaw lê este arquivo novamente a cada sessão.

Crie um tópico e publique-o:

Chat do OpenClaw
Escreva uma sequência de 5 tweets sobre como a IA está mudando o cinema independente em 2026. Mantenha um tom de conversa, comece com uma frase de impacto e publique agora.

O OpenClaw irá redigir a thread completa, mostrá-la para você revisar e publicá-la no X após sua confirmação.

Problemas comuns
Solução de problemas

A maioria dos problemas se resume a uma destas três questões:

✕ A verificação de autenticação do twclaw retorna "Chave de API inválida".“
Sua chave da API OpenTweet não foi salva corretamente. Abrir ~/.openclaw/openclaw.json e verifique: (1) a chave está entre aspas, (2) não há espaços extras, (3) a chave começa com ot_. Se necessário, gere uma nova chave no seu painel de controle do OpenTweet.
✕ O OpenClaw não reconhece os comandos twclaw.
A skill do Twitter não foi carregada. Executar clawhub instalar openclaw/skills/twitter novamente e certifique-se de que o OpenClaw foi reiniciado em seguida com reiniciar openclaw. Você pode verificar as habilidades instaladas com lista de habilidades do OpenClaw.
✕ O tweet foi publicado, mas não apareceu no meu perfil do Google X.
Verifique seu painel do OpenTweet — a publicação pode estar em uma fila. Verifique também se sua conta X não está em modo restrito (Configurações → Privacidade e segurança → Público e marcação). Se sua conta for nova, o X às vezes atrasa as primeiras publicações da API em alguns minutos.
✕ O OpenClaw não está executando meus tweets agendados.
As tarefas agendadas só são executadas enquanto o OpenClaw estiver em execução. Certifique-se de que o processo do OpenClaw permaneça aberto em segundo plano. No Mac, você pode usar Os serviços de cerveja iniciam o OpenClaw Para executá-lo como um serviço em segundo plano que inicia automaticamente ao fazer login.
✕ O feed X aparece em branco ao usar o comando twclaw home.
A linha do tempo do X é renderizada em JavaScript e protegida por login, o que bloqueia leituras simples da API. Para ler seu feed ao vivo, use o OpenClaw Browser Relay: instale a extensão do Chrome em [link para a extensão]. docs.openclaw.ai/tools/chrome-extension, Abra o x.com enquanto estiver conectado e clique no ícone da extensão OpenClaw para anexá-la a essa aba.