​

Perguntas frequentes

​

Tabela de conteúdos

• [Início rápido e configuração da primeira execução]
  • Estou travado: qual é a forma mais rápida de destravar?
  • Qual é a forma recomendada de instalar e configurar o OpenClaw?
  • Como abro o painel após a integração inicial?
  • Como autentico o token do painel no localhost vs remoto?
  • Qual runtime eu preciso?
  • Ele roda em Raspberry Pi?
  • Alguma dica para instalações em Raspberry Pi?
  • Está travado em “wake up my friend” / a integração não finaliza. E agora?
  • Posso migrar minha configuração para uma nova máquina (Mac mini) sem refazer a integração?
  • Onde vejo o que há de novo na versão mais recente?
  • Não consigo acessar docs.openclaw.ai (erro de SSL). E agora?
  • Qual é a diferença entre stable e beta?
  • Como instalo a versão beta e qual é a diferença entre beta e dev?
  • Como testo os bits mais recentes?
  • Quanto tempo a instalação e a integração inicial costumam levar?
  • Instalador travado? Como obtenho mais feedback?
  • A instalação no Windows diz git não encontrado ou openclaw não reconhecido
  • A documentação não respondeu minha pergunta — como obtenho uma resposta melhor?
  • Como instalo o OpenClaw no Linux?
  • Como instalo o OpenClaw em um VPS?
  • Onde estão os guias de instalação em nuvem/VPS?
  • Posso pedir para o OpenClaw se atualizar sozinho?
  • O que o assistente de integração realmente faz?
  • Preciso de uma assinatura do Claude ou OpenAI para rodar isso?
  • Posso usar a assinatura Claude Max sem uma chave de API?
  • Como funciona a autenticação setup-token da Anthropic?
  • Onde encontro um setup-token da Anthropic?
  • Vocês suportam autenticação por assinatura do Claude (Claude Pro ou Max)?
  • Por que estou vendo HTTP 429: rate_limit_error da Anthropic?
  • AWS Bedrock é suportado?
  • Como funciona a autenticação do Codex?
  • Vocês suportam autenticação por assinatura OpenAI (Codex OAuth)?
  • Como configuro o OAuth da Gemini CLI
  • Um modelo local serve para conversas casuais?
  • Como mantenho o tráfego de modelos hospedados em uma região específica?
  • Preciso comprar um Mac Mini para instalar isso?
  • Preciso de um Mac mini para suporte ao iMessage?
  • Se eu comprar um Mac mini para rodar o OpenClaw, posso conectá-lo ao meu MacBook Pro?
  • Posso usar Bun?
  • Telegram: o que vai em allowFrom?
  • Várias pessoas podem usar um número de WhatsApp com diferentes instâncias do OpenClaw?
  • Posso rodar um agente de “chat rápido” e um agente “Opus para código”?
  • O Homebrew funciona no Linux?
  • Qual é a diferença entre a instalação hackeável (git) e a instalação via npm?
  • Posso alternar entre instalações npm e git depois?
  • Devo rodar o Gateway no meu laptop ou em um VPS?
  • Quão importante é rodar o OpenClaw em uma máquina dedicada?
  • Quais são os requisitos mínimos de um VPS e o SO recomendado?
  • Posso rodar o OpenClaw em uma VM e quais são os requisitos
• O que é OpenClaw?
  • O que é o OpenClaw, em um parágrafo?
  • Qual é a proposta de valor?
  • Acabei de definir o que devo fazer primeiro
  • Quais são os cinco melhores casos de uso diário para OpenClaw
  • Pode o OpenClaw ajudar com anúncios e blogs sobre o potencial geracional em um SaaS
  • Quais são as vantagens vs Claude Code para o desenvolvimento da web?
• Habilidades e automação
  • Como personalizar as habilidades sem deixar o repositório sujo?
  • Posso carregar habilidades de uma pasta personalizada?
  • Como posso usar modelos diferentes para tarefas diferentes?
  • O bot congela enquanto faz um trabalho pesado. Como faço para descarregar isso?
  • CRON ou lembretes não disparam. O que devo verificar?
  • Como instalar habilidades no Linux?
  • O OpenClaw pode executar tarefas em um horário ou continuamente em segundo plano?
  • Posso executar habilidades só para macOS da Apple no Linux?
  • Você tem alguma integração com o HeyGen?
  • Como instalar a extensão Chrome para aquisição do navegador?
• Arenito e memória
  • Existe algum sandboxing doc?
  • Como vincular uma pasta de host na sandbox?
  • Como funciona a memória?
  • A memória continua esquecendo as coisas. Como faço para ficar?
  • A memória persiste para sempre? Quais são os limites?
  • A pesquisa semântica de memória requer uma chave de API OpenAI?
• Onde as coisas moram em disco
  • Todos os dados usados no OpenClaw são salvos localmente?
  • Onde o OpenClaw armazena seus dados?
  • Onde deve o AGENTS.md / SOUL.md / USER.md / MEMORY.md live?
  • Qual é a estratégia de backup recomendada?
  • Como desinstalar completamente o OpenClaw?
  • Agentes podem trabalhar fora do espaço de trabalho?
  • Estou em modo remoto - onde está a sessão loja?
• Básico de configuração
  • Qual é o formato da configuração? Onde está?
  • Eu defino gateway.bind: "lan" (ou "tailnet") e agora nada ouve / interface do usuário diz não autorizado
  • Por que preciso de um token localizado agora?
  • Preciso reiniciar após alterar a configuração?
  • Como ativar a pesquisa na web (e pesquisa na web)?
  • config.apply limpou minha configuração. Como faço para recuperar e evitar isso?
  • Como executo um Gateway central com trabalhadores especializados em dispositivos?
  • O navegador OpenClaw pode correr sem cabeça?
  • Como usar o Brave para o controle do navegador?
• gateways e nós remotos
  • Como os comandos se propagam entre o Telegram, o gateway e os nós?
  • Como meu agente pode acessar o meu computador se o Gateway está hospedado remotamente?
  • A Escala Caudal está conectada, mas não tenho respostas. E agora?
  • É possível conversar entre si duas instâncias OpenClaw (local + VPS)?
  • Preciso de VPSes separados para vários agentes
  • Há vantagem em usar um nó no meu laptop pessoal em vez de SSH por meio de um VPS?
  • Os nós executam um serviço de gateway?
  • Existe uma forma de API / RPC para aplicar a configuração?
  • Qual é a configuração mínima “saneamento” para uma primeira instalação?
  • Como configurar escala alfaiate em um VPS e me conectar do meu Mac?
  • Como conectar um nó Mac a um Gateway remoto (Serviço de escala selvagem)?
  • Devo instalar em um segundo laptop ou apenas adicionar um nó?
• Env vars e .env loading
  • Como OpenClaw carregar variáveis de ambiente?
  • “Eu comecei o Gateway pelo serviço e meus vars de env desapareceram.” E agora?
  • Eu defino COPILOT_GITHUB_TOKEN, mas o status dos modelos mostra “Shell env: off.” Porque?
