Gestiona plugins en OpenClaw: comandos y configuración

¿Alguna vez has sentido que gestionar extensiones y plugins se vuelve un caos total? Entre diferentes formatos, dependencias y versiones, es fácil perder el hilo de lo que tienes instalado en tu sistema.

openclaw plugins está diseñado para que tomes el control de tu Gateway de forma directa. Con esta herramienta puedes gestionar plugins nativos, paquetes de hooks y bundles compatibles sin complicaciones, manteniendo tu entorno limpio y funcional.

`openclaw plugins`

Gestiona plugins/extensiones del Gateway, paquetes de hooks y bundles compatibles.

Relacionado:

Sistema de plugins: Plugins
Compatibilidad de bundles: Plugin bundles
Manifiesto y esquema de plugins: Plugin manifest
Refuerzo de seguridad: Security

Comandos

openclaw plugins list
openclaw plugins install <path-or-spec>
openclaw plugins inspect <id>
openclaw plugins enable <id>
openclaw plugins disable <id>
openclaw plugins uninstall <id>
openclaw plugins doctor
openclaw plugins update <id>
openclaw plugins update --all
openclaw plugins marketplace list <marketplace>

Los plugins integrados se distribuyen con OpenClaw pero vienen desactivados por defecto. Usa plugins enable para activarlos.

Los plugins nativos de OpenClaw deben incluir un archivo openclaw.plugin.json con un JSON Schema en línea (configSchema, aunque esté vacío). Los bundles compatibles utilizan sus propios manifiestos de bundle en su lugar.

plugins list muestra Format: openclaw o Format: bundle. La salida detallada de la lista o la información también muestra el subtipo de bundle (codex, claude o cursor) y las capacidades detectadas del bundle.

Instalar

openclaw plugins install <package>                      # ClawHub first, then npm
openclaw plugins install clawhub:<package>              # ClawHub only
openclaw plugins install <package> --pin                # pin version
openclaw plugins install <package> --dangerously-force-unsafe-install
openclaw plugins install <path>                         # local path
openclaw plugins install <plugin>@<marketplace>         # marketplace
openclaw plugins install <plugin> --marketplace <name>  # marketplace (explicit)

Los nombres de paquetes simples se buscan primero en ClawHub y luego en npm. Nota de seguridad: trata las instalaciones de plugins como si ejecutaras código. Es preferible usar versiones fijas (pinned).

--dangerously-force-unsafe-install es una opción de emergencia para falsos positivos en el escáner de código peligroso integrado. Permite que la instalación continúe incluso cuando el escáner informa hallazgos de nivel critical, pero no ignora los bloqueos de políticas de hooks before_install ni los fallos de escaneo.

Esta flag de la CLI se aplica a openclaw plugins install. Las instalaciones de dependencias de skills respaldadas por el Gateway usan el override de solicitud dangerouslyForceUnsafeInstall correspondiente, mientras que openclaw skills install sigue siendo un flujo separado de descarga e instalación de skills de ClawHub.

plugins install es también la interfaz de instalación para paquetes de hooks que exponen openclaw.hooks en el package.json. Usa openclaw hooks para ver la visibilidad filtrada de hooks y la activación por hook, no para la instalación del paquete.

Las especificaciones de npm son solo para el registro (nombre del paquete + versión exacta opcional o dist-tag). Se rechazan las especificaciones de Git/URL/archivo y los rangos de semver. Las instalaciones de dependencias se ejecutan con --ignore-scripts por seguridad.

Las especificaciones simples y @latest se mantienen en la rama estable. Si npm resuelve cualquiera de ellas a una versión prerelease, OpenClaw se detendrá y te pedirá que aceptes explícitamente mediante un tag de prerelease como @beta / @rc o una versión de prerelease exacta como @1.2.3-beta.4.

Si una especificación de instalación simple coincide con un id de plugin integrado (por ejemplo, diffs), OpenClaw instala el plugin integrado directamente. Para instalar un paquete de npm con el mismo nombre, usa una especificación con scope explícito (por ejemplo, @scope/diffs).

Archivos soportados: .zip, .tgz, .tar.gz, .tar.

También se admiten instalaciones desde el marketplace de Claude.

Las instalaciones de ClawHub usan un localizador explícito clawhub:<package>:

openclaw plugins install clawhub:openclaw-codex-app-server
openclaw plugins install clawhub:openclaw-codex-app-server@1.2.3

OpenClaw ahora también prefiere ClawHub para especificaciones de plugins simples que sean seguras para npm. Solo recurre a npm si ClawHub no tiene ese paquete o versión:

openclaw plugins install openclaw-codex-app-server

OpenClaw descarga el archivo del paquete desde ClawHub, verifica la API del plugin anunciada y la compatibilidad mínima del Gateway, y luego lo instala a través de la ruta normal de archivos. Las instalaciones registradas conservan sus metadatos de origen de ClawHub para futuras actualizaciones.

Usa la abreviatura plugin@marketplace cuando el nombre del marketplace exista en la caché del registro local de Claude en ~/.claude/plugins/known_marketplaces.json:

