Habilidades de Clawdbot

Extiende el asistente de IA Clawdbot con habilidades. Aprende a crear, instalar y gestionar habilidades para tu asistente de IA personal.

Descripción general de las habilidades de Clawdbot

Clawdbot utiliza carpetas de habilidades compatibles con AgentSkills para enseñar al agente cómo usar las herramientas. Cada habilidad es un directorio que contiene un SKILL.md con frontmatter YAML e instrucciones.

Clawdbot carga las habilidades incluidas más las anulaciones locales opcionales, y las filtra en tiempo de carga según el entorno, la configuración y la presencia de binarios.

Ubicaciones de habilidades y precedencia

Las habilidades se cargan desde tres lugares:

UbicaciónDescripción
Habilidades incluidasEnviadas con la instalación (paquete npm o Clawdbot.app)
Habilidades gestionadas/locales~/.clawdbot/skills
Habilidades del espacio de trabajo<workspace>/skills

Precedencia (de mayor a menor):

  1. <workspace>/skills
  2. ~/.clawdbot/skills
  3. Habilidades incluidas

Puedes configurar carpetas de habilidades adicionales mediante skills.load.extraDirs en ~/.clawdbot/clawdbot.json.

Habilidades por agente vs compartidas

En configuraciones multi-agente:

  • Habilidades por agente: Ubicadas en <workspace>/skills solo para ese agente
  • Habilidades compartidas: Ubicadas en ~/.clawdbot/skills y visibles para todos los agentes

ClawHub (Instalar + Sincronizar)

ClawHub es el registro público de habilidades para Clawdbot. Navega en https://clawhub.com.

Flujos comunes:

# Instalar una habilidad en tu espacio de trabajo
clawhub install <skill-slug>

# Actualizar todas las habilidades instaladas
clawhub update --all

# Sincronizar (escanear + publicar actualizaciones)
clawhub sync --all

Por defecto, clawhub instala en ./skills bajo tu directorio de trabajo actual.

Formato de habilidad

SKILL.md debe incluir al menos:

---
name: my-skill
description: What this skill does
---

Instructions for the agent...

Claves opcionales de frontmatter

ClaveDescripción
homepageURL mostrada como "Sitio web" en la UI de habilidades
user-invocabletrue|false (por defecto: true) - Exponer como comando de barra para el usuario
disable-model-invocationtrue|false (por defecto: false) - Excluir del prompt del modelo
command-dispatchtool - Omitir el modelo y despachar directamente a una herramienta
command-toolNombre de la herramienta a invocar cuando command-dispatch: tool

Gating (filtros en tiempo de carga)

Filtra habilidades en tiempo de carga usando metadatos:

---
name: my-skill
description: My skill description
metadata: {"openclaw": {"requires": {"bins": ["uv"], "env": ["API_KEY"], "config": ["browser.enabled"]}}}
---

Campos de gating

CampoDescripción
always: trueSiempre incluir la habilidad
requires.binsBinarios requeridos
requires.envVariables de entorno requeridas
requires.configClaves de configuración requeridas
primaryEnvVariable de entorno principal para la habilidad

Anulaciones de configuración

Anula la configuración de habilidades en ~/.clawdbot/clawdbot.json:

{
  "skills": {
    "entries": {
      "my-skill": {
        "enabled": true,
        "env": {
          "API_KEY": "your-key"
        }
      }
    }
  }
}

Notas de seguridad

  • Trata las habilidades de terceros como código no confiable
  • Lee las habilidades antes de habilitarlas
  • Prefiere ejecuciones en sandbox para entradas no confiables
  • Mantén los secretos fuera de los prompts y logs

Plugins + Habilidades

Los plugins pueden enviar sus propias habilidades listando directorios de habilidades en clawdbot.plugin.json. Las habilidades del plugin se cargan cuando el plugin está habilitado.

Observador de habilidades (actualización automática)

Clawdbot observa los directorios de habilidades en busca de cambios y se actualiza automáticamente cuando se agregan, modifican o eliminan habilidades.

Próximos pasos