Gestionar plugins

La interfaz de control abarca el flujo de trabajo habitual de descubrimiento, instalación, activación y desactivación. La CLI añade actualización, desinstalación, configuración avanzada y controles explícitos de la fuente de instalación. Para consultar el contrato completo de comandos, las opciones, las reglas de selección de fuentes y los casos extremos, véase openclaw plugins.

Flujo de trabajo típico de la CLI: buscar un paquete, instalarlo desde ClawHub, npm, git o una ruta local, permitir que el Gateway administrado se reinicie automáticamente (o reiniciarlo manualmente) y, a continuación, verificar los registros del entorno de ejecución del plugin.

Usar la interfaz de control

Abra Plugins en la interfaz de control o use /settings/plugins en relación con la ruta base configurada de la interfaz de control. Por ejemplo, una ruta base /openclaw usa /openclaw/settings/plugins. La página tiene dos pestañas:

• Instalados muestra el inventario local completo agrupado por categoría (canales, proveedores de modelos, memoria y herramientas). Cada fila abre una vista de detalles; su menú de desbordamiento (…) activa o desactiva el plugin y, en el caso de los plugins instalados externamente, ofrece Eliminar. La pestaña también muestra los servidores MCP configurados con las mismas acciones de activación, desactivación y eliminación mediante menús, que modifican mcp.servers en la configuración del Gateway.
• Descubrir es la tienda: plugins destacados incluidos con OpenClaw, plugins externos oficiales y una selección de conectores. Las tarjetas de conectores añaden un servidor MCP alojado con un solo clic (GitHub, Notion, Linear, Sentry, Home Assistant) o abren una búsqueda de ClawHub previamente rellenada. Al escribir en el cuadro de búsqueda, se consulta ClawHub en la propia página y se añade una sección Desde ClawHub con recuentos de descargas e insignias de verificación de la fuente.

Los plugins incluidos no necesitan la instalación de un paquete. La acción de su menú es Activar o Desactivar. Workboard, por ejemplo, está incluido con OpenClaw y desactivado de forma predeterminada, por lo que debe seleccionarse Activar para habilitarlo. Los plugins integrados no se pueden eliminar, solo desactivar.

El acceso al catálogo y a la búsqueda requiere operator.read. Los cambios de instalación, activación, desactivación, eliminación y servidores MCP requieren operator.admin. El Gateway realiza las instalaciones desde ClawHub y mantiene sus comprobaciones de confianza, integridad y políticas de instalación de plugins. Cuando un administrador activa un plugin instalado, también registra esa confianza explícita añadiendo el plugin seleccionado a una lista restrictiva existente plugins.allow. Una entrada explícita plugins.deny sigue teniendo prioridad y debe eliminarse antes de activar el plugin.

La instalación o eliminación del código de un plugin requiere reiniciar el Gateway. Los cambios de activación pueden aplicarse sin reiniciar cuando el plugin instalado y el entorno de ejecución actual del Gateway lo permiten; de lo contrario, la interfaz indica que se requiere un reinicio. Los conectores MCP respaldados por OAuth siguen necesitando una ejecución única de openclaw mcp login <name> desde la CLI después de añadirlos.

La interfaz de control no permite instalar desde fuentes arbitrarias de npm, git o rutas locales, actualizar plugins ni acceder a una configuración avanzada de plugins. Use los siguientes flujos de trabajo de la CLI para esas operaciones.

Mostrar y buscar plugins

openclaw plugins listopenclaw plugins list --enabledopenclaw plugins list --verboseopenclaw plugins list --jsonopenclaw plugins search "calendar"

--json para scripts:

openclaw plugins list --json \  | jq '.plugins[] | {id, enabled, format, source, dependencyStatus}'

plugins list es una comprobación del inventario en frío: muestra lo que OpenClaw puede detectar mediante la configuración, los manifiestos y el registro persistente de plugins. No demuestra que un Gateway ya en ejecución haya importado el entorno de ejecución del plugin. La salida JSON incluye diagnósticos del registro y el dependencyStatus de cada plugin (si los dependencies/optionalDependencies declarados se resuelven en el disco).

