openclaw plugins.
Flujo de trabajo típico: busca un paquete, instálalo desde ClawHub, npm, git o una
ruta local, deja que el Gateway administrado se reinicie automáticamente (o reinícialo manualmente),
y luego verifica los registros de runtime del plugin.
Listar y buscar plugins
--json para scripts:
plugins list es una comprobación de inventario en frío: lo que OpenClaw puede descubrir a partir de
la configuración, los manifiestos y el registro persistido de plugins. No demuestra que un
Gateway ya en ejecución haya importado el runtime del plugin. La salida JSON incluye
diagnósticos del registro y el dependencyStatus de cada plugin (si las
dependencies/optionalDependencies declaradas se resuelven en disco).
plugins search consulta ClawHub para buscar paquetes de plugins instalables e imprime
una sugerencia de instalación (openclaw plugins install clawhub:<package>) por cada resultado.
Habilitar y deshabilitar plugins
enable después de la instalación.
Instalar plugins
clawhub:, npm:, git: o
npm-pack: para una selección de origen determinista.
Usa --force solo para sobrescribir un destino de instalación existente desde un origen
diferente. Para actualizaciones rutinarias de una instalación rastreada de npm, ClawHub o hook-pack,
usa openclaw plugins update en su lugar; --force no es compatible con
--link.
Reiniciar e inspeccionar
Un Gateway administrado en ejecución con recarga de configuración habilitada se reinicia automáticamente después de instalar, actualizar o desinstalar código de plugin. Si el Gateway no está administrado o la recarga está deshabilitada, reinícialo tú mismo antes de comprobar las superficies de runtime en vivo:inspect --runtime carga el módulo del plugin y demuestra que registró superficies
de runtime (herramientas, hooks, servicios, métodos de Gateway, rutas HTTP, comandos
CLI propiedad del plugin). inspect y list simples son solo comprobaciones en frío de manifiesto/configuración/registro.
Actualizar plugins
@beta) y las versiones exactas fijadas se conservan en ejecuciones posteriores de
update <plugin-id>.
openclaw plugins update --all es la ruta de mantenimiento masivo. Sigue
respetando las especificaciones ordinarias de instalación rastreada, pero los registros de plugins oficiales
de OpenClaw de confianza se sincronizan con el destino actual del catálogo oficial en lugar de
quedarse fijados a un paquete oficial exacto obsoleto; cuando update.channel es
beta, esa sincronización prefiere la línea de lanzamiento beta. Usa un
update <plugin-id> dirigido para mantener intacta una especificación oficial exacta o etiquetada.
Para instalaciones de npm, pasa una especificación de paquete explícita para cambiar el registro
rastreado:
openclaw plugins para ver las reglas exactas de fallback y
fijación.
Desinstalar plugins
plugins.load.paths cuando
corresponda. El directorio de instalación administrado se elimina salvo que pases
--keep-files. Un Gateway administrado en ejecución se reinicia automáticamente cuando la
desinstalación cambia el origen del plugin.
En modo Nix (OPENCLAW_NIX_MODE=1), la instalación, actualización, desinstalación,
habilitación y deshabilitación de plugins están todas deshabilitadas; administra esas opciones en el origen Nix
de la instalación en su lugar.
Elegir un origen
| Origen | Úsalo cuando | Ejemplo |
|---|---|---|
| ClawHub | Quieres descubrimiento nativo de OpenClaw, resúmenes de análisis, versiones y sugerencias | openclaw plugins install clawhub:<package> |
| git | Quieres una rama, etiqueta o commit de un repositorio | openclaw plugins install git:github.com/<owner>/<repo>@<ref> |
| ruta local | Estás desarrollando o probando un plugin en la misma máquina | openclaw plugins install --link ./my-plugin |
| marketplace | Estás instalando un plugin de marketplace compatible con Claude | openclaw plugins install <plugin> --marketplace <source> |
| npm pack | Estás validando un artefacto de paquete local mediante la semántica de instalación de npm | openclaw plugins install npm-pack:<path.tgz> |
| npmjs.com | Ya publicas paquetes JavaScript o necesitas dist-tags/registro privado de npm | openclaw plugins install npm:@acme/openclaw-plugin |
plugins.load.paths en lugar de instalarlos
con plugins install.
Publicar plugins
ClawHub es la superficie principal de descubrimiento público para plugins de OpenClaw. Publica allí cuando quieras que los usuarios encuentren metadatos de plugins, historial de versiones, resultados de análisis del registro y sugerencias de instalación antes de instalar.openclaw.plugin.json) además de
metadatos de package.json antes de publicar:
package.json
- Publicación en ClawHub explica propietarios, scopes, lanzamientos, revisión, validación de paquetes y transferencia de paquetes.
- Crear plugins muestra la forma completa del paquete de plugin
(incluido
openclaw.plugin.json) y el primer flujo de publicación. - Manifiesto de plugin define los campos del manifiesto de plugin nativo.
clawhub: o npm: para forzar un origen.
Relacionado
- Plugins - instalar, configurar, reiniciar y solucionar problemas
openclaw plugins- referencia completa de CLI- Plugins de la comunidad - descubrimiento público y publicación en ClawHub
- ClawHub - operaciones de CLI del registro
- Crear plugins - crear un paquete de plugin
- Manifiesto de plugin - manifiesto y metadatos de paquete