• Sessões e múltiplos chats
  • Como começar uma conversa nova?
  • Reinicia as sessões automaticamente se nunca enviar /new?
  • Existe uma maneira de fazer uma equipe de OpenClaw instâncias um CEO e muitos agentes
  • Por que o contexto foi truncado na tarefa média? Como posso evitá-lo?
  • Como resetar completamente o OpenClaw mas mantê-lo instalado?
  • Estou recebendo erros de “contexto grande demais” - como redefino ou compacto?
  • Por que estou vendo “solicitação LM rejeitada: mensagens.N.content.X.tool_use.input: Campo requerido”?
  • Por que recebo mensagens de pulso a cada 30 minutos?
  • Preciso adicionar uma “conta bot” em um grupo de WhatsApp?
  • Como consigo a JID de um grupo de WhatsApp?
  • Por que a OpenClaw não responde em um grupo?
  • Grupos e tópicos compartilham o contexto com DMs?
  • Quantos espaços de trabalho e agentes posso criar?
  • Posso executar vários bots ou chats ao mesmo tempo (Slack) e como devo configurar isso?
• Modelos: padrões, seleção, alias, comutação
  • O que é o “modelo padrão”?
  • Que modelo você recomenda?
  • Como alternar modelos sem apagar a minha configuração?
  • Posso usar modelos auto-hospedados (llama.cpp, vLLM, Ollama)?
  • O que usam OpenClaw, Flawd e Krill para modelos?
  • Como faço para alternar os modelos na mosca (sem reiniciar)?
  • Posso usar o GPT 5.2 para tarefas diárias e o Codex 5.3 para codificação
  • Por que eu vejo “Modelo … não é permitido” e depois não há resposta?
  • Por que eu vejo “Modelo desconhecido: minimax/MiniMax-M2.1”?
  • Posso usar o MiniMax como meu padrão e o OpenAI para tarefas complexas?
  • O opus / sonnet / gpt integra-se nos atalhos?
  • Como definir/substituir atalhos do modelo (alias)?
  • Como adicionar modelos de outros provedores como OpenRouter ou Z.AI?
• Model failover e “Todos os modelos falharam”
  • Como a falha funciona?
  • O que este erro significa?
  • Corrigir checklist para Não foram encontradas credenciais para o perfil "anthropic:default"
  • Por que também experimentou o Google Gemini e falhou?
• Perfis de autenticação: o que são e como gerenciá-los
  • Qual é um perfil de autenticação?
  • Quais são as identificações típicas?
  • Posso controlar qual perfil de autenticação está tentando primeiro?
  • OAuth vs chave da API: qual é a diferença?
• Gateway: portas, “já em execução” e modo remoto
  • Qual porta usa o Gatewa?
  • Por que openclaw gateway status diz Runtime: running mas RPC probe: falhou?
  • Por que o status do gateway openclaw mostra Config (cli) e Config (serviço) diferente?
  • O que significa “outra instância do gateway já está escutando”?
  • Como executar o OpenClaw no modo remoto (cliente conecta a um Gateway em outro lugar)?
  • A interface do controle diz “não autorizado” (ou continua reconectando). E agora?
  • Eu defini gateway.bind: "tailnet" mas não consigo vincular / nenhuma lista
  • Posso executar vários Gateways no mesmo host?
  • O que significa “handshake inválido”? / código 1008 significa?
• Registro e depuração
  • Onde estão os registros?
  • Como começar/parar/reiniciar o serviço do Gatewa?
  • Eu fechei meu terminal no Windows - como reiniciar o OpenClaw?
  • O Gateway está pronto, mas as respostas nunca chegaram. O que devo verificar?
  • “Desconectado do gateway: sem motivo” - e agora?
  • Telegram setMyCommands falhou com erros de rede. O que devo verificar?
  • TUI não mostra nenhuma saída. O que devo verificar?
  • Como parar completamente e começar o Gateway?
  • ELI5: openclaw gateway restart vs openclaw gateway
  • Qual é a maneira mais rápida de obter mais detalhes quando algo falhar?
• Mídia e Anexos
  • Minha habilidade gerou uma imagem/PDF, mas nada foi enviado
• Segurança e controle de acesso
  • É seguro expor OpenClaw a mensagens de entrada de dados?
  • O prompt injection é apenas uma preocupação com bots públicos?
  • Meu bot deve ter sua própria conta no GitHub ou número de telefone
  • Posso dar-lhe autonomia sobre as minhas mensagens de texto e é aquela segura
  • Posso usar modelos mais baratos para tarefas pessoais de assistente?
  • Eu executei /start no Telegram, mas não consegui um código de emparelhamento
  • WhatsApp: uma mensagem para meus contatos? Como funciona o emparelhamento?
• Comandos de bate-papo, tarefas canceladas e “não vai parar”
  • Como impedir que mensagens do sistema interno sejam exibidas no chat
  • Como parar/cancelar uma tarefa em execução?
  • Como enviar uma mensagem do Discord do Telegram? (“Mensagens cruzadas negadas”)
  • Por que se sente como o bot “ignora” mensagens rápidas de fogo?

​

Primeiros 60 segundos se algo estiver quebrado

1. Estado rápido (primeira verificação)
   openclaw status
   
   Resumo local: OS + atualização, acesso ao gateway/serviço, agentes/sessões, configuração do provedor + problemas de tempo de execução (quando o gateway é acessível).
2. Relatório Pasteable (seguro para compartilhar)
   status openclaw --all
   
   Diagrama somente leitura com cauda de log (tokens redacted).
3. Daemon + estado da porta
   openclaw gateway status
   
   Mostra supervisor tempo de execução vs RPC reachability, a URL de destino de sondagem, e qual configuração o serviço provavelmente usado.
4. Provas profundas
   status openclaw --deep
   
   Executa verificações de saúde do gateway + experiências de provedor (requer um gateway acessível). Ver Health.
5. Cauda o último tronco
   openclaw logs --follow
   
   Se o RPC estiver no chão, volte para:
   cauda -f "$(ls -t /tmp/openclaw/openclaw-*.log ├head -1)"
   
   Os logs dos arquivos são separados dos logs de serviço; ver Logging e Troubleshooting.
6. Execute o médico (reparos)
   openclaw doctor
   
   Reparações/migrates config/state + executa verificações de saúde. Ver Doctor.
7. Gateway snapshot
   openclaw saúde --json
   openclaw saúde --verbose # mostra a URL de destino + caminho de configuração de erros
   
   Solicita o gateway executando para um snapshot completo (Somente WS). Ver Health.

​

Início rápido e configuração da primeira execução

​

Estou preso é o caminho mais rápido para se desprender

• Claude Code: https://www.anthropic.com/claude-code/
• Código OpenAI: https://openai.com/codex/

curl -fsSL https://openclaw.ai/install.sh £bash -s -- ----install-method git

status openclaw
openclaw status de modelo
médico openclaw

• openclaw status: snapshot rápido do gateway/saúde do agente + configuração básica.
• openclaw models status: verifica autenticação do provedor + disponibilidade do modelo.
• médico openclaw: valida e conserta problemas comuns de configuração/estado.

​

Qual é a maneira recomendada de instalar e configurar o OpenClaw

curl -fsSL https://openclaw.ai/install.sh £bash
openclaw a bordo --install-daemon

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build # auto-instalações da UI depende da primeira execução
openclaw a board

​

Como abrir o painel após a integração

​

Como autenticar o token do painel de controle no controle local vs controle remoto

• Abra http://127.0.0.1:18789/.
• Se ele pedir por autenticação, cole o token do gateway.auth.token (ou do OPENCLAW_GATEWAY_TOKEN) nas configurações de UI do controle.
• Recupere do host de gateway: openclaw config get gateway.auth.token (ou gere um: openclaw doctor --generate-gateway-token).

