AGENTS.md predeterminado

# Primera ejecución (recomendado)

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.md
cp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.md
cp 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.
• No envíes respuestas parciales/en streaming a superficies de mensajería externas (solo respuestas finales).

# Inicio de sesión (obligatorio)

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

# Alma (obligatorio)

• SOUL.md define la identidad, el tono y los límites. Mantenlo actualizado.
• Si cambias SOUL.md, avisa 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 exista.
• Captura: decisiones, preferencias, restricciones, bucles abiertos.
• Evita los secretos a menos que se solicite explícitamente.

# Herramientas y Skills

• Las herramientas viven en Skills; sigue el SKILL.md de cada Skill cuando lo necesites.
• Mantén las 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/workspace
git init
git add AGENTS.md
git commit -m "Add Clawd workspace"
# Optional: add a private remote + push

# Qué hace OpenClaw

• Ejecuta el Gateway de WhatsApp + el agente de codificación de Pi para que el asistente pueda leer/escribir chats, obtener contexto y ejecutar Skills mediante el Mac anfitrión.
• La app de macOS gestiona permisos (grabación de pantalla, notificaciones, micrófono) y expone la CLI openclaw mediante su binario incluido.
• Los chats directos se agrupan 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 Heartbeat mantienen vivas las tareas en segundo plano.

# Skills principales (activar en Settings → Skills)

• mcporter - Runtime/CLI del servidor de herramientas para gestionar backends externos de Skills.
• Peekaboo - Capturas de pantalla rápidas de macOS con análisis opcional de visión de IA.
• camsnap - Captura fotogramas, clips o alertas de movimiento desde cámaras de seguridad RTSP/ONVIF.
• oracle - CLI de agente lista para OpenAI con reproducció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: sincroniza, busca, envía.
• 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 en terminal para buscar/poner en cola/controlar la reproducción.
• sag - Voz de ElevenLabs con UX de say al estilo 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 Google Gemini desde la terminal para preguntas y respuestas rápidas.
• agent-tools - Kit de utilidades para automatizaciones y scripts auxiliares.

# Notas de uso

• Prefiere la CLI openclaw para scripting; 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 Heartbeat activados para que el asistente pueda programar recordatorios, supervisar bandejas de entrada y activar capturas de cámara.
• La UI de Canvas se ejecuta a pantalla completa con superposiciones nativas. Evita colocar controles críticos en los bordes superior izquierdo/superior derecho/inferior; agrega márgenes explícitos en el diseño y no dependas de las inserciones de área segura.
• Para verificación basada en navegador, usa openclaw browser (pestañas/estado/captura de pantalla) 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 para máquinas).
• 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