plugins search consulta ClawHub en busca de paquetes de plugins instalables e imprime una sugerencia de instalación (openclaw plugins install clawhub:<package>) para cada resultado.

Activar y desactivar plugins

openclaw plugins enable <plugin-id>openclaw plugins disable <plugin-id>

Alterna la entrada de configuración de un plugin sin modificar los archivos instalados. Algunos plugins integrados (proveedores integrados de modelos o voz y el plugin integrado del navegador) están activados de forma predeterminada; otros requieren enable después de la instalación.

Instalar plugins

# Buscar paquetes de plugins en ClawHub.openclaw plugins search "calendar" # Instalar desde ClawHub.openclaw plugins install clawhub:<package>openclaw plugins install clawhub:<package>@1.2.3openclaw plugins install clawhub:<package>@beta # Instalar desde npm.openclaw plugins install npm:<package>openclaw plugins install npm:@scope/openclaw-plugin@1.2.3openclaw plugins install npm:@openclaw/codex # Instalar desde un artefacto local de npm pack.openclaw plugins install npm-pack:<path.tgz> # Instalar desde git o una copia de desarrollo local.openclaw plugins install git:github.com/acme/openclaw-plugin@v1.0.0openclaw plugins install ./my-pluginopenclaw plugins install --link ./my-plugin

Las especificaciones de paquetes sin prefijo se instalan desde npm durante la transición de lanzamiento, salvo que el nombre coincida con el identificador de un plugin integrado u oficial; en ese caso, OpenClaw usa esa copia local u oficial. Use clawhub:, npm:, git: o npm-pack: para seleccionar la fuente de forma determinista. Los paquetes integrados y oficiales del catálogo de OpenClaw se consideran de confianza junto con los paquetes de ClawHub. Las fuentes nuevas y arbitrarias de npm, git, rutas o archivos locales, npm-pack: o mercados requieren --force en las instalaciones no interactivas después de revisar la fuente y determinar que es de confianza.

--force confirma una fuente que no sea ClawHub sin solicitar confirmación y sobrescribe un destino de instalación existente cuando es necesario. Para las actualizaciones habituales de una instalación registrada de npm, ClawHub o hook-pack, use openclaw plugins update. Con --link, --force solo confirma la fuente; el directorio enlazado no se copia ni se sobrescribe.

Si un plugin recién instalado requiere una configuración que aún no existe, OpenClaw registra la instalación, pero deja el plugin desactivado. Configure plugins.entries.<id>.config y, a continuación, ejecute openclaw plugins enable <id>. Si existe una entrada de configuración, pero no es válida, la instalación falla sin reescribirla.

Reiniciar e inspeccionar

Un Gateway administrado en ejecución que tenga habilitada la recarga de la configuración se reinicia automáticamente después de instalar, actualizar o desinstalar el código de un plugin. Si el Gateway no está administrado o la recarga está desactivada, reinícielo manualmente antes de comprobar las superficies activas del entorno de ejecución:

openclaw gateway restartopenclaw plugins inspect <plugin-id> --runtime --json

inspect --runtime carga el módulo del plugin y demuestra que ha registrado superficies del entorno de ejecución (herramientas, hooks, servicios, métodos del Gateway, rutas HTTP y comandos de la CLI propiedad del plugin). inspect y list sin más opciones solo realizan comprobaciones en frío del manifiesto, la configuración y el registro.

Actualizar plugins

openclaw plugins update <plugin-id>openclaw plugins update <npm-package-or-spec>openclaw plugins update --allopenclaw plugins update <plugin-id> --dry-run

Al proporcionar el identificador de un plugin, se reutiliza su especificación de instalación registrada: las etiquetas de distribución almacenadas (@beta) y las versiones exactas fijadas se conservan en las ejecuciones posteriores de update <plugin-id>.