• Serviço de escala (recomendado): mantenha o loopback, execute openclaw gateway --tailscale serve, abra https://<magicdns>/. Se o gateway.auth.allowTailscale é true, os cabeçalhos de identidade satisfazem a autenticação (sem token).
• binding Tailnet: rode o openclaw gateway --bind tailnet --token "<token>", abra http://<tailscale-ip>:18789/, cole o token nas configurações do painel.
• Túnel SSH: ssh -N -L 18789:127.0.0.1:18789 user@host e então abra o http://127.0.0.1:18789/ e cole o token nas configurações da UI de controle.

​

Que tempo de execução preciso

​

É executado no Raspberry Pi

​

Todas as dicas para instalações do Raspberry Pi

• Use um sistema operacional 64-bit e mantenha o Node >= 22.
• Prefira a instalação de hackeáveis (git) para que você veja os registros e atualize rápido.
• Comece sem canais/habilidades, então adicione-os um por um.
• Se você atinge problemas binários estranhos, geralmente é um problema de compatibilidade ARM.

​

Está preso a acordar a integração do meu amigo não chocará o que agora

1. Reinicie o Gateway:

openclaw gateway restart

2. Verificar status + autenticação:

openclaw status
openclaw status
registros openclaw --follow

3. Se ainda estiver pendurado, execute:

openclaw doctor

​

Posso migrar minha instalação para um novo mini do computador Mac sem refazer a integração

1. Instale o OpenClaw na nova máquina.
2. Copie $OPENCLAW_STATE_DIR (padrão: ~/.openclaw) da máquina antiga.
3. Copie seu espaço de trabalho (padrão: ~/.openclaw/workspace).
4. Execute openclaw doctor e reinicie o serviço do Gateway.

​

Onde eu vejo o que há de novo na última versão

​

Não posso acessar docs.openclaw.ai erro SSL O que agora

​

Qual é a diferença entre estável e beta

• último = estável
• beta = versão inicial para teste

​

Como faço para instalar a versão beta e qual a diferença entre beta e dev

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh ├bash -s -- ----beta

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh ├bash -s -- ----install-method git

​

Quanto tempo leva para instalar e integrar

• Instalar: 2-5 minutos
• Integração: 5-15 minutos dependendo de quantos canais/modelos você configurar

​

Como tento os últimos bits

1. Canal de desenvolvimento (check-out do git):

atualização openclaw --canal dev

2. Instalação Hackable (do site do instalador):

curl -fsSL https://openclaw.ai/install.sh £bash -s -- ----install-method git

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build

​

Installer travado como eu recebo mais feedback

curl -fsSL https://openclaw.ai/install.sh £bash -s -- ----verbose

curl -fsSL https://openclaw.ai/install.sh ├bash -s -- --beta --verbose

curl -fsSL https://openclaw.ai/install.sh £bash -s -- ----install-method git --verbose

# install.ps1 has no dedicated -Verbose flag yet.
Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0

​

A instalação do Windows diz que o git não foi encontrado ou openclaw não foi reconhecido

• Instale o Git para Windows e certifique-se de que o git está no seu PATH.
• Feche e reabra o PowerShell, e então execute o instalador novamente.

• Seu diretório bin global do npm não está no PATH.
• Verificar o caminho:
  npm config get prefix
  
• Certifique-se de <prefix>\\bin está no PATH (na maioria dos sistemas é %AppData%\\npm).
• Fechar e reabrir o PowerShell após atualizar o PATH.

​

Os documentos não responderam à minha pergunta como eu recebo uma melhor resposta

curl -fsSL https://openclaw.ai/install.sh £bash -s -- ----install-method git

​

Como faço para instalar o OpenClaw no Linux

• Caminho rápido do Linux + instalação do serviço: Linux.
• Passeio completo: Primeiros passos.
• Instalador + atualizações: Instalar e atualizações.

​

Como faço para instalar o OpenClaw em um VPS

​

Onde estão os guias de instalação na cloudVPS

• Alojamento de VPS (todos os provedores num só lugar)
• Fly.io
• Hetzner
• exe.dev

​

Posso pedir ao OpenClaw para se atualizar

openclaw atualiza o status
openclaw e atualiza
openclaw --channel stable^\\betav
openclaw update --tag <dist-tag|version>
openclaw atualização --no-restart

openclaw update --yes --no-restart
o gateway openclaw reinicia

​

O que o assistente de integração faz realmente

• Configuração de modelo/auth modelo (Opcionado Antrópico setup-token recomendado para Claude subscriptions, as chaves API do OpenAI Codex OAuth suportadas, modelos locais do LM Studio opcionais)
• Localização Workspace + arquivos de inicialização
• Configurações de Gateway (vinculado/porta/escala/cauda)
• Provedores (WhatsApp, Telegram, Discord, Mattermost (plugin), Signal, iMessage)
• Instalação de Daemon (LaunchAgent no macOS; unidade de usuário do sistema no Linux/WSL2)
• Seleção de Verificações de saúde e habilidades

​

Preciso de uma assinatura do Claude ou do OpenAI para executar isso

​

Posso usar o Claude Max assinatura sem uma chave de API

​

Como funciona a autentificação do token Anthropic

​

Onde eu encontro um token de configuração antrópica

claude setup-token

​

Você apoia sua assinatura por Claude (Claude Pro ou Max)

​

Por que estou vendo HTTP 429 ratelimiterror de Anthropic

​

A Rocha AWS é suportada

​

Como funciona o Codex auth

​

Você suporta a assinatura OpenAI do Codex OAuth

​

Como configurar o Gemini CLI OAuth

1. Habilita o plugin: openclaw plugins permitem google-gemini-cli-auth
2. Login: openclaw models auth login --provider google-gemini-cli --set-default

​

É um modelo local OK para bate-papos casuais

​

Como mantenho o tráfego modelo hospedado em uma região específica

​

Tenho que comprar um Mac Mini para instalar isto

​

Preciso de um Mac mini para suporte iMessage

• Execute o Gateway no Linux/VPS, e execute o servidor BlueBubbles em qualquer Mac conectado às Mensagens.
• Execute tudo no Mac se você quiser a configuração de máquina mais simples.

​

Se eu comprar um mini Mac para executar o OpenClaw posso conectá-lo ao meu MacBook Pro

• Gateway no Mac mini (sempre).
• O MacBook Pro executa o aplicativo macOS ou um host de nós e pares para o Gateway.
• Use openclaw nodes status / openclaw nodes list para vê-lo.

​

Eu posso usar o Coque

​

Telegram o que sai allowDe

• DM seu bot, então rode openclaw logs --follow e leia from.id.

• DM seu bot, em seguida, chame https://api.telegram.org/bot<bot_token>/getUpdates e leia message.from.id.

• DM @userinfobot or @getidsbot.

​

Pode várias pessoas usar um número de WhatsApp com diferentes instâncias OpenClaw

​

Posso executar um rápido agente de bate-papo e um Opus para codificar

​

O Homebrew funciona no Linux

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profile
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
brew install install <formula>

​

Qual é a diferença entre a instalação git hackeável e a instalação npm

• Instalação Hackable (git): compra de fonte completa, editável, melhor para colaboradores. Você executa compilações localmente e pode corrigir código/docs.
• npm install: global CLI instala, sem repositório, melhor para “just run it.” Atualizações vêm de npm dist-tags.

