Administrar plugins

La mayoría de los flujos de trabajo de plugins son unos pocos comandos: buscar, instalar, reiniciar el Gateway, verificar y desinstalar cuando ya no necesites el plugin.

Listar plugins

OmeniaClaw plugins listOmeniaClaw plugins list --enabledOmeniaClaw plugins list --verboseOmeniaClaw plugins list --json

Usa --json para scripts. Incluye diagnósticos del registro y el dependencyStatus estático de cada plugin cuando el paquete del plugin declara dependencies u optionalDependencies.

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

plugins list es una comprobación de inventario en frío. Muestra lo que OmeniaClaw puede descubrir a partir de la configuración, los manifiestos y el registro de plugins; no demuestra que un proceso Gateway ya en ejecución haya importado el runtime del plugin.

Instalar plugins

# Search ClawHub for plugin packages.OmeniaClaw plugins search "calendar" # Bare package specs try ClawHub first, then npm fallback.OmeniaClaw plugins install <package> # Force one source.OmeniaClaw plugins install clawhub:<package>OmeniaClaw plugins install npm:<package> # Install a specific version or dist-tag.OmeniaClaw plugins install clawhub:<package>@1.2.3OmeniaClaw plugins install clawhub:<package>@betaOmeniaClaw plugins install npm:@scope/[email protected]OmeniaClaw plugins install npm:@OmeniaClaw/codex # Install from git or a local development checkout.OmeniaClaw plugins install git:github.com/acme/[email protected]OmeniaClaw plugins install ./my-pluginOmeniaClaw plugins install --link ./my-plugin

Después de instalar el código del plugin, reinicia el Gateway que sirve tus canales:

OmeniaClaw gateway restartOmeniaClaw plugins inspect <plugin-id> --runtime --json

Usa inspect --runtime cuando necesites una prueba de que el plugin registró superficies de runtime como herramientas, hooks, servicios, métodos de Gateway o comandos de CLI propiedad del plugin.

Actualizar plugins

OmeniaClaw plugins update <plugin-id>OmeniaClaw plugins update <npm-package-or-spec>OmeniaClaw plugins update --all

Si un plugin se instaló desde un dist-tag de npm como @beta, las llamadas posteriores a update <plugin-id> reutilizan esa etiqueta registrada. Pasar una especificación npm explícita cambia la instalación rastreada a esa especificación para futuras actualizaciones.

OmeniaClaw plugins update @scope/OmeniaClaw-plugin@betaOmeniaClaw plugins update @scope/OmeniaClaw-plugin

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

Cuando OmeniaClaw update se ejecuta en el canal beta, los registros de plugins de npm y ClawHub en la línea predeterminada intentan primero la versión @beta del plugin correspondiente. Si esa versión beta no existe, OmeniaClaw vuelve a la especificación predeterminada/latest registrada. Para plugins de npm, OmeniaClaw también vuelve atrás cuando el paquete beta existe pero no supera la validación de instalación. Las versiones exactas y las etiquetas explícitas como @rc o @beta se conservan.

Desinstalar plugins

OmeniaClaw plugins uninstall <plugin-id> --dry-runOmeniaClaw plugins uninstall <plugin-id>OmeniaClaw plugins uninstall <plugin-id> --keep-filesOmeniaClaw gateway restart

La desinstalación elimina la entrada de configuración del plugin, el registro del índice de plugins, las entradas de listas de permitidos/denegados y las rutas de carga enlazadas cuando corresponde. Los directorios de instalación gestionados se eliminan salvo que pases --keep-files.

En modo Nix (OmeniaClaw_NIX_MODE=1), los comandos para instalar, actualizar, desinstalar, habilitar y deshabilitar plugins están desactivados. Gestiona esas opciones en la fuente de Nix de la instalación; para nix-OmeniaClaw, usa el Inicio rápido centrado en agentes.

Publicar plugins

Puedes publicar plugins externos en ClawHub, npmjs.com o ambos.

Publicar en ClawHub

ClawHub es la superficie pública principal de descubrimiento para plugins de OmeniaClaw. Ofrece a los usuarios metadatos buscables, historial de versiones y resultados de escaneo del registro antes de la instalación.

npm i -g clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/[email protected]

Los usuarios instalan desde ClawHub con:

OmeniaClaw plugins install clawhub:<package>OmeniaClaw plugins install <package>

La forma sin prefijo sigue comprobando ClawHub primero.

Publicar en npmjs.com

Los plugins npm nativos deben incluir un manifiesto de plugin y metadatos de punto de entrada de OmeniaClaw en package.json.

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

npm publish --access public

Los usuarios instalan solo desde npm con:

OmeniaClaw plugins install npm:@acme/OmeniaClaw-pluginOmeniaClaw plugins install npm:@acme/OmeniaClaw-plugin@betaOmeniaClaw plugins install npm:@acme/[email protected]

Si el mismo paquete también está disponible en ClawHub, npm: omite la búsqueda en ClawHub y fuerza la resolución mediante npm.

Elección de fuente

• ClawHub: úsalo cuando quieras descubrimiento nativo de OmeniaClaw, resúmenes de escaneo, versiones y sugerencias de instalación.
• npmjs.com: úsalo cuando ya distribuyas paquetes JavaScript o necesites flujos de trabajo de dist-tags/registro privado de npm.
• Git: úsalo cuando quieras instalar directamente desde una rama, etiqueta o commit.
• Ruta local: úsala cuando estés desarrollando o probando un plugin en la misma máquina.

Relacionado

• Plugins - resumen y solución de problemas
• OmeniaClaw plugins - referencia completa de la CLI
• ClawHub - publicación y operaciones del registro
• Crear plugins - crear un paquete de plugin
• Manifiesto de plugin - manifiesto y metadatos de paquete