openclaw plugins update --all es la ruta de mantenimiento masivo. Sigue respetando las especificaciones de instalación registradas habituales, pero los registros de plugins oficiales de confianza de OpenClaw se sincronizan con el destino actual del catálogo oficial en vez de permanecer fijados a un paquete oficial exacto y obsoleto; cuando update.channel es beta, esa sincronización prefiere la línea de versiones beta. Use una ejecución dirigida de update <plugin-id> para mantener intacta una especificación oficial exacta o etiquetada.

En las instalaciones desde npm, proporcione una especificación explícita del paquete para cambiar el registro:

openclaw plugins update @scope/openclaw-plugin@betaopenclaw plugins update @scope/openclaw-plugin

El segundo comando devuelve un plugin a la línea de versiones predeterminada del registro cuando anteriormente estaba fijado a una versión exacta o una etiqueta.

Consulte openclaw plugins para conocer las reglas exactas de alternativa y fijación de versiones.

Desinstalar plugins

openclaw plugins uninstall <plugin-id> --dry-runopenclaw plugins uninstall <plugin-id>openclaw plugins uninstall <plugin-id> --keep-files

La desinstalación elimina la entrada de configuración del plugin, el registro persistente del índice de plugins, las entradas de las listas de permisos y denegaciones y las entradas enlazadas de plugins.load.paths cuando corresponda. El directorio de instalación administrado se elimina salvo que se proporcione --keep-files. Un Gateway administrado en ejecución se reinicia automáticamente cuando la desinstalación cambia la fuente del plugin.

En el modo Nix (OPENCLAW_NIX_MODE=1), la instalación, actualización, desinstalación, activación y desactivación de plugins están deshabilitadas; gestione esas opciones en la fuente Nix de la instalación.

Elegir una fuente

Las instalaciones administradas desde rutas locales deben ser directorios o archivos de plugins. Coloque los archivos de plugins independientes en plugins.load.paths en lugar de instalarlos con plugins install.

Publicar plugins

ClawHub es la principal superficie pública de descubrimiento de plugins de OpenClaw. Publique allí cuando desee que los usuarios encuentren los metadatos del plugin, el historial de versiones, los resultados del análisis del registro y las sugerencias de instalación antes de instalarlo.

npm i -g clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/your-plugin@v1.0.0

Los plugins nativos de npm deben incluir un manifiesto del plugin (openclaw.plugin.json) y metadatos package.json antes de publicarse:

{  "name": "@acme/openclaw-plugin",  "version": "1.0.0",  "type": "module",  "openclaw": {    "extensions": ["./dist/index.js"]  }}

npm publish --access publicopenclaw plugins install npm:@acme/openclaw-pluginopenclaw plugins install npm:@acme/openclaw-plugin@betaopenclaw plugins install npm:@acme/openclaw-plugin@1.0.0

Use estas páginas para consultar el contrato completo de publicación en lugar de considerar esta página como la referencia de publicación:

• Publicación en ClawHub explica los propietarios, los ámbitos, las versiones, la revisión, la validación de paquetes y la transferencia de paquetes.
• Creación de plugins muestra la estructura completa de los paquetes de plugins (incluido openclaw.plugin.json) y el flujo de trabajo de la primera publicación.
• Manifiesto del plugin define los campos del manifiesto nativo de un plugin.

Si el mismo paquete está disponible tanto en ClawHub como en npm, use el prefijo explícito clawhub: o npm: para forzar una fuente.

Contenido relacionado

• Plugins - instalar, configurar, reiniciar y solucionar problemas
• openclaw plugins - referencia completa de la CLI
• Plugins de la comunidad - descubrimiento público y publicación en ClawHub
• ClawHub - operaciones de la CLI del registro
• Creación de plugins - crear un paquete de plugin
• Manifiesto de plugin - manifiesto y metadatos del paquete