​

Posso alternar entre instalações npm e git mais tarde

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
openclaw doctor
openclaw gateway reinicie

npm install -g openclaw@latest
openclaw doctor
Reiniciar o gateway openclaw

​

Devo executar o Gateway no meu computador portátil ou um VPS

• Perfis: nenhum custo de servidor, acesso direto a arquivos locais, janela do navegador ao vivo.
• Confirma: drops de rede / sono/sono = desconectar, atualizações / reboots interromper, devem ficar acordados.

• Pros: rede estável, sempre ligada, sem problemas de sono de laptop, mais fácil de continuar rodando.
• Cons.: geralmente execute headless (use screenshots), somente acesso a arquivos remotos, você deve fazer SSH para atualizações.

​

Quão importante é para rodar a OpenClaw em uma máquina dedicada

• Host dedicado (VPS/Mac mini/Pi): sempre-on, menos interrupções/reiniciar interrupções, permissões mais limpas, mais fácil de continuar em execução.
• laptop/desktop compartilhado: totalmente bom para testes e uso ativo, mas espere pausas quando a máquina dormir ou atualizar.

​

Quais são os requisitos mínimos do VPS e do SO recomendado

• Mínimo absoluto: 1 vCPU, 1GB RAM, ~500MB de disco.
• Recomendado: 1-2 vCPU, 2GB RAM ou mais para quartos de ouvido (logs, mídia, vários canais). Ferramentas de nó e automação do navegador podem ter fome de recursos.

​

Posso executar o OpenClaw em uma VM e quais são os requisitos

• Mínimo absoluto: 1 vCPU, 1GB de RAM.
• Recomendado: 2GB RAM ou mais se você executar vários canais, automação do navegador ou ferramentas de mídia.
• OS: Ubuntu LTS ou outro Debian/Ubuntu.

​

O que é o OpenClaw?

​

O que é o OpenClaw em um parágrafo

​

Qual é a proposta de valor

• Seus dispositivos, seus dados: rode o Gateway onde quiser (Mac, Linux, VPS) e mantenha o espaço* histórico de sessões local.
• Canais reais, não uma sandbox web: WhatsApp/Telegram/Slack/Discord/Signal/iMessage/etc, mais voz móvel e tela nas plataformas suportadas.
• Model-agnostic: use Anthropic, OpenAI, MiniMax, OpenRouter, etc com o roteamento por agente e falhe.
• Opção somente local: execute modelos locais para que todos os dados possam ficar em seu dispositivo se você quiser.
• Roteamento de agentes de origem:** separe agentes por canal, conta, ou tarefa, cada um com seu próprio espaço de trabalho e padrões.
• Código aberto e hackeável: inspeção, expansão e auto-hospedeiro sem o fornecedor bloqueio.

​

Eu acabei de configurar o que devo fazer primeiro

• Construa um site (WordPress, Shopify ou um site estático simples).
• Prototype um aplicativo móvel (esboço, screens, plano API).
• Organizar arquivos e pastas (limpeza, nomes, marcação).
• Conecte o Gmail e automatize resumos ou acompanhe.

​

Quais são os cinco melhores casos de uso diário para OpenClaw

• Informações pessoais: resumos da caixa de entrada, calendário e notícias sobre as quais você se importa.
• Pesquisa e rascunho: pesquisa rápida, resumos e primeiros rascunhos para e-mails ou documentos.
• Lembretes e acompanhe-as: empurrões ou pulso de pepitas e listas de verificação.
• Automação do navegador: preenchimento de formulários, coleta de dados e repetição de tarefas web.
• Coordenação de dispositivo cruzado: envie uma tarefa do seu celular, deixe o Gateway executá-lo em um servidor e obtenha o resultado de volta no chat.

​

Pode o OpenClaw ajudar com anúncios de divulgação de geração de chumbo e blogs para um SaaS

​

Quais são as vantagens vs Claude Code para desenvolvimento web

• Memória persistente + espaço de trabalho entre sessões
• Acesso à plataforma** (WhatsApp, Telegram, TUI, WebChat)
• Orquestração de ferramentas (navegador, arquivos, agendamento, hooks)
• Gateway sempre ligado (rode em um VPS, interação de qualquer lugar)
• Nós para navegador/tela/câmera/exec local

​

Habilidades e automação

​

Como faço para customizar as habilidades sem manter o repo sujo

​

Posso carregar habilidades de uma pasta personalizada

​

Como posso usar modelos diferentes para diferentes tarefas

• Tarefas crônicas: tarefas isoladas podem definir uma substituição model por tarefa.
• Sub-agentes: rotear tarefas para separar agentes com diferentes modelos padrão.
• Interruptor de demanda: use /model para mudar o atual modelo de sessão a qualquer momento.

​

O bot congela enquanto faz trabalho pesado como eu descarrego isso

​

Cron ou lembretes não disparam o que eu devo verificar

• O cron de confirmação está ativado (cron.enabled) e OPENCLAW_SKIP_CRON não está definido.
• Verifique se o Gateway está rodando 24/7 (sem sono/reinicialização).
• Verifique as configurações de fuso horário para a tarefa (--tz vs fuso horário).

openclaw cron roda <jobId> --force
openclaw roda --id <jobId> --limit 50

​

Como faço para instalar habilidades no Linux

npm i -g clawhub

pnpm add -g clawhub

​

Pode OpenClaw executar tarefas em um horário ou continuamente em segundo plano

• Tarefas duplicadas para tarefas agendadas ou recorrentes (persistir em reinícios).
• Heartbeat para verificações periódicas de “sessão principal”.
• Trabalhos isolados para agentes autônomos que postam resumos ou entregam no chat.

​

Posso executar habilidades somente macOS da Apple no Linux?

1. Crie um wrapper SSH para o binário (exemplo: memo para Apple Notes):
   #!/usr/bin/env bash
   set -euo pipefail
   exec ssh -T user@mac-host /opt/homebrew/bin/memo "$@"
   
