Como Usar o OpenClaw
Guia prático para aproveitar ao máximo o agente autônomo de IA do RoqueOS.
Interface do Agente
O app do Agente IA é dividido em duas áreas principais:
- Painel de Chat (esquerda) — onde você envia mensagens e acompanha as respostas
- Visualização do Desktop (direita) — stream ao vivo do que o agente está fazendo no container
Painel de Steps
Abaixo do chat, um painel de Steps em Tempo Real mostra cada ação que o agente está executando: navegando para uma URL, clicando em um elemento, executando um comando, etc.
Criando uma Sessão
Cada conversa com o agente cria uma sessão — um container Docker isolado com um desktop Linux exclusivo. Para iniciar:
- Abra o app Agente IA no Launchpad.
- Clique em Nova Sessão.
- O container será inicializado (pode levar 10–30 segundos na primeira vez).
- Quando o desktop aparecer no painel direito, o agente está pronto.
Enviando Tarefas
Boas Práticas para Prompts
Seja específico e objetivo ao descrever a tarefa. Quanto mais contexto você fornecer, melhor o resultado.
❌ Vago:
Pesquise sobre Docker✅ Específico:
Pesquise as 5 principais diferenças entre Docker Compose v2 e v3,
crie um arquivo markdown resumindo os pontos e salve em /home/user/docker-comparison.mdExemplos de Tarefas
Pesquisa e documentação:
Acesse o site hetzner.com, encontre os planos de VPS disponíveis
e crie uma tabela comparativa com preços e recursos em CSV.Automação de formulários:
Preencha o formulário de cadastro em [URL] com os dados:
nome: João Silva, email: joao@exemplo.com, plano: básicoDesenvolvimento:
Crie um script Python que faça scraping dos títulos de notícias
do Hacker News e salve os 10 primeiros em um arquivo JSON.Análise de sites:
Acesse este repositório GitHub [URL], leia o README e me explique
o que o projeto faz e quais são os pré-requisitos de instalação.Ações que o Agente Pode Executar no RoqueOS
O OpenClaw pode interagir diretamente com seu RoqueOS além do container isolado:
| Ação | Descrição |
|---|---|
| Notificação | Enviar um alerta para o seu desktop RoqueOS |
| Abrir App | Abrir um aplicativo específico no Launchpad |
| Abrir URL | Abrir uma URL no navegador do RoqueOS |
Exemplo de uso: ao final de uma tarefa longa, o agente pode enviar uma notificação automática avisando que terminou.
Gerenciando Sessões
Sessões Ativas
Todas as sessões ativas ficam listadas no topo do app. Você pode:
- Retomar uma sessão anterior clicando nela
- Encerrar uma sessão para liberar recursos do servidor
Limite de Sessões Simultâneas
Por padrão, o servidor permite até 3 sessões simultâneas (configurável via AGENT_MAX_SESSIONS). Encerre sessões que não está mais usando para economizar RAM.
Screenshot e Fullscreen
- Screenshot — clique no ícone de câmera para capturar o estado atual do desktop do agente
- Fullscreen — expanda a visualização do desktop para tela cheia para acompanhar melhor tarefas visuais
Limitações Conhecidas
- O agente opera em um ambiente isolado — não tem acesso direto aos seus arquivos locais a menos que você forneça as informações via chat
- Tarefas que requerem login em contas (email, redes sociais) precisam que você forneça as credenciais durante a conversa
- O timeout padrão de sessão é 30 minutos de inatividade — tarefas muito longas podem precisar de interação periódica
Solução de Problemas
Agente não responde
- Verifique se o servidor está online:
curl http://localhost:27021/health - Confirme que a chave de API está configurada corretamente
- Encerre a sessão atual e crie uma nova
Desktop não aparece no painel
O container pode ainda estar inicializando. Aguarde 30 segundos e recarregue o app.
Respostas lentas ou incompletas
Pode ser um problema de rate limit do provedor de IA. Aguarde alguns instantes e tente novamente, ou reduza a complexidade da tarefa.