Paquetes de Plugins

​

Por qué existen los paquetes

​

Instalar un paquete

# Directorio local
openclaw plugins install ./my-bundle

# Archivo
openclaw plugins install ./my-bundle.tgz

# Marketplace de Claude
openclaw plugins marketplace list <source>
openclaw plugins install <plugin> --marketplace <source>

openclaw plugins list
openclaw plugins inspect <id>

openclaw gateway restart

​

Qué asigna OpenClaw desde los paquetes

​

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.

​

Paquetes de hooks

​

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

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

{
  "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

• 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

• 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

• 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

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

​

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

• 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.

​

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