Aplicación complementaria OpenClaw macOS: Guía de la barra de menús

Introducción

Si bien OpenClaw se ejecuta principalmente como una herramienta de línea de comandos que se conecta a aplicaciones de chat, los usuarios de macOS tienen acceso a una poderosa aplicación complementaria que se encuentra en su barra de menú. Esta aplicación nativa de macOS brinda acceso rápido a OpenClaw, notificaciones de escritorio y una integración perfecta con el sistema de su Mac.

La aplicación complementaria complementa la versión CLI y le ofrece lo mejor de ambos mundos: integración de la aplicación de chat más la comodidad nativa de macOS. Esta guía cubre todo lo que necesita saber sobre la instalación, configuración y uso de la aplicación complementaria OpenClaw macOS.

¿Qué es la aplicación complementaria?

La aplicación complementaria OpenClaw macOS es una aplicación nativa que:

• Vive en tu barra de menú: acceso rápido sin abrir una terminal
• Proporciona notificaciones de escritorio: recibe alertas de mensajes importantes
• Ofrece una interfaz de consulta rápida: haga preguntas sin abrir aplicaciones de chat
• Se integra con macOS: funciona con servicios y accesos directos del sistema
• Complementa CLI: funciona junto con la versión de línea de comandos

Piense en ello como un complemento de escritorio para su instancia de OpenClaw basada en chat, que proporciona integración nativa de macOS y funciones convenientes.

Instalación

Método 1: Descarga directa

1. Visite la página de lanzamientos de OpenClaw
2. Descargue el archivo .dmg más reciente para macOS
3. Abra el archivo .dmg descargado.
4. Arrastre OpenClaw a su carpeta de Aplicaciones
5. Inicie desde Aplicaciones o Spotlight

Método 2: Barril casero

brew install --cask openclaw

Método 3: compilar desde la fuente

Si desea la última versión de desarrollo:

git clone https://github.com/openclaw/openclaw.git
cd openclaw/companion-app
npm install
npm run build
npm run dist

Configuración del primer lanzamiento

Cuando inicia por primera vez la aplicación complementaria:

Paso 1: Conéctese a su instancia OpenClaw

La aplicación debe conectarse a su instancia CLI de OpenClaw en ejecución:

1. Inicie OpenClaw CLI: asegúrese de que su instancia de CLI se esté ejecutando
2. Ingrese el punto final de API: el valor predeterminado es http://localhost:3000
3. Verificar conexión: la aplicación probará la conexión

Paso 2: Configurar preferencias

Acceda a las preferencias a través del icono de la barra de menú:

• General — Comportamiento de inicio, notificaciones
• Apariencia — Tema, estilo de icono
• Avanzado: puntos finales API, depuración

Paso 3: Conceder permisos

La aplicación puede solicitar:

• Accesibilidad — Para la integración del sistema
• Notificaciones: para alertas de escritorio
• Acceso total al disco: para operaciones con archivos (si es necesario)

Concédelos en Configuración del sistema > Privacidad y seguridad.

Funciones de la barra de menú

Menú de acceso rápido

Haga clic en el icono de la barra de menú para acceder:

• Consulta rápida: haga preguntas directamente
• Conversaciones recientes: ver el historial de chat
• Habilidades: accede a las habilidades instaladas
• Configuración: configurar preferencias
• Estado: comprobar el estado de la conexión

Indicadores de estado

El icono de la barra de menú muestra:

• Verde: conectado y listo
• Amarillo: conectado pero con advertencias
• Rojo — Desconectado o error
• Gris — Iniciando

Atajos de teclado

Configurar atajos globales:

• Cmd+Shift+C — Abrir consulta rápida
• Cmd+Shift+A — Asistente de alternancia
• Cmd+Shift+S — Mostrar estado

Interfaz de consulta rápida

La función de consulta rápida de la aplicación complementaria te permite interactuar con OpenClaw sin abrir WhatsApp, Telegram o Discord.