2. Coloque o wrapper em PATH no host Linux (por exemplo ~/bin/memo).
3. Sobrepor os metadados de habilidade (espaço de trabalho ou ~/.openclaw/skills) para permitir Linux:
   ---
   nome: apple-notes
   descrição: Gerencie Notas do Apple via memo CLI no macOS.
   metadados: { "openclaw": { "os": ["darwin", "linux"], "requires": { "bins": ["memo"] }
   ---
   
4. Comece uma nova sessão para que o instantâneo de habilidades seja atualizado.

​

Você tem uma integração Notion ou HeyGen

• Habilidade personalizada / plugin: melhor para acesso de API confiável (Nota/HeyGen ambos possuem APIs).
• Automação do navegador: funciona sem código, mas é mais lento e mais frágil.

• Uma página de Notação por cliente (contexto + preferências + trabalho ativo).
• Peça ao agente que busque essa página no início de uma sessão.

instalar clawhub <skill-slug>
atualização do clawhub --all

​

Como faço para instalar a extensão Chrome para aquisição do navegador

openclaw browser extension install
openclaw browser extension path

​

Sandboxing e memória

​

Existe um documento dedicado de areia

​

O Docker parece limitado como eu faço para ativar todos os recursos

• Persistir /home/node com OPENCLAW_HOME_VOLUME então os caches sobrevivem.
• Assar o sistema depende da imagem com OPENCLAW_DOCKER_APT_PACKAGES.
• Instale os navegadores Playwright através do pacote CLI: node /app/node_modules/playwright-core/cli.js install chromium
• Defina PLAYWRIGHT_BROWSERS_PATH e certifique-se de que o caminho seja mantido.

​

Como vincular uma pasta de host na sandbox

​

Como funciona a memória

• Notas diárias em memória/YYYY-MM-DD.md
• Notas curadas de longo prazo em MEMORY.md (apenas sessões principais/privadas)

​

A memória continua esquecendo as coisas como eu faço ele ficar.

​

A pesquisa semântica de memória requer uma chave de API OpenAI

​

Faz memória persistir para sempre quais são os limites

​

Onde as coisas vivem em disco

​

Todos os dados são usados com o OpenClaw salvo localmente

• Local por padrão: sessões, arquivos de memória, configuração e espaço de trabalho ao vivo no host de Gateway (~/.openclaw + seu diretório de workspace).
• Remoto por exigência: mensagens que você envia para provedores de modelos (Anthropic/OpenAI/etc.) Acesse suas APIs e plataformas de bate-papo (WhatsApp/Telegram/Slack/etc.) armazenar dados da mensagem em seus servidores .
• Você controla o rasto: usando modelos locais mantém os alertas em sua máquina, mas o tráfego ainda passa pelos servidores do canal.

​

Onde o OpenClaw armazena seus dados

​

Onde deve viver o USUÁRIO AGENTSmd SOULmd

• Área de trabalho (por agente): AGENTS.md, SOUL.md, IDENTITY.md, USER.md, MEMORY.md (ou memory.md), memory/YYYY-MM-DD.md, HEARTBEAT.md opcional.
• Diretório de Estado (~/.openclaw): configuração, credenciais, perfis de autenticação, sessões, logs, e habilidades compartilhadas (~/.openclaw/skills).

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}

​

Qual é a estratégia de backup recomendada

​

Como eu desinstalar completamente o OpenClaw

​

Pode agentes trabalhar fora do espaço de trabalho

{
  agentes: {
    padrões: {
      workspace: "~/Projects/my-repo",
    },
  },
}

​

Im no modo remoto onde está a sessão da loja

​

Básico de configuração

​

Qual é o formato da configuração onde está

$OPENCLAW_CONFIG_PATH

​

Eu defino gatewaybind lan ou tailnet e agora nada ouve a interface do usuário dizer não autorizado

{
  gateway: {
    bind: "lan",
    auth: {
      mode: "token",
      token: "replace-me",
    },
  },
}

• O gateway.remote.token é apenas para chamadas remotas do CLI; ele não permite autora do gateway local.
• A UI de Controle autentica via connect.params.auth.token (armazenada nas configurações de app/UI). Evite colocar tokens em URLs.

​

Por que preciso de um token no localhost agora

​

Tenho que reiniciar depois de alterar a configuração

• gateway.reload.mode: "híbrido" (padrão): aplicar alterações seguras, reinicie para as críticas
• hot, restart, off também são suportados

​

Como faço para habilitar a pesquisa web e buscar web

{
  tools: {
    web: {
      search: {
        enabled: true,
        apiKey: "BRAVE_API_KEY_HERE",
        maxResults: 5,
      },
      fetch: {
        enabled: true,
      },
    },
  },
}

• Se você usa allowlists, adicione web_search/web_fetch ou group:web.
• web_fetch é habilitado por padrão (a menos que seja explicitamente desabilitado).
• Daemons lê vars env de ~/.openclaw/.env (ou o ambiente de serviço).

​

Como faço para executar um Gateway central com trabalhadores especializados em dispositivos

• Gateway (central): possui canais (Signal/WhatsApp), roteamento e sessões.
• Nós (dispositivos): Macs/iOS/Android conecta como periféricos e expõe as ferramentas locais (system.run, canvas, camera).
• Agentes (trabalhadores): separar brains/espaços de trabalho para papéis especiais (por exemplo, “Hetzner ops”, “Dados pessoais”).
• Subagentes: spawnar trabalho em segundo plano de um agente principal quando você quiser paralelismo.
• TUI: conectar ao Gateway e alternar agentes/sessões.

​

Pode o navegador OpenClaw rodar sem cabeça

{
  browser: { headless: true },
  agentes: {
    defaults: {
      sandbox: { browser: { headless: true } },
    },
  },
}

• Nenhuma janela visível do navegador (use capturas de tela se você precisar de visuais).
• Alguns sites são mais rigorosos em relação à automação em modo não-interativo (CAPTCHAs, anti-bot). Por exemplo, X/Twitter muitas vezes bloqueia sessões sem abrigo.

​

Como eu uso o Brave para o controle do navegador

​

gateways e nós remotos

​

Como os comandos se propagam entre o Telegram o gateway e os nós

​

Como meu agente pode acessar o meu computador se o Gateway está hospedado remotamente

1. Execute o Gateway no host sempre ativo (VPS/servidor residente).
2. Coloque o host de Gateway + seu computador na mesma rede.
3. Certifique-se de que o Gateway WS esteja acessível (conexão com a rede ou túnel SSH).
4. Abra o aplicativo macOS localmente e conecte-se ao modo Remoto por SSH (ou cauda direta) para que possa se registrar como um nó.
5. Aprovar o nó no Gateway:
   openclaw nodes pending
   openclaw nodes approve <requestId>
   

​

Escala Caudal está conectada, mas não recebo respostas o que agora

• Gateway está funcionando: openclaw gateway status
• Saúde do Gateway: openclaw status
• Saúde do canal: status dos canais de openclaw

• Se você usar o Serviço de Escala, certifique-se que o gateway.auth.allowTailscale está configurado corretamente.
• Se você se conectar através do túnel SSH, confirme que o túnel local está pronto no porto certo.
• Confirme suas listas de permissões (DM ou grupo) inclua sua conta.

​

Pode duas instâncias OpenClaw conversarem entre si com VPS local

openclaw agent --message "Olá do bot local" --deliver --channel telegram --reply-to <chat-id>

​

Preciso de VPSes separados para vários agentes

​

Existe algum benefício em usar um nó no meu laptop pessoal em vez de SSH de um VPS

• Nenhuma entrada SSH é necessária. Nós se conectam ao Gateway WebSocket e usam o pareamento de dispositivos.
• Controles de execução mais seguros. O system.run é escolhido pelo node allowlists/approvals no laptop.
• Mais ferramentas do dispositivo. Nós expõe canvas, câmera, e tela além de system.run.
• **Automatização do navegador local. * Mantenha o Gateway em um VPS, mas execute o Chrome localmente e controle de relé com a extensão Chrome + um host de nó no laptop.

​

Se eu instalar em um segundo laptop ou apenas adicionar um nó

​

Fazer nós executar um serviço de gateway

​

Existe uma forma de RPC API para aplicar a configuração

​

configapply minha configuração foi limpada como eu me recupero e evito isso

• Restaurar do backup (git ou um copiado ~/.openclaw/openclaw.json).
• Se você não tiver um backup, execute novamente o openclaw doctor e reconfigure os canais/modelos.
• Se isto fosse inesperado, registre um bug e inclua sua última configuração conhecida ou qualquer backup.
• Um agente de codificação local geralmente pode reconstruir uma configuração de trabalho a partir de logs ou histórico.

• Use openclaw config set para pequenas mudanças.
• Use openclaw configure para edições interativas.

​

Qual é o mínimo de configuração sane para uma primeira instalação

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

​

Como faço para configurar uma escala caudal em um VPS e conectar-se do meu Mac

1. Instale + faça o login no VPS
   curl -fsSL https://tailscale.com/install.sh ├sh
   sudo tailscale up
   
2. Instale + faça login em seu Mac
   • Use o aplicativo Tailscale e entre na mesma rede de cauda.
3. Ativar MagicDNS (recomendado)
   • No console administrativo da Escala Caudal, ative o MagicDNS para que o VPS tenha um nome estável.
4. Use o nome de host tailnet
   • SSH: ssh [email protected]
   • Gateway WS: ws://your-vps.tailnet-xxxx.ts.net:18789

openclaw gateway --tailscale serve

​

Como conectar um nó Mac a um servidor caudal de Gateway remoto

1. Certifique-se de que o VPS + Mac esteja na mesma caudanet.
2. Use o aplicativo macOS no modo remoto (SSH alvo pode ser o nome de host da rede tailnet). O app irá túnel da porta de Gateway e conectar como um nó.
3. Aprovar o nó do gateway:
   openclaw nodes pending
   openclaw nodes approve <requestId>
   

​

Env vars e carregamento de .env

​

Como o OpenClaw carrega variáveis de ambiente

• .env do diretório de trabalho atual
• a global fallback .env from ~/.openclaw/.env (aka $OPENCLAW_STATE_DIR/.env)

{
  env: {
    OPENROUTER_API_KEY: "sk-or-...",
    vars: { GROQ_API_KEY: "gsk-..." },
  },
}

​

Eu comecei o Gateway através do serviço e meus vars env desapareceram o que agora

1. Coloque as chaves que faltam em ~/.openclaw/.env para que elas sejam coletadas mesmo quando o serviço não herdar sua carapaça env.
2. Ativar importação do shell (opt-in convenience):

{
  env: {
    shellEnv: {
      enabled: true,
      timeoutMs: 15000,
    },
  },
}

​

Eu parei COPILOTGITHUBTOKEN mas o status de modelos mostra Shell env off porquê

1. Coloque o token em ~/.openclaw/.env:
   COPILOT_GITHUB_TOKEN=...
   
2. Ou ative a importação de shell (env.shellEnv.enabled: true).
3. Ou adicioná-lo ao seu bloco de configuração env (aplica-se somente se estiver faltando).

openclaw models status

​

Sessões e múltiplas conversas

​

Como faço para iniciar uma conversa nova

​

Fazer sessões reiniciadas automaticamente se eu nunca enviar novas

{
  sessão: {
    idleMinutes: 240,
  },
}

​

Existe uma maneira de fazer uma equipe de instâncias OpenClaw um CEO e muitos agentes

​

Por que o contexto recebeu uma tarefa intermediária truncada, como eu previno

• Peça ao bot para resumir o estado atual e escrevê-lo em um arquivo.
• Use /compact antes de tarefas longas, e /new ao mudar de tópicos.
• Mantenha um contexto importante na área de trabalho e peça ao bot para lê-lo de volta.
• Use subagentes para um trabalho longo ou paralelo para que o bate-papo principal permaneça menor.
• Escolha um modelo com uma janela de contexto maior se isso acontecer com frequência.

​

Como faço para redefinir completamente o OpenClaw mas mantê-lo instalado

openclaw reset

openclaw reset --scope completo --yes --não-interativo

openclaw onboard --install-daemon

• O assistente de integração também oferece Redefinir se ele vir uma configuração existente. Ver Wizard.
• Se você usou perfis (--profile / OPENCLAW_PROFILE), redefina cada diretório de estado (os padrões são ~/.openclaw-<profile>).
• Dev reset: openclaw gateway --dev --reset (somente dev; limpa configuração dev + credenciais + sessões + espaço de trabalho).

​

Estou ficando o contexto com erros muito grandes como redefinir ou compactar

• Compacta (mantém a conversa, mas resume as curvas mais antigas):
  /compacto
  
  ou /compact <instructions> para guiar o resumo.
• Redefinir (ID de sessão nova para a mesma chave de chat):
  /new
  /reset
  

• Ativar ou ajustar limpeza de sessão (agents.defaults.contextPruning) para aparar a saída da ferramenta antiga.
• Usar um modelo com uma janela de contexto maior.

​

Porque estou vendo solicitação LLM rejeitada messagesNcontentXtooluseinput campo obrigatório

​

Por que estou recebendo mensagens de pulso a cada 30 minutos

{
  agentes: {
    defaults: {
      heartbeat: {
        every: "2h", // ou "0m" para desativar
      },
    },
  },
}

​

Preciso adicionar uma conta bot a um grupo de WhatsApp

{
  canais: {
    whatsapp: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

​

Como faço para obter o JID de um grupo de WhatsApp

openclaw logs --siga --json

openclaw directory groups list --channel whatsapp

​

Porque não responder OpenClaw em um grupo

• Ponte da menção está ativado (padrão). Você deve @mencionar o bot (ou corresponder a mentionPatterns).
• Você configurou o arquivo channels.whatsapp.groups sem "*" e o grupo não é permitido.

​

Fazer threads compartilham o contexto com mensagens diretas

​

Quantos espaços de trabalho e agentes eu posso criar

• Crescimento do disco: sessões + transcrições vivem em ~/.openclaw/agents/<agentId>/sessions/.
• Custo de token: mais agentes significa mais uso simultâneo dos modelos.
• Ops em excesso: perfis de autenticação por agente, espaços de trabalho e roteamento de canais.

• Mantenha um espaço de trabalho ativo por agente (agents.defaults.workspace).
• Apagar sessões antigas (exclua JSONL ou armazene entradas) se o disco crescer.
• Use o médico do openclaw para identificar espaços de trabalho perdidos e incompatibilidades de perfil.

​

Posso executar vários bots ou chats ao mesmo tempo Slack e como devo configurar isso

• Host do Gateway sempre ligado (VPS/Mac mini).
• Um agente por papel (vinculações).
• Canal(ais) do Slack vinculados a estes agentes.
• Navegador local via retransmissão de extensão (ou um nó) quando necessário.

​

Modelos: padrões, seleção, alias, troca

​

Qual é o modelo padrão

agents.defaults.model.primary

​

Que modelo você recomenda

​

Posso usar modelos auto-hospedados llamacpp vLLM Ollama

​

Como faço para alternar modelos sem limpar minha configuração

• /model no chat (rápido, por sessão)
• openclaw models set ... (atualiza apenas configuração do modelo)
• openclaw configure --section model (interativo)
• edite agents.defaults.model em ~/.openclaw/openclaw.json

​

O que usar OpenClaw, Flawe Krill para modelos

• OpenClaw + Flawd: Opus antrópico (anthropic/claude-opus-4-6) - ver Anthropic.
• Krill: MiniMax M2.1 (minimax/MiniMax-M2.1) - see MiniMax.

​

Como faço para alternar os modelos na mosca sem reiniciar

/model sonnet
/model haiku
/model opus
/model gpt
/model gpt-mini
/model gemini
/model gemini-flash

/modelo 3

/model opus@anthropic:default
/model opus@anthropic:work

/model anthropic/claude-opus-4-6

​

Posso usar GPT 5.2 para tarefas diárias e Codex 5.3 para codificação

• Interruptor rápido (por sessão): /model gpt-5.2 para tarefas diárias, /model gpt-5.3-codex para codificação.
• Padrão + interrupção: configure agents.defaults.model.primary para openai/gpt-5.2, então mude para openai-codex/gpt-5.3-codex quando programar (ou para o outro lugar).
• Subagentes: rotear tarefas de codificação para subagentes com um modelo padrão diferente.

​

Por que eu vejo modelo não é permitido e então não há resposta

Model "provider/model" is not allowed. Use /model to list available models.

​

Por que eu vejo um modelo desconhecido minimaxMiniMaxM21

1. Atualize para 2026.1.12 (ou execute a partir da origem main), depois reinicie o gateway.
2. Certifique-se de que o MiniMax está configurado (assistente ou JSON), ou que uma tecla de API MiniMax existe nos perfis env/auth para que o provedor possa ser injetado.
3. Use o modelo exato (sensível a maiúsculas): minimax/MiniMax-M2.1 ou minimax/MiniMax-M2.1-lightning.
4. Run:
   openclaw models list
   
   e escolha da lista (ou /model list no chat).

​

Posso usar o MiniMax como meu padrão e OpenAI para tarefas complexas

{
  env: { MINIMAX_API_KEY: "sk-...", OPENAI_API_KEY: "sk-... },
  agentes: {
    defaults: {
      model: { primary: "minimax/MiniMax-M2. " },
      models: {
        "minimax/MiniMax-M2. ": { alias: "minimax" },
        "openai/gpt-5. ": { alias: "gpt" },
      },
    },
  },
}

/model pt

• Agente A default: MiniMax
• Agente B padrão: OpenAI
• Rota pelo agente ou use /agent para alternar

​

Opus sonnet gpt embutido atalhos

• opus → anthropic/claude-opus-4-6
• sonnet → anthropic/claude-sonnet-4-5
• gpt → openai/gpt-5.2
• gpt-mini → openai/gpt-5-mini
• gemini → google/gemini-3-pro-preview
• gemini-flash → google/gemini-3-flash-preview

​

Como definir os apelidos de atalhos do modelo

{
  agentes: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": { alias: "opus" },
        "anthropic/claude-sonnet-4-5": { alias: "sonnet" },
        "anthropic/claude-haiku-4-5": { alias: "haiku" },
      },
    },
  },
}

​

Como eu adiciono modelos de outros provedores como OpenRouter ou ZAI

{
  agentes: {
    defaults: {
      model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
      models: { "openrouter/anthropic/claude-sonnet-4-5": {} },
    },
  },
  env: { OPENROUTER_API_KEY: "sk-or-. ." },
}

{
  agentes: {
    defaults: {
      model: { primary: "zai/glm-4. " },
      models: { "zai/glm-4. ": {} },
    },
  },
  env: { ZAI_API_KEY: "..." },
}

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

• Execute openclaw agents add <id> e configure a autentificação durante o assistente.
• Ou copie o arquivo auth-profiles.json do agente principal no agentDir do novo agente no agentDir do novo agente.

​

Falha no modelo e “Todos os modelos falharam”

​

Como funciona a falha

1. Rotação de perfil de autenticação dentro do mesmo provedor.
2. Fallback de modelo para o próximo modelo em agents.defaults.model.fallbacks.

​

O que significa este erro

Nenhuma credencial encontrada para o perfil "anthropic:default"

​

Corrigir checklist para nenhuma credencial encontrada para o anthropicdefault de perfil

• Confirme onde vivem os perfis de autenticação (novos vs. caminhos legados)
  • Atual: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • Legado: ~/.openclaw/agent/* (mignado pelo médico openclaw)
• Confirme se sua var de env está carregada pelo Gateway
  • Se você definir ANTHROPIC_API_KEY em seu projétil, mas executar o Gateway via systemd/launchd, ele não pode herdá-lo. Coloque em ~/.openclaw/.env ou ative env.shellEnv.
• Certifique-se de que você está editando o agente correto
  • Configurações de multiagentes significam que pode haver vários arquivos auth-profiles.json.
• Estado do modelo/auth Sanity-check
  • Use o status de modelos openclaw para ver os modelos configurados e se provedores são autenticados.

• Use um token de configuração
  • Execute claude setup-token, então cole-o com openclaw models auth setup-token --provider anthropic.
  • Se o token foi criado em outra máquina, use openclaw models auth paste-token --provider anthropic.
• Se você quiser usar uma chave de API em vez disso
  • Coloque ANTHROPIC_API_KEY em ~/.openclaw/.env no host de gateway.
  • Limpa qualquer ordem fixada que força um perfil faltante:
    openclaw models auth order clear - provedor antrópico
    
• Confirme que você está executando comandos no host de gateway
  • Em modo remoto, perfis de autenticação vivem na máquina de entrada, não no seu laptop.

​

Por que também experimentou o Google Gemini e falhou

​

Perfis de autenticação: o que são e como gerenciá-los

​

O que é um perfil de autenticação

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

​

Quais são IDs de perfil típicos

• anthropic:default (comum quando nenhuma identidade de e-mail existe)
• anthropic:<email> para identidades OAuth
• IDs personalizados que você escolher (por exemplo, anthropic:work)

​

Eu posso controlar qual perfil de autenticação está tentando primeiro

# Padrões para o agente padrão configurado (omit --agent)
openclaw models auth order get --provider anthropic

# Lock rotation to a um único perfil (somente tente este)
openclaw models auth order set --provider anthropic:default

# Or set uma ordem explícita (fallback dentro do provedor)
openclaw models auth order --provider anthropic:work anthropic:work anthropic:default

# Clear override (fall to config auth. rder / round-robin)
ordem de autenticação dos modelos openclaw limpo - provedor antrópico

openclaw models auth order set --provider anthropic --agent main anthropic:default

​

OAuth vs chave API qual é a diferença

• OAuth muitas vezes utiliza o acesso à assinatura (quando aplicável).
• Chaves API usam faturamento pay-por-token.

​

Gateway: portas, “já em execução” e modo remoto

​

Qual porta usa o Gateway

--port > OPENCLAW_GATEWAY_PORT > gateway.port > padrão 18789

​

Por que o status do gateway openclaw diz Runtime executando mas RPC probe falhou

• Probe target: (o URL a sonda realmente usada)
• Ouvindo: (o que realmente está ligado na porta)
• Último erro do gateway: (causa comum da raiz quando o processo está vivo, mas a porta não está escutando)

​

Por que o status do gateway openclaw mostra a configuração cli e o serviço de configuração diferentes

openclaw gateway install --force

​

O que outra instância do gateway é já escutar a média

​

Como eu rodo o OpenClaw no modo remoto que o cliente conecta a um Gateway em outro lugar

{
  gateway: {
    mode: "remote",
    remote: {
      url: "ws://gateway.tailnet:18789",
      token: "your-token",
      password: "your-password",
    },
  },
}

• openclaw gateway começa somente quando gateway.mode é local (ou você passa a bandeira de substituição).
• O app macOS assiste o arquivo de configuração e troca os modos de configuração ao vivo quando esses valores forem alterados.

​

A UI Controle diz não autorizado ou continua reconectando o que agora

• A UI Control armazena o token no navegador localStorage key openclaw.control.settings.v1.

• Mais rápido: openclaw dashboard (imprime + copia o URL do painel, tenta abrir; mostra hint de SSH, se nada for assim).
• Se você ainda não tem um token: openclaw doctor --generate-gateway-token.
• Se remoto, o túnel primeiro: ssh -N -L 18789:127.0.0.1:18789 user@host então abra http://127.0.0.1:18789/.
• Defina gateway.auth.token (ou OPENCLAW_GATEWAY_TOKEN) no host de gateway.
• Nas configurações da UI de controle, cole o mesmo token.
• Ainda está travado? Execute openclaw status --all e siga Troubleshooting. Ver Dashboard para detalhes de autenticação.

​

Eu defino gatewaybind tailnet mas não pode vincular nada

• Comece a escala Caudal naquele host (para que ele tenha um endereço 100.x), ou
• Alterne para gateway.bind: "loopback" / "lan".

​

Posso executar vários Gateways no mesmo host

• OPENCLAW_CONFIG_PATH (per-instance config)
• OPENCLAW_STATE_DIR (estado por instância)
• agents.defaults.workspace (isolamento do espaço de trabalho)
• gateway.port (portas únicas)

• Use openclaw --profile <name> … por instância (auto-cria ~/.openclaw-<name>).
• Defina um gateway.port único em cada configuração do perfil (ou passe --port para execução manual).
• Install a per-profile service: openclaw --profile <name> gateway install.

​

O que significa o código de handshake inválido 1008

• Você abriu o URL HTTP em um navegador (http://...) em vez de um cliente WS.
• Você usou a porta ou caminho errado.
• Um proxy ou túnel desceu os cabeçalhos de autenticação ou enviou uma solicitação que não é do Gateway.

1. Utilize a URL do WS: ws://<host>:18789 (ou wss://... se HTTPS).
2. Não abra a porta do WS em uma guia normal do navegador.
3. Se a autenticação estiver ativada, inclua o token/password no quadro connect.

openclaw tui --url ws://<host>:18789 --token <token>

​

Registro e depuração

​

Onde estão os registros

/tmp/openclaw/openclaw-YYYY-MM-DD.log

openclaw logs --follow

• macOS: $OPENCLAW_STATE_DIR/logs/gateway.log e gateway.err.log (padrão: ~/.openclaw/logs/...; perfis usam ~/.openclaw-<profile>/logs/...)
• Linux: journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager
• Windows: schtasks /Query /TN "OpenClaw Gateway (<profile>)" /V /FO LIST

​

Como eu inicio reiniciar o serviço do Gateway

status do gateway openclaw
Reinício do gateway openclaw

​

Fechei meu terminal no Windows como reiniciar o OpenClaw

wsl
Status do gateway openclaw
Reinício do gateway openclaw

openclaw gateway run

status do gateway openclaw
Reinício do gateway openclaw

openclaw gateway run

​

O Gateway está certo, mas as respostas nunca chegam ao que devo verificar

openclaw status
openclaw status
de canais openclaw status
logs do openclaw --follow

• Autorização do modelo não carregada no host de gateway (veja status dos modelos).
• Pareamento/Permitir lista de bloqueando respostas (verifique a configuração do canal + logs).
• WebChat/Dashboard está aberto sem o token correto.

​

Desconectado do gateway não há razão para o quê agora

1. O Gateway está correndo? openclaw gateway status
2. O Gateway está saudável? openclaw status
3. A interface do usuário tem o token correto? openclaw dashboard
4. Se remoto, a ligação ao túnel/Escala Caudal será maior?

openclaw logs --follow

​

Telegram setMyCommands falhou com erros de rede o que devo verificar

canal de openclaw status
openclaw logs --channel telegram

​

A TUI não mostra saída o que devo verificar

openclaw status
openclaw status
registros openclaw --follow

​

Como eu pareço completamente e inicio o Gateway

openclaw gateway para
inicação no gateway openclaw

openclaw gateway run

​

ELI5 gateway openclaw reinicializa contra o gateway openclaw

• Reinício do gateway openclaw: reinicia o serviço em segundo plano (iniciar/sistema).
• gateway openclaw: executa o gateway em primeiro plano para esta sessão terminal.

​

Qual é a maneira mais rápida de obter mais detalhes quando algo falha

​

Mídia e anexos

​

Minha habilidade gerou uma imagemPDF mas nada foi enviado

openclaw message send --target +15555550123 --message "Aqui está" --media /caminho/para/arquivo.png

• O canal alvo suporta mídia de saída e não é bloqueado por listas de permissões.
• O arquivo está dentro dos limites de tamanho do provedor (imagens são redimensionadas para o máximo de 2048px).

​

Controle de segurança e acesso

​

É seguro expor OpenClaw a mensagens diretas de entrada

• Comportamento padrão em canais que rodam DMS é emparelhando:
  • Remetentes desconhecidos recebem um código de pareamento; o bot não processa sua mensagem.
  • Approve with: openclaw pairing approve <channel> <code>
  • Pedidos pendentes são limitados em 3 por canal; verifique a lista de emparelhamento do openclaw <channel> se o código não chegar.
• Abrir DMs publicamente requer opt-in explícito (dmPolicy: "open" e allowlist "*").

​

O prompt de injeção é apenas uma preocupação para bots públicos

• usando apenas leitura ou agente “leitor” desativado pela ferramenta para resumir conteúdo não confiável
• mantendo web_search / web_fetch / browser desligado para agentes habilitados com ferramentas
• sandboxing e estrita lista de permissões da ferramenta

​

Se meu bot tiver sua própria conta de e-mail do GitHub ou número de telefone

​

Posso dar-lhe autonomia sobre as minhas mensagens de texto e é muito seguro

• Mantenha DMs no modo de emparelhamento ou uma lista apertada de permissões.
• Use um número ou conta separada se você quiser que envie uma mensagem em seu nome.
• Deixe este rascunho, depois aprove antes de enviar.

​

Posso usar modelos mais baratos para tarefas pessoais de assistente

​

Eu executei no Telegram mas não consegui um código de pareamento

openclaw pairing list telegram

​

O WhatsApp irá enviar mensagens para os meus contatos Como o pareamento funciona

openclaw pairing approve whatsapp <code>

openclaw pairing list whatsapp

​

Comandos de bate-papo, tarefas canceladas e “isto não vai parar”

​

Como faço para impedir que as mensagens internas do sistema sejam exibidas no bate-papo

/verbose off
/reasoning off

​

Como paro de cancelar uma tarefa

parar
cancelar
esc
esperar
exit
interromper

ação de processo:kill sessionId:XXX

​

Como enviar uma mensagem do Discord de mensagens de Crosscontext do Telegram negadas

{
  agents: {
    defaults: {
      tools: {
        message: {
          crossContext: {
            allowAcrossProviders: true,
            marcador: { enabled: true, prefixo: "[de {channel}] " },
          },
        },
      },
    },
  },
}

​

Por que parece que o bot ignora mensagens de fogo rápidas

• steer - novas mensagens redirecionam a tarefa atual
• followup - executa mensagens uma de cada vez
• coletar - mensagens em lote e responder uma vez (padrão)
• steer-backlog - dirigir agora, e depois processar o backlog
• interrupt - abortar a execução atual e começar de novo

​

Responda à pergunta exata da captura de tela/registro de bate-papo