openclaw plugins marketplace list <marketplace-name>
openclaw plugins install <plugin-name>@<marketplace-name>

Usa --marketplace cuando quieras pasar la fuente del marketplace de forma explícita:

openclaw plugins install <plugin-name> --marketplace <marketplace-name>
openclaw plugins install <plugin-name> --marketplace <owner/repo>
openclaw plugins install <plugin-name> --marketplace ./my-marketplace

Las fuentes del marketplace pueden ser:

Un nombre de marketplace conocido de Claude en ~/.claude/plugins/known_marketplaces.json
Una raíz de marketplace local o una ruta a marketplace.json
Una abreviatura de repositorio de GitHub como owner/repo
Una URL de git

Para marketplaces remotos cargados desde GitHub o git, las entradas del plugin deben permanecer dentro del repositorio del marketplace clonado. OpenClaw acepta fuentes de rutas relativas de ese repositorio y rechaza fuentes de plugins externas de git, GitHub, URL/archivo y rutas absolutas de manifiestos remotos.

Para rutas locales y archivos, OpenClaw detecta automáticamente:

Plugins nativos de OpenClaw (openclaw.plugin.json)
Bundles compatibles con Codex (.codex-plugin/plugin.json)
Bundles compatibles con Claude (.claude-plugin/plugin.json o el diseño de componentes por defecto de Claude)
Bundles compatibles con Cursor (.cursor-plugin/plugin.json)

Los bundles compatibles se instalan en la raíz normal de extensiones y participan en el mismo flujo de listado, información y activación/desactivación. Actualmente, se soportan skills de bundle, skills de comando de Claude, valores por defecto de settings.json de Claude, skills de comando de Cursor y directorios de hooks compatibles con Codex; otras capacidades de bundle detectadas se muestran en diagnósticos o información, pero aún no están conectadas a la ejecución en tiempo de ejecución.

Usa --link para evitar copiar un directorio local (se añade a plugins.load.paths):

openclaw plugins install -l ./my-plugin

Usa --pin en instalaciones de npm para guardar la especificación exacta resuelta (nombre@version) en plugins.installs, manteniendo el comportamiento por defecto sin fijar.

Desinstalar

openclaw plugins uninstall <id>
openclaw plugins uninstall <id> --dry-run
openclaw plugins uninstall <id> --keep-files

uninstall elimina los registros del plugin de plugins.entries, plugins.installs, la lista de permitidos de plugins y las entradas vinculadas en plugins.load.paths cuando corresponda. Para los plugins de memoria activos, el slot de memoria se restablece a memory-core.

Por defecto, la desinstalación también elimina el directorio de instalación del plugin bajo la raíz de plugins del directorio de estado activo. Usa --keep-files para mantener los archivos en el disco.

--keep-config se admite como un alias obsoleto de --keep-files.

Actualizar

openclaw plugins update <id-or-npm-spec>
openclaw plugins update --all
openclaw plugins update <id-or-npm-spec> --dry-run
openclaw plugins update @openclaw/voice-call@beta

Las actualizaciones se aplican a las instalaciones rastreadas en plugins.installs y a las instalaciones de paquetes de hooks rastreadas en hooks.internal.installs.

Cuando pasas un id de plugin, OpenClaw reutiliza la especificación de instalación registrada para ese plugin. Esto significa que los dist-tags almacenados previamente, como @beta, y las versiones exactas fijadas se seguirán utilizando en las ejecuciones posteriores de update <id>.

Para instalaciones de npm, también puedes pasar una especificación de paquete de npm explícita con un dist-tag o versión exacta. OpenClaw resuelve ese nombre de paquete con el registro del plugin rastreado, actualiza ese plugin instalado y registra la nueva especificación de npm para futuras actualizaciones basadas en el id.

Cuando existe un hash de integridad almacenado y el hash del artefacto obtenido cambia, OpenClaw muestra una advertencia y solicita confirmación antes de continuar. Usa la flag global --yes para omitir las confirmaciones en entornos de CI o ejecuciones no interactivas.

Inspeccionar

openclaw plugins inspect <id>
openclaw plugins inspect <id> --json

Introspección profunda para un solo plugin. Muestra identidad, estado de carga, origen, capacidades registradas, hooks, herramientas, comandos, servicios, métodos de gateway, rutas HTTP, flags de política, diagnósticos y metadatos de instalación.

Cada plugin se clasifica según lo que registra realmente en tiempo de ejecución:

plain-capability: un tipo de capacidad (por ejemplo, un plugin solo de proveedor).
hybrid-capability: múltiples tipos de capacidades (por ejemplo, texto + voz + imágenes).
hook-only: solo hooks, sin capacidades ni superficies.
non-capability: herramientas, comandos o servicios, pero sin capacidades.

Consulta Plugin shapes para saber más sobre el modelo de capacidades.

La flag --json genera un informe legible por máquina adecuado para scripts y auditorías.

info es un alias de inspect.

Pasos siguientes

AI Setup Assistant

OpenClaw Expert

Sigues atascado?

Si esta pagina no resolvio tu caso, pregunta a OpenClaw Expert para pasos concretos.