Abrir consulta rápida

1. Haga clic en el icono de la barra de menú
2. Seleccione “Consulta rápida” o utilice el método abreviado de teclado
3. Escribe tu pregunta
4. Presione Enter para enviar

Casos de uso

Información rápida:

• “¿Qué hay en mi calendario hoy?”
• “Revisar mi correo electrónico para mensajes urgentes”
• “¿Qué tiempo hace?”

Acciones rápidas:

• “Agregar tarea: Revisar propuesta de proyecto”
• “Establecer recordatorio: llama a Sarah a las 3 p. m.”
• “Verificar el estado de relaciones públicas de GitHub”Consultas del sistema:
• “¿Qué archivos modifiqué hoy?”
• “Muéstrame comandos de terminal recientes”
• “¿Cuál es el estado de mi sistema?”

Notificaciones de escritorio

La aplicación complementaria puede enviar notificaciones de escritorio para:

Alertas de mensajes

Reciba una notificación cuando OpenClaw reciba mensajes sobre:

• WhatsApp
• Telegram
• Discord
• Otras plataformas conectadas

Recordatorios de tareas

Configure recordatorios que activen notificaciones de escritorio:

• Eventos del calendario
• Plazos de tarea
• Recordatorios personalizados

Eventos del sistema

Notificaciones para:

• Cambios de estado de OpenClaw
• Resultados de ejecución de habilidades.
• Alertas de errores
• Actualizar notificaciones

Configurar notificaciones

1. Abrir Preferencias
2. Vaya a la sección de Notificaciones
3. Activar/desactivar tipos de notificaciones
4. Personaliza los sonidos de notificación
5. Establecer el horario de No molestar

Integración con CLI

La aplicación complementaria funciona junto con su instancia CLI:

Configuración compartida

Ambos usan lo mismo:

• Puntos finales API
• Autenticación
• Habilidades e integraciones.
• Memoria y contexto

Funciones complementarias

CLI proporciona:

• Puentes de aplicaciones de chat
• Acceso completo a la línea de comandos
• Capacidades del servidor
• Configuración avanzada

La aplicación complementaria proporciona:

• Integración nativa de macOS
• Notificaciones de escritorio
• Interfaz de acceso rápido
• Servicios del sistema

Ejecutando ambos juntos

Puedes ejecutar ambos simultáneamente:

1. Inicie la instancia CLI: npm start
2. Inicie la aplicación complementaria
3. Ambos se conectan al mismo backend
4. Utilice la interfaz que le resulte más conveniente

Funciones avanzadas

Integración de servicios del sistema

La aplicación complementaria se puede integrar con los servicios de macOS:

Selección de texto:

1. Selecciona texto en cualquier aplicación.
2. Haga clic derecho → Servicios → “Preguntar a OpenClaw”
3. Obtenga respuesta de IA en la notificación

Operaciones de archivos:

1. Seleccionar archivos en Finder
2. Haga clic derecho → Servicios → “Analizar con OpenClaw”
3. Obtener análisis de archivos

Integración de Spotlight

Busque comandos de OpenClaw a través de Spotlight:

• Escribe “OpenClaw” para abrir la aplicación
• Busque “Preguntar a OpenClaw” para activar la consulta.
• Acceso rápido a conversaciones recientes.

Integración de aplicaciones de accesos directos

Cree automatizaciones en accesos directos de macOS:

1. Abra la aplicación Atajos
2. Crea un nuevo acceso directo
3. Agregue la acción “Ejecutar script de Shell”
4. Llame a los puntos finales de la API de OpenClaw
5. Activar desde Siri o widgets

Personalización

Apariencia

Personaliza el aspecto de la aplicación:

• Estilo de icono: elige entre los iconos disponibles
• Tema: claro, oscuro o automático
• Estilo de menú: compacto o ampliado

Comportamiento

Configurar el comportamiento de la aplicación:

