AGENTS.md padrão

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):

mkdir -p ~/.openclaw/workspace

2. Copie os templates padrão de workspace para o workspace:

cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.mdcp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.mdcp 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:

cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md

4. Opcional: escolha um workspace diferente definindo agents.defaults.workspace (compatível com ~):

{  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.

cd ~/.openclaw/workspacegit initgit add AGENTS.mdgit 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:<agentId>:<channel>:group:<id> (salas/canais: agent:<agentId>:<channel>:channel:<id>); 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:<id> ou channel:<id> (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
• Runtime do agente