Paquetes de Plugins

OpenClaw puede instalar plugins de tres ecosistemas externos: Codex, Claude y Cursor. Estos se denominan paquetes: conjuntos de contenido y metadatos que OpenClaw asigna a funciones nativas como Skills, hooks y herramientas MCP.

Por qué existen los paquetes

Muchos plugins útiles se publican en formato de Codex, Claude o Cursor. En lugar de exigir que sus autores los reescriban como plugins nativos de OpenClaw, OpenClaw detecta estos formatos y asigna el contenido compatible al conjunto de funciones nativas. Se puede instalar un paquete de comandos de Claude o un paquete de Skills de Codex y usarlo de inmediato.

Instalar un paquete

# Directorio localopenclaw plugins install ./my-bundle # Archivoopenclaw plugins install ./my-bundle.tgz # Marketplace de Claudeopenclaw plugins marketplace list <source>openclaw plugins install <plugin> --marketplace <source>

openclaw plugins listopenclaw plugins inspect <id>

openclaw gateway restart

Qué asigna OpenClaw desde los paquetes

Actualmente, no todas las funciones de los paquetes se ejecutan en OpenClaw. A continuación se indica qué funciona y qué se detecta, pero todavía no está conectado.

Compatibilidad actual

Contenido de Skills

• Las raíces de Skills del paquete se cargan como raíces de Skills normales de OpenClaw.
• Las raíces commands/ de Claude se tratan como raíces de Skills adicionales.
• Las raíces .cursor/commands/ de Cursor se tratan como raíces de Skills adicionales.

Tanto los archivos Markdown de comandos de Claude como los comandos Markdown de Cursor funcionan mediante el cargador normal de Skills de OpenClaw.

Paquetes de hooks

Las raíces de hooks del paquete funcionan solo cuando utilizan el diseño normal de paquetes de hooks de OpenClaw: HOOK.md más handler.ts o handler.js. Actualmente, este es principalmente el caso compatible con Codex.

MCP para OpenClaw integrado

• Los paquetes habilitados pueden aportar configuración de servidores MCP.
• OpenClaw combina la configuración MCP del paquete con los ajustes efectivos de OpenClaw integrado como mcpServers.
• OpenClaw expone las herramientas MCP compatibles del paquete durante los turnos del agente de OpenClaw integrado mediante el inicio de servidores stdio o la conexión a servidores HTTP.
• Los perfiles de herramientas coding y messaging incluyen de forma predeterminada las herramientas MCP del paquete; se puede usar tools.deny: ["bundle-mcp"] para excluirlas de un agente o Gateway.
• Los ajustes del agente integrado locales del proyecto siguen aplicándose después de los valores predeterminados del paquete, por lo que los ajustes del espacio de trabajo pueden anular las entradas MCP del paquete cuando sea necesario.
• Los catálogos de herramientas MCP del paquete se ordenan de forma determinista antes del registro, para que los cambios en el orden de listTools() en el origen no alteren continuamente los bloques de herramientas de la caché de prompts.

Transportes

Los servidores MCP pueden utilizar el transporte stdio o HTTP.

Stdio inicia un proceso secundario:

{  "mcp": {    "servers": {      "my-server": {        "command": "node",        "args": ["server.js"],        "env": { "PORT": "3000" }      }    }  }}

HTTP se conecta a un servidor MCP en ejecución y utiliza de forma predeterminada sse, salvo que se solicite streamable-http:

{  "mcp": {    "servers": {      "my-server": {        "url": "http://localhost:3100/mcp",        "transport": "streamable-http",        "headers": {          "Authorization": "Bearer ${MY_SECRET_TOKEN}"        },        "connectionTimeoutMs": 30000      }    }  }}

• transport acepta "streamable-http" o "sse"; si se omite, el valor predeterminado es sse.
• type: "http" es una estructura descendente nativa de la CLI; se debe usar transport: "streamable-http" en la configuración de OpenClaw. openclaw mcp set y openclaw doctor --fix normalizan el alias común.
• Solo se permiten los esquemas de URL http: y https:.
• Los valores headers admiten la interpolación de ${ENV_VAR}.
• Se rechaza una entrada de servidor que contenga tanto command como url.
• Las credenciales de URL (información de usuario y parámetros de consulta) se ocultan en las descripciones de las herramientas y los registros.
• connectionTimeoutMs anula el tiempo de espera de conexión predeterminado de 30 segundos para los transportes stdio y HTTP. El tiempo de espera de las solicitudes es de 60 segundos de forma predeterminada y se puede anular con requestTimeoutMs.