• Iniciar al iniciar sesión — Iniciar automáticamente
• Ocultar cuando esté inactivo: minimizar el icono de la barra de menú
• Comportamiento de salida: sigue ejecutando o sal con la aplicación

Configuración avanzada

Opciones de usuario avanzado:

• Punto final de API personalizado: apunta a una instancia remota
• Modo de depuración: habilita el registro detallado
• Configuración de proxy: configurar el proxy de red
• Canal de actualización: versiones beta o estables

Solución de problemas

La aplicación no se conecta

Problema: La aplicación complementaria no se puede conectar a CLI

Soluciones:

1. Verifique que CLI se esté ejecutando: ps aux | grep openclaw
2. Verifique que el punto final de la API coincida con el puerto CLI
3. Verifique que el firewall no esté bloqueando localhost
4. Verifique los registros de CLI en busca de errores

Las notificaciones no funcionan

Problema: Las notificaciones de escritorio no aparecen

Soluciones:

1. Verifique la configuración de notificaciones de macOS
2. Verifique que la aplicación tenga permiso de notificación
3. Verifique el estado de No molestar
4. Reinicia la aplicación

Falta el icono de la barra de menú

Problema: El icono no aparece en la barra de menú

Soluciones:

1. Compruebe si el icono está oculto (macOS puede ocultar iconos)
2. Restablecer barra de menú: killall SystemUIServer
3. Reinstale la aplicación
4. Verifique la compatibilidad con macOS

Problemas de rendimiento

Problema: La aplicación es lenta o no respondeSoluciones:

1. Verifique los recursos del sistema
2. Reducir la frecuencia de las notificaciones
3. Borrar caché de la aplicación
4. Reinicia la aplicación

Mejores prácticas

Flujo de trabajo diario

1. Iniciar CLI: ejecute OpenClaw CLI al iniciar
2. Iniciar Companion: mantenga la aplicación complementaria en funcionamiento
3. Usar consulta rápida: para preguntas rápidas
4. Utilice aplicaciones de chat: para conversaciones más largas
5. Monitorizar notificaciones: manténgase informado

Gestión de recursos

• Monitorear el uso de la memoria
• Cerrar la aplicación complementaria si no es necesaria
• Utilice el modo solo CLI para servidores
• Optimizar la configuración de notificaciones

Seguridad

• Mantener la aplicación actualizada
• Utilice puntos finales API seguros
• No exponer la API públicamente
• Revisar los permisos de notificación.

Comparación: aplicación complementaria frente a CLI

Cuándo utilizar la aplicación complementaria

• Consultas rápidas de escritorio
• Notificaciones de escritorio
• Integración del sistema macOS
• Monitoreo visual del estado

Cuándo utilizar CLI únicamente

• Implementaciones de servidores
• Configuraciones sin cabeza
• Configuración avanzada
• Sistemas con recursos limitados

Usando ambos

Lo mejor de ambos mundos:

• CLI para funcionalidad principal
• Aplicación complementaria para mayor comodidad
• Backend y configuración compartidos
• Métodos de acceso flexibles

Mejoras futuras

La aplicación complementaria continúa evolucionando con características como:

• Soporte de widgets para macOS
• Integración de Siri
• Más servicios del sistema.
• Notificaciones mejoradas
• Mejor rendimiento

Conclusión

La aplicación complementaria OpenClaw macOS proporciona integración de escritorio nativa que complementa perfectamente la versión CLI. Ya sea que desee consultas rápidas, notificaciones de escritorio o integración del sistema, la aplicación complementaria mejora su experiencia OpenClaw en macOS.

Instálelo junto con su instancia CLI para obtener la mejor experiencia. Utilice consultas rápidas para preguntas rápidas, confíe en las notificaciones para alertas importantes y disfrute de una integración perfecta con macOS.

Para obtener más información, consulte nuestra guía de instalación y configuración específica de macOS. Si tiene preguntas, visite nuestras Preguntas frecuentes o explore otros tutoriales.