Skip to main content
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

--json para scripts:
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

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

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:
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

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:
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

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.
Los plugins nativos de npm deben incluir un manifiesto del plugin (openclaw.plugin.json) y metadatos package.json antes de publicarse:
package.json
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