Nombres de herramientas

OpenClaw registra las herramientas MCP de los paquetes con nombres seguros para el proveedor con el formato serverName__toolName. Por ejemplo, un servidor con la clave "vigil-harbor" que expone una herramienta memory_search se registra como vigil-harbor__memory_search.

• Los caracteres que no pertenecen a A-Za-z0-9_- se sustituyen por -.
• Los fragmentos que comenzarían con un carácter que no sea una letra reciben un prefijo alfabético, por lo que las claves numéricas de servidores como 12306 se convierten en prefijos de herramientas seguros para el proveedor.
• Los prefijos de servidor están limitados a 30 caracteres.
• Los nombres completos de las herramientas están limitados a 64 caracteres.
• Los nombres de servidor vacíos utilizan mcp como alternativa.
• Los nombres saneados que colisionan se distinguen mediante sufijos numéricos.
• El orden final de las herramientas expuestas es determinista según el nombre seguro, lo que mantiene estables en caché los turnos repetidos del agente integrado.
• El filtrado de perfiles trata todas las herramientas de un servidor MCP del paquete como propiedad del plugin bundle-mcp, por lo que las listas de elementos permitidos o denegados del perfil pueden hacer referencia a los nombres individuales de las herramientas expuestas o a la clave de plugin bundle-mcp.

Ajustes de OpenClaw integrado

settings.json de Claude se importa como ajustes predeterminados de OpenClaw integrado cuando el paquete está habilitado. OpenClaw sanea las claves de anulación del shell antes de aplicarlas:

• shellPath
• shellCommandPrefix

LSP de OpenClaw integrado

• Los paquetes de Claude habilitados pueden aportar configuración de servidores LSP.
• OpenClaw carga .lsp.json junto con las rutas lspServers declaradas en el manifiesto.
• La configuración LSP del paquete se combina con los valores predeterminados efectivos de LSP de OpenClaw integrado.
• Actualmente, solo se pueden ejecutar los servidores LSP compatibles basados en stdio; los transportes no compatibles siguen apareciendo en openclaw plugins inspect <id>.

Detectado, pero no ejecutado

Estos elementos se reconocen y aparecen en los diagnósticos, pero OpenClaw no los ejecuta:

• agents de Claude, automatización hooks/hooks.json, outputStyles
• .cursor/agents, .cursor/hooks.json, .cursor/rules de Cursor
• Metadatos .app.json de Codex más allá de los informes de capacidades

Formatos de paquetes

Precedencia de detección

OpenClaw comprueba primero el formato de plugin nativo:

1. openclaw.plugin.json o un package.json válido con openclaw.extensions: se trata como un plugin nativo
2. Marcadores de paquete (.codex-plugin/, .claude-plugin/ o el diseño predeterminado de Claude/Cursor): se trata como un paquete

Si un directorio contiene ambos, OpenClaw utiliza la ruta nativa. Esto evita que los paquetes con formato dual se instalen parcialmente como paquetes.

Dependencias de tiempo de ejecución y limpieza

• Los paquetes compatibles de terceros no reciben la reparación de npm install al iniciarse. Deben instalarse mediante openclaw plugins install e incluir todo lo necesario en el directorio del plugin instalado.
• Los plugins incluidos propiedad de OpenClaw se distribuyen de forma ligera en el núcleo o se pueden descargar mediante el instalador de plugins. El inicio del Gateway nunca ejecuta un gestor de paquetes para ellos.
• openclaw doctor --fix elimina los registros obsoletos de instalaciones locales de plugins incluidos y puede recuperar plugins descargables que falten en el índice local de plugins cuando la configuración todavía haga referencia a ellos.

Seguridad

Los paquetes tienen un límite de confianza más restringido que los plugins nativos:

• OpenClaw no carga módulos arbitrarios de tiempo de ejecución de paquetes dentro del proceso.
• Las rutas de Skills y paquetes de hooks deben permanecer dentro de la raíz del plugin (se comprueban los límites).
• Los archivos de ajustes se leen con las mismas comprobaciones de límites.
• Los servidores MCP stdio compatibles pueden iniciarse como subprocesos.

Esto hace que los paquetes sean más seguros de forma predeterminada, pero aun así se deben tratar los paquetes de terceros como contenido de confianza para las funciones que exponen.

Solución de problemas

Temas relacionados

• Instalar y configurar plugins
• Creación de plugins - cree un plugin nativo
• Manifiesto de plugin - esquema del manifiesto nativo