Guía de Configuración OpenClaw
Dale a Ami la capacidad de controlar tu escritorio — notas, recordatorios, calendario, música y más.
Requisitos Previos
macOS es necesario para las herramientas de Apple Notes, Recordatorios, Calendario y Música (usan osascript internamente).
Node.js 22+ — verifica con node --version
Si no tienes Node 22+:
brew install node@22Instalar OpenClaw
Ejecuta el script de instalación en tu terminal:
curl -fsSL https://openclaw.ai/install.sh | bashEsto instalará la CLI e iniciará el asistente de configuración automáticamente.
Verificar la instalación
openclaw doctoropenclaw no se encuentra, agrégalo a tu PATH:
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrcIniciar el Gateway
El asistente de configuración instala un daemon en segundo plano que inicia el gateway automáticamente. Para verificar si está ejecutándose:
openclaw gateway statusSi necesitas iniciarlo manualmente:
openclaw gateway --port 18789Encuentra tu token de gateway
Tu token está en ~/.openclaw/openclaw.json bajo gateway.auth.token. Puedes verlo con:
cat ~/.openclaw/openclaw.json | grep '"token"' | head -1Conectar Ami a OpenClaw
- Abre la app de Ami y ve a Configuración (icono de engranaje)
- Desplázate hasta la sección Avanzado
- Expande Gateway OpenClaw
- Completa los campos:
| Campo | Valor |
|---|---|
| URL del Gateway | ws://127.0.0.1:18789 |
| Token del Gateway | (pega el token del Paso 2) |
5. Activa Enrutar chat web a través de OpenClaw
6. Haz clic en Guardar
Opciones adicionales
| Opción | Qué hace |
|---|---|
| Sincronizar identidad | Envía el nombre y personalidad de Ami al gateway para que otros canales (WhatsApp, Discord) usen el mismo personaje |
| Obtener memorias | Importa memorias del espacio de trabajo del agente a la app al cargar el personaje |
| Enviar memorias | Auto-sincroniza memorias de la app al espacio de trabajo del agente cada 10 minutos |
Configurar el Espacio de Trabajo del Agente
OpenClaw usa una carpeta de espacio de trabajo para dar al agente su personalidad e instrucciones de herramientas. El espacio de trabajo predeterminado está en ~/.openclaw/workspace-ami/
Debe contener dos archivos:
SOUL.md — Personalidad
Este archivo se auto-sincroniza desde la app cuando "Sincronizar identidad" está habilitado. Define quién es Ami y cómo responde. También puedes editarlo manualmente:
~/.openclaw/workspace-ami/SOUL.mdTOOLS.md — Instrucciones de Herramientas
Esta es la guía de Ami para usar macOS herramientas. Ya debería estar configurado, pero si necesitas recrearlo:
~/.openclaw/workspace-ami/TOOLS.mdEl archivo contiene osascript comandos para cada herramienta.
Herramientas Disponibles
Una vez conectado, puedes pedirle a Ami que haga cualquiera de estas:
Apple Notes
“Escríbeme una nota sobre ideas para compras”
“Guarda una nota titulada Planes del Fin de Semana”
Recordatorios
“Recuérdame llamar al dentista a las 3pm”
“Pon un recordatorio para regar las plantas mañana”
Calendario
“¿Qué tengo en mi agenda hoy?”
“Agrega una reunión con Jake el viernes a las 2pm”
Música
“Pon algo de música”
“Pausa la música”
“Pasa a la siguiente canción”
“¿Qué está sonando ahora?”
Controles del Sistema
“Activa el modo oscuro”
“Pon un temporizador de 5 minutos”
“¿Cuál es mi nivel de batería?”
Abrir Apps y URLs
“Abre Safari”
“Abre el sitio web twitter.com”
Solución de Problemas
Actualizar OpenClaw
npm update -g openclawO vuelve a ejecutar el instalador:
curl -fsSL https://openclaw.ai/install.sh | bashArquitectura
Para los curiosos — así es como Ami se comunica con tu escritorio:
┌──────────────┐ WebSocket ┌──────────────────┐ osascript ┌──────────────┐
│ Ami App │ ──────────────────► │ OpenClaw Gateway │ ────────────────► │ macOS APIs │
│ (browser) │ ◄────────────────── │ (localhost) │ ◄──────────────── │ Notes, Music │
│ │ SSE streaming │ Port 18789 │ tool results │ Calendar etc │
└──────────────┘ └──────────────────┘ └──────────────┘
│
┌──────┴──────┐
│ Workspace │
│ SOUL.md │
│ TOOLS.md │
└─────────────┘1. Envías un mensaje a Ami en el navegador
2. La app detecta si es una solicitud de herramienta y muestra una tarjeta de vista previa inmediatamente
3. El mensaje se enruta a través del gateway OpenClaw vía WebSocket
4. El agente del gateway lee TOOLS.md, ejecuta el comando osascript apropiado
5. El agente responde con confirmación, que Ami te habla de vuelta
¿Listo para empezar?
Instala OpenClaw, conecta Ami y comienza a controlar tu escritorio con lenguaje natural.
Abrir App