Open-Claw

Proveedor: Open-Claw Nombre de instalación: open-claw Estado: Vista previa Configuración nativa: ~/.openclaw/openclaw.json

InstalaciónCopy Anchor Link

apothem install --harness open-claw

El adaptador escribe el archivo de configuración global de usuario de OpenClaw, proyecta el perfil compartido en un documento de perfil e instala las cohortes de soporte de Apothem bajo la raíz del entorno. La configuración nativa de OpenClaw es JSON; el materializador renderiza una clave, skills.load.extraDirs, y un archivo existente conserva sus demás claves.

Archivos escritos: ~/.openclaw/openclaw.json, el documento de perfil ~/.openclaw/apothem/rules/00-apothem-profile.md y archivos de soporte bajo ~/.openclaw/.apothem/support/

El documento de perfil termina con una sección de archivos de soporte de Apothem que nombra el directorio absoluto bajo ~/.openclaw/.apothem/support/ contra el que se resuelve cada cita con estilo de repositorio (rules/<name>.md, templates/..., hooks/...).

Asignación del perfil a la configuración nativaCopy Anchor Link

El adaptador redacta una clave de configuración. Añade ~/.openclaw/.apothem/support/skills a skills.load.extraDirs, la lista de directorios de skills adicionales que lee OpenClaw, que es como OpenClaw encuentra las skills instaladas. La entrada va después de las entradas que ya listes, y tus demás claves se quedan como están. La identidad, las preferencias y las reglas del perfil van al documento de perfil. Los comandos, las skills, las reglas, las plantillas y los prompts de hooks compartidos se instalan como material de soporte bajo ~/.openclaw/.apothem/support/.

Notas de compatibilidadCopy Anchor Link

Adaptador en vista previa. OpenClaw carga las skills de Apothem a través de skills.load.extraDirs, pero no carga por sí solo el resto del subárbol de soporte ni el documento de perfil: ninguno de sus archivos de instrucciones del espacio de trabajo ni su configuración apuntan allí. Por eso, tras la instalación, OpenClaw se ejecuta sin las reglas ni los servidores MCP de Apothem.

Conflictos de nombres. OpenClaw lee las skills desde estas fuentes, de mayor a menor precedencia, y cuando el mismo nombre de skill aparece en más de un lugar gana la fuente de mayor precedencia: la carpeta skills/ del espacio de trabajo, la carpeta .agents/skills/ del espacio de trabajo, ~/.agents/skills (solo con el directorio de estado predeterminado), la carpeta skills/ del directorio de estado (~/.openclaw/skills de forma predeterminada), las skills de workshop, las skills incluidas y de custodio, y por último las carpetas listadas bajo skills.load.extraDirs junto con las skills de plugins. El directorio de Apothem es una entrada de extraDirs, así que una skill del mismo nombre que conserves en cualquiera de las fuentes anteriores es la que usa OpenClaw, y la copia de Apothem de esa skill queda sin usar en el disco. Apothem solo escribe en openclaw.json y bajo ~/.openclaw/.apothem/support/, nunca en esas carpetas anteriores, así que la instalación, la actualización y la desinstalación no reemplazan una skill que conserves allí.

agents.defaults.skills es la lista de permitidos de nombres de skills; Apothem no la edita, así que si conservas una, comprueba que nombre las skills de Apothem que quieres. apothem update conserva las claves que agregas a openclaw.json. Los servidores MCP residen en el bloque mcp.servers de la configuración de OpenClaw, que gestionas con openclaw mcp add y los subcomandos relacionados; el adaptador no escribe ninguna entrada allí. (Comportamiento de OpenClaw según su documentación de skills, configuración de skills y extensiones de configuración, consultada el 2026-10-24, y su documentación de la CLI de MCP, consultada el 2026-10-02.)

Comentarios en openclaw.json. OpenClaw lee su configuración como JSON5, y Apothem reescribe el archivo como JSON plano. Cuando el archivo contiene comentarios u otra sintaxis JSON5 y falta la entrada, Apothem deja el archivo intacto y la instalación se detiene con un mensaje que nombra la clave. Fusiona tú mismo esta entrada en tu archivo, o convierte el archivo a JSON plano, y luego vuelve a ejecutar la instalación:

{
  "skills": {
    "load": {
      "extraDirs": ["~/.openclaw/.apothem/support/skills"]
    }
  }
}

Una entrada que añades tú mismo cuenta como tuya: la desinstalación la deja en su sitio.

VerificaciónCopy Anchor Link

apothem verify --harness open-claw

El comando verify confirma que:

1. La configuración nativa existe en la ruta esperada.
2. Cada destino gestionado existe; los archivos gestionados no están vacíos y las configuraciones JSON o YAML se analizan correctamente. Añade --profile PATH para confirmar también que los archivos instalados coinciden con ese perfil.
3. skills.load.extraDirs en la configuración nativa lista ~/.openclaw/.apothem/support/skills. Sin esa entrada, OpenClaw no carga las skills instaladas; apothem update la vuelve a añadir.
4. La rutina de verificación específica del adaptador informa de éxito.

ActualizaciónCopy Anchor Link

apothem update --harness open-claw

Vuelve a derivar el documento de perfil a partir del estado actual del perfil compartido y refresca los archivos de soporte; openclaw.json conserva las claves que ya tiene, y la entrada de Apothem en skills.load.extraDirs sigue listada una sola vez por muchas veces que actualices. Ejecútalo después de editar ~/.config/apothem/profile.yaml o de actualizar el paquete de Apothem instalado.

DesinstalaciónCopy Anchor Link

apothem uninstall --harness open-claw

Elimina lo que agregó el adaptador: su entrada en skills.load.extraDirs, el documento de perfil y el árbol de soporte. Tus propias claves en openclaw.json permanecen, incluidas tus propias entradas de extraDirs, y el archivo se elimina solo cuando Apothem lo creó y no queda nada tuyo. El YAML del perfil compartido y el motor de Apothem no se ven afectados.

Puerta de conformidadCopy Anchor Link

python -m apothem.conformity.gate --all .

Solución de problemasCopy Anchor Link

Opciones de configuraciónCopy Anchor Link

Véase tambiénCopy Anchor Link

• Todos los entornos — el catálogo completo de herramientas compatibles
• Guía de instalación — instala Apothem en este entorno
• Referencia de apothem harnesses — lista e inspecciona adaptadores desde la CLI