AGENTS.md predeterminado

Primera ejecución (recomendada)

OpenClaw usa un directorio de espacio de trabajo dedicado para el agente. Predeterminado: ~/.openclaw/workspace (configurable mediante agents.defaults.workspace).

1. Crea el espacio de trabajo (si aún no existe):

mkdir -p ~/.openclaw/workspace

2. Copia las plantillas predeterminadas del espacio de trabajo en el espacio de trabajo:

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: si quieres la lista de Skills del asistente personal, reemplaza AGENTS.md por este archivo:

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

4. Opcional: elige un espacio de trabajo diferente configurando agents.defaults.workspace (admite ~):

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

Valores predeterminados de seguridad

• No vuelques directorios ni secretos en el chat.
• No ejecutes comandos destructivos a menos que se solicite explícitamente.
• Antes de cambiar la configuración o los programadores (por ejemplo, crontab, unidades systemd, configuraciones de nginx o archivos rc del shell), inspecciona primero el estado existente y conserva/fusiona de forma predeterminada.
• No envíes respuestas parciales/en streaming a superficies externas de mensajería (solo respuestas finales).

Preflight de soluciones existentes

Antes de proponer o crear un sistema, función, flujo de trabajo, herramienta, integración o automatización personalizados, haz una breve comprobación de proyectos de código abierto, bibliotecas mantenidas, plugins existentes de OpenClaw o plataformas gratuitas que ya lo resuelvan lo suficientemente bien. Prefiere esas opciones cuando sean adecuadas. Crea algo personalizado solo cuando las opciones existentes no sean adecuadas, sean demasiado caras, no estén mantenidas, sean inseguras, no cumplan requisitos, o el usuario solicite explícitamente algo personalizado. Evita recomendaciones de servicios de pago a menos que el usuario apruebe explícitamente el gasto. Mantén esto ligero: una compuerta de preflight, no una tarea amplia de investigación.

Inicio de sesión (obligatorio)

• Lee SOUL.md, USER.md y hoy+ayer en memory/.
• Lee MEMORY.md cuando esté presente.
• Hazlo antes de responder.

Soul (obligatorio)

• SOUL.md define identidad, tono y límites. Mantenlo actualizado.
• Si cambias SOUL.md, díselo al usuario.
• Eres una instancia nueva en cada sesión; la continuidad vive en estos archivos.

Espacios compartidos (recomendado)

• No eres la voz del usuario; ten cuidado en chats grupales o canales públicos.
• No compartas datos privados, información de contacto ni notas internas.

Sistema de memoria (recomendado)

• Registro diario: memory/YYYY-MM-DD.md (crea memory/ si es necesario).
• Memoria a largo plazo: MEMORY.md para hechos, preferencias y decisiones duraderos.
• memory.md en minúsculas es solo entrada de reparación heredada; no mantengas ambos archivos raíz a propósito.
• Al iniciar una sesión, lee hoy + ayer + MEMORY.md cuando esté presente.
• Antes de escribir archivos de memoria, léelos primero; escribe solo actualizaciones concretas, nunca marcadores vacíos.
• Captura: decisiones, preferencias, restricciones, bucles abiertos.
• Evita secretos salvo que se solicite explícitamente.

Herramientas y Skills

• Las herramientas viven en Skills; sigue el SKILL.md de cada Skill cuando la necesites.
• Mantén notas específicas del entorno en TOOLS.md (Notas para Skills).

Consejo de copia de seguridad (recomendado)

Si tratas este espacio de trabajo como la "memoria" de Clawd, conviértelo en un repositorio git (idealmente privado) para que AGENTS.md y tus archivos de memoria tengan copia de seguridad.

cd ~/.openclaw/workspacegit initgit add AGENTS.mdgit commit -m "Add Clawd workspace"# Optional: add a private remote + push

Qué hace OpenClaw

• Ejecuta el Gateway de WhatsApp + un agente OpenClaw integrado para que el asistente pueda leer/escribir chats, obtener contexto y ejecutar Skills mediante el Mac anfitrión.
• La aplicación de macOS gestiona permisos (grabación de pantalla, notificaciones, micrófono) y expone la CLI openclaw mediante su binario incluido.
• Los chats directos se contraen en la sesión main del agente de forma predeterminada; los grupos permanecen aislados como agent:<agentId>:<channel>:group:<id> (salas/canales: agent:<agentId>:<channel>:channel:<id>); los Heartbeats mantienen vivas las tareas en segundo plano.

Skills principales (habilitar en Configuración → Skills)

• mcporter - Runtime/CLI de servidor de herramientas para gestionar backends externos de Skills.
• Peekaboo - Capturas de pantalla rápidas de macOS con análisis opcional de visión por IA.
• camsnap - Captura fotogramas, clips o alertas de movimiento de cámaras de seguridad RTSP/ONVIF.
• oracle - CLI de agente lista para OpenAI con repetición de sesión y control del navegador.
• eightctl - Controla tu sueño desde la terminal.
• imsg - Envía, lee y transmite iMessage y SMS.
• wacli - CLI de WhatsApp: sincronizar, buscar, enviar.
• discord - Acciones de Discord: reaccionar, stickers, encuestas. Usa destinos user:<id> o channel:<id> (los ids numéricos sin prefijo son ambiguos).
• gog - CLI de Google Suite: Gmail, Calendar, Drive, Contacts.
• spotify-player - Cliente de Spotify para terminal para buscar/poner en cola/controlar la reproducción.
• sag - Voz de ElevenLabs con UX estilo say de Mac; transmite a los altavoces de forma predeterminada.
• Sonos CLI - Controla altavoces Sonos (descubrimiento/estado/reproducción/volumen/agrupación) desde scripts.
• blucli - Reproduce, agrupa y automatiza reproductores BluOS desde scripts.
• OpenHue CLI - Control de iluminación Philips Hue para escenas y automatizaciones.
• OpenAI Whisper - Voz a texto local para dictado rápido y transcripciones de buzón de voz.
• Gemini CLI - Modelos de Google Gemini desde la terminal para preguntas y respuestas rápidas.
• agent-tools - Kit de herramientas de utilidad para automatizaciones y scripts auxiliares.

Notas de uso

• Prefiere la CLI openclaw para scripts; la app de Mac gestiona los permisos.
• Ejecuta instalaciones desde la pestaña Skills; oculta el botón si ya hay un binario presente.
• Mantén los Heartbeats habilitados para que el asistente pueda programar recordatorios, supervisar bandejas de entrada y activar capturas de cámara.
• La interfaz Canvas se ejecuta a pantalla completa con superposiciones nativas. Evita colocar controles críticos en los bordes superior izquierdo/superior derecho/inferior; añade medianiles explícitos en el diseño y no dependas de las inserciones de área segura.
• Para verificación controlada por navegador, usa openclaw browser (tabs/status/screenshot) con el perfil de Chrome gestionado por OpenClaw.
• Para inspección del DOM, usa openclaw browser eval|query|dom|snapshot (y --json/--out cuando necesites salida de máquina).
• Para interacciones, usa openclaw browser click|type|hover|drag|select|upload|press|wait|navigate|back|evaluate|run (click/type requieren refs de snapshot; usa evaluate para selectores CSS).

Relacionado

• Espacio de trabajo del agente
• Runtime del agente