◑ applying · kind experiment · level 3 · 0h
¿Qué es y por qué importa.
Experimento exitoso para unificar la gestión de versiones de Node.js bajo el gestor asdf en lugar de mezclar instalaciones de Homebrew (/opt/homebrew) con entornos locales heredados (~/.hermes). Esto reduce fricción al cambiar entre proyectos o herramientas que requieren versiones específicas, y elimina dependencias rotas del sistema global.
Mecanismo.
- Diagnóstico: Identificar divergencia en
PATHdonde~//.local/bin/nodeapuntaba a una instalación heredada (~/.hermes) mientras que el Gateway de servicio usaba Homebrew (/opt/homebrew/bin/node). - Limpieza quirúrgica: Eliminar symlink duplicado:
rm ~/.local/bin/openclaw. No borrar la copia física inmediatamente, sino dejarla como backup temporal hasta confirmar funcionamiento del shim de asdf. - Corrección del Servicio (LaunchAgent): Editar archivo plist
/Library/LaunchAgents/ai.openclaw.gateway.plistpara reemplazar explícitamente el argumentoProgramArguments[3]: cambiar ruta absoluta a Homebrew por la ruta instalada vía asdf (~/.asdf/installs/nodejs/[VERSION]/bin/node). - Validación: Reiniciar servicio con
openclaw gateway restart. Verificar que logs del proceso muestren el ejecutor de Node gestionado por asdf y no Homebrew.
Límite.
- Requiere permisos para editar archivos plist (generalmente requiere reinicio o sudo si los atributos son restrictivos).
- Si OpenClaw actualiza su instalación global (
gateway install --force), podría regenerar el LaunchAgent con la ruta antigua de Node, anulando cambios manuales en el plist. Se recomienda verificar periódicamenteopenclaw gateway status.
Ejercicio.
Revisión semanal del comando: openclaw gateway status --deep | grep "Command:". Si aparece /opt/homebrew/bin/node, ejecutar nuevamente la corrección manual o reiniciar servicio tras actualización de OpenClaw.