Archivos del workspace

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

IDENTITY.md

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

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

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

SOUL.md

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

Secciones

| Seccion | Descripcion | |---------|-------------| | Quien eres | Definicion de la identidad del bot | | Como hablas | Reglas de estilo (sin emojis, tono casual, espanol, etc.) | | Reglas | Que puede y que no puede hacer | | Como funciona | Flujo de verificacion de vinculacion 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 anade un parametro t con el timestamp actual a cada peticion 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 mas.

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

TOOLS.md

Referencia rapida de los endpoints. Le da al modelo una forma directa de saber donde esta 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 periodicas. Jaleo no tiene ninguna — solo responde cuando le escriben:

# Sin tareas periodicas. Solo musica.

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

MEMORY.md

Memoria persistente que OpenClaw genera automaticamente. Contiene informacion sobre los grupos vinculados y otros datos que el bot recuerda entre conversaciones.

OpenClaw gestiona este archivo automaticamente. 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"
}

Personalizacion

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

• Quieres que hable en ingles? 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

Despues de cualquier cambio, reinicia OpenClaw:

pm2 restart openclaw