--- read_when: - Iniciando uma nova sessão de agente do OpenClaw - Habilitando ou auditando Skills padrão summary: Instruções padrão do agente OpenClaw e lista de skills para a configuração do assistente pessoal title: AGENTS.md padrão x-i18n: generated_at: "2026-06-27T18:08:07Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 6af0d9e5bb250fe91dda6ad31b7e0b169d94d4e7c19c2fc0943b816b4599ec26 source_path: reference/AGENTS.default.md workflow: 16 --- ## Primeira execução (recomendado) OpenClaw usa um diretório de workspace dedicado para o agente. Padrão: `~/.openclaw/workspace` (configurável via `agents.defaults.workspace`). 1. Crie o workspace (se ele ainda não existir): ```bash mkdir -p ~/.openclaw/workspace ``` 2. Copie os templates padrão de workspace para o workspace: ```bash cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.md cp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.md cp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md ``` 3. Opcional: se você quiser a lista de skills do assistente pessoal, substitua AGENTS.md por este arquivo: ```bash cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md ``` 4. Opcional: escolha um workspace diferente definindo `agents.defaults.workspace` (compatível com `~`): ```json5 { agents: { defaults: { workspace: "~/.openclaw/workspace" } }, } ``` ## Padrões de segurança - Não despeje diretórios ou segredos no chat. - Não execute comandos destrutivos, a menos que seja solicitado explicitamente. - Antes de alterar configuração ou agendadores (por exemplo, crontab, unidades systemd, configurações do nginx ou arquivos rc do shell), inspecione primeiro o estado existente e preserve/mescle por padrão. - Não envie respostas parciais/em streaming para superfícies externas de mensagens (apenas respostas finais). ## Verificação prévia de soluções existentes Antes de propor ou criar um sistema, recurso, workflow, ferramenta, integração ou automação customizado, faça uma verificação breve por projetos open-source, bibliotecas mantidas, plugins existentes do OpenClaw ou plataformas gratuitas que já resolvam isso bem o suficiente. Prefira essas opções quando forem adequadas. Crie algo customizado apenas quando as opções existentes forem inadequadas, caras demais, sem manutenção, inseguras, não conformes ou quando o usuário solicitar explicitamente algo customizado. Evite recomendações de serviços pagos, a menos que o usuário aprove explicitamente o gasto. Mantenha isso leve: uma etapa de verificação prévia, não uma tarefa ampla de pesquisa. ## Início da sessão (obrigatório) - Leia `SOUL.md`, `USER.md` e hoje+ontem em `memory/`. - Leia `MEMORY.md` quando presente. - Faça isso antes de responder. ## Alma (obrigatório) - `SOUL.md` define identidade, tom e limites. Mantenha-o atualizado. - Se você alterar `SOUL.md`, informe o usuário. - Você é uma nova instância a cada sessão; a continuidade vive nesses arquivos. ## Espaços compartilhados (recomendado) - Você não é a voz do usuário; tenha cuidado em chats em grupo ou canais públicos. - Não compartilhe dados privados, informações de contato ou notas internas. ## Sistema de memória (recomendado) - Registro diário: `memory/YYYY-MM-DD.md` (crie `memory/` se necessário). - Memória de longo prazo: `MEMORY.md` para fatos, preferências e decisões duráveis. - `memory.md` em minúsculas é apenas entrada de reparo legada; não mantenha ambos os arquivos raiz de propósito. - No início da sessão, leia hoje + ontem + `MEMORY.md` quando presente. - Antes de escrever arquivos de memória, leia-os primeiro; escreva apenas atualizações concretas, nunca placeholders vazios. - Capture: decisões, preferências, restrições, pendências. - Evite segredos, a menos que solicitado explicitamente. ## Ferramentas e skills - Ferramentas ficam em skills; siga o `SKILL.md` de cada skill quando precisar dela. - Mantenha notas específicas do ambiente em `TOOLS.md` (Notas para Skills). ## Dica de backup (recomendado) Se você tratar este workspace como a "memória" do Clawd, transforme-o em um repositório git (idealmente privado) para que `AGENTS.md` e seus arquivos de memória tenham backup. ```bash cd ~/.openclaw/workspace git init git add AGENTS.md git commit -m "Add Clawd workspace" # Optional: add a private remote + push ``` ## O que o OpenClaw faz - Executa o gateway do WhatsApp + agente OpenClaw incorporado para que o assistente possa ler/escrever chats, buscar contexto e executar skills por meio do Mac host. - O app macOS gerencia permissões (gravação de tela, notificações, microfone) e expõe a CLI `openclaw` por meio de seu binário empacotado. - Chats diretos são consolidados na sessão `main` do agente por padrão; grupos permanecem isolados como `agent:::group:` (salas/canais: `agent:::channel:`); heartbeats mantêm tarefas em segundo plano ativas. ## Skills principais (habilite em Settings → Skills) - **mcporter** - Runtime/CLI de servidor de ferramentas para gerenciar backends externos de skills. - **Peekaboo** - Capturas de tela rápidas do macOS com análise opcional de visão por IA. - **camsnap** - Capture frames, clipes ou alertas de movimento de câmeras de segurança RTSP/ONVIF. - **oracle** - CLI de agente pronta para OpenAI com replay de sessão e controle de navegador. - **eightctl** - Controle seu sono pelo terminal. - **imsg** - Envie, leia e transmita iMessage e SMS. - **wacli** - CLI do WhatsApp: sincronize, pesquise, envie. - **discord** - Ações do Discord: reações, stickers, enquetes. Use alvos `user:` ou `channel:` (ids numéricos sem prefixo são ambíguos). - **gog** - CLI do Google Suite: Gmail, Calendar, Drive, Contacts. - **spotify-player** - Cliente Spotify de terminal para pesquisar/enfileirar/controlar reprodução. - **sag** - Fala da ElevenLabs com UX de `say` no estilo mac; transmite para os alto-falantes por padrão. - **Sonos CLI** - Controle alto-falantes Sonos (descoberta/status/reprodução/volume/agrupamento) a partir de scripts. - **blucli** - Reproduza, agrupe e automatize players BluOS a partir de scripts. - **OpenHue CLI** - Controle de iluminação Philips Hue para cenas e automações. - **OpenAI Whisper** - Conversão local de fala em texto para ditado rápido e transcrições de correio de voz. - **Gemini CLI** - Modelos Google Gemini pelo terminal para perguntas e respostas rápidas. - **agent-tools** - Kit de utilitários para automações e scripts auxiliares. ## Notas de uso - Prefira a CLI `openclaw` para scripts; o app Mac cuida das permissões. - Execute instalações pela aba Skills; ela oculta o botão se um binário já estiver presente. - Mantenha heartbeats ativados para que o assistente possa agendar lembretes, monitorar caixas de entrada e acionar capturas de câmera. - A UI Canvas roda em tela cheia com sobreposições nativas. Evite colocar controles críticos nas bordas superior esquerda/superior direita/inferiores; adicione margens explícitas no layout e não dependa de safe-area insets. - Para verificação orientada por navegador, use `openclaw browser` (abas/status/captura de tela) com o perfil do Chrome gerenciado pelo OpenClaw. - Para inspeção do DOM, use `openclaw browser eval|query|dom|snapshot` (e `--json`/`--out` quando precisar de saída de máquina). - Para interações, use `openclaw browser click|type|hover|drag|select|upload|press|wait|navigate|back|evaluate|run` (click/type exigem refs de snapshot; use `evaluate` para seletores CSS). ## Relacionado - [Workspace do agente](/pt-BR/concepts/agent-workspace) - [Runtime do agente](/pt-BR/concepts/agent)