Archivos del workspace

El workspace de OpenClaw se encuentra en ~/.openclaw/workspace/ y está compuesto por archivos Markdown que definen el comportamiento del bot.

IDENTITY.md

Define el nombre y la descripción del bot. Es lo primero que OpenClaw lee para saber quien es.

# Jaleo
DJ de Spotify para grupos de WhatsApp.
Emoji: 🎧

Campo	descripción
Nombre	Jaleo - El nombre que usa el bot en las conversaciones
descripción	DJ de Spotify para grupos de WhatsApp - Breve resumen
Emoji	🎧 - Se usa como avatar o identificador visual

SOUL.md

El archivo más importante. Define la personalidad, las reglas, el tono de voz y las instrucciones de como funciona el webhook.

secciónes

sección	descripción
Quien eres	Definicion de la identidad del bot
Como hablas	Reglas de estilo (sin emojis, tono casual, español, etc.)
Reglas	Que puede y que no puede hacer
Como funciona	Flujo de verificación de vinculación y llamada al webhook
acciones	Lista de acciones del webhook con formato de query

Las URLs

Todas las URLs en SOUL.md deben contener tu dominio real:

URL base: https://tudominio.com/webhook?action=ACCION&query=QUERY&groupId=GROUP_ID&t=TIMESTAMP

El parametro t=TIMESTAMP

OpenClaw añade un parametro t con el timestamp actual a cada petición para evitar que el navegador o el CDN cacheen las respuestas. El webhook lo ignora, pero es importante incluirlo.

AGENTS.md

Define las restricciones del agente. Este archivo limita que herramientas puede usar el bot:

## Herramienta
Usa solo webfetch. NO uses sessions_spawn, bash, write, read, ni nada más.

Esto es crucial porque previene que el modelo de IA ejecute comandos en el servidor, lea archivos o haga cosas que no debería. El bot solo puede hacer peticiones HTTP al webhook.

TOOLS.md

Referencia rápida de los endpoints. Le da al modelo una forma directa de saber donde está la API sin tener que buscar en SOUL.md:

## Jaleo API
- Webhook: https://tudominio.com/webhook
- Login: https://tudominio.com/login?groupId=GROUP_ID
- Backend: /root/jaleo-api/ (PM2: jaleo-api, puerto 8888)

HEARTBEAT.md

Define tareas periódicas. Jaleo no tiene ninguna — solo responde cuando le escriben:

# Sin tareas periódicas. Solo música.

Si quisieras que el bot enviara un mensaje a las 8am cada dia, por ejemplo, lo configurarias aquí.

MEMORY.md

Memoria persistente que OpenClaw genera automáticamente. Contiene información sobre los grupos vinculados y otros datos que el bot recuerda entre conversaciones.

OpenClaw gestióna este archivo automáticamente. No lo edites manualmente.

Skill: jaleo-spotify/

Las skills son modulos que le dicen al modelo cuando y como actuar. La skill de Jaleo se encuentra en:

~/.openclaw/workspace/skills/jaleo-spotify/
  SKILL.md      # Instrucciones de la skill
  skill.json    # Metadatos (nombre, version, estado)

SKILL.md

Contiene las instrucciones simplificadas de la skill:

---
name: jaleo-spotify
description: Control Spotify playback via webhook. Use for music requests.
---

Usa webfetch GET:
https://tudominio.com/webhook?action=ACCION&query=QUERY&groupId=GROUP_ID&t=TIMESTAMP

acciones: play, queue, volume, skip, pause, resume, now_playing
Si USUARIO_NO_VINCULADO -> manda https://tudominio.com/login?groupId=GROUP_ID

skill.json

{
  "name": "jaleo-spotify",
  "description": "Control de Spotify mediante Jaleo-API Webhook.",
  "version": "1.0.0",
  "author": "Ferran",
  "entrypoint": "SKILL.md",
  "status": "ready"
}

personalización

Puedes modificar cualquiera de estos archivos para cambiar el comportamiento del bot:

• Quieres que hable en inglés? Cambia el SOUL.md
• Quieres que use emojis? Quita la regla “Sin emojis” del SOUL.md
• Quieres que responda preguntas generales? Quita las restricciones en AGENTS.md
• Quieres cambiar el nombre? Edita IDENTITY.md

después de cualquier cambio, reinicia OpenClaw:

pm2 restart openclaw