DEV Community

Victor Aguilar C.
Victor Aguilar C.

Posted on

1. OpenClaw en MacMini, Cuentas y Credenciales.

#agents #ai #spanish #tutorial

Resumen general

Esta guía te lleva desde una Mac Mini recién formateada hasta una instancia de OpenClaw totalmente operativa. Como la máquina estará dedicada exclusivamente a OpenClaw, optimizaremos cada paso para ese propósito.

Con qué terminarás: Un asistente personal de IA 24/7 corriendo localmente en tu Mac Mini, accesible vía Telegram, Discord, la UI de Control basada en navegador, o cualquier otra plataforma soportada (WhatsApp, iMessage, Slack, etc.). Puede navegar la web, ejecutar comandos de shell, gestionar archivos y extenderse con skills.

Estimación de tiempo: Un par de horas para la configuración completa.

Fase 0: Pre-Flight — Cuentas, claves y bots

Todo en esta fase ocurre en tu teléfono o computadora actual, no en la Mac Mini. Crea todas las cuentas, genera todas las API keys y guarda todos los tokens de bots antes de tocar la máquina.

Paso 0: Configura un gestor de contraseñas

Estás a punto de generar un montón de credenciales: contraseña del Apple ID, contraseña de Gmail, API key de Anthropic, API key de Brave Search, token del bot de Telegram, token del bot de Discord, gateway token, y más. Necesitas un único lugar seguro para guardarlas todas.

Si todavía no tienes un gestor de contraseñas, elige uno de estos y úsalo para cada credencial en esta guía:

  • Apple Keychain (gratis, integrado en macOS) — respaldado por hardware mediante el Secure Enclave en Apple Silicon. Las credenciales se cifran en el propio chip; ni siquiera Apple puede acceder a ellas. No requiere software extra. Tendrás acceso a esto una vez que la Mac Mini esté configurada en la Fase 1. Mientras tanto, usa Bitwarden o 1Password en tu teléfono para los pasos de pre-flight y luego transfiere las credenciales a Keychain cuando macOS esté funcionando.

  • Bitwarden (gratis) — open source, funciona en cualquier plataforma. Ideal si necesitas acceso multiplataforma desde dispositivos que no son Apple.

  • 1Password (~$3/mes) — UX ligeramente mejor, muy usado.

Crea tu cuenta (o abre Keychain) y ve guardando cada credencial conforme avances en esta guía.

No guardes credenciales en Apple Notes, en un archivo de texto, o “me lo voy a acordar”. No te vas a acordar de un token de bot de Telegram.

Paso 1: Crea un Apple ID dedicado (durante la configuración de la Mac Mini)

Necesitas un Apple ID para el Asistente de configuración de macOS, el App Store (para apps como Amphetamine) y servicios de iCloud.

Nota: Crear un Apple ID vía la web (appleid.apple.com) puede fallar si tu número de teléfono ya está asociado a otro Apple ID. Crearlo directamente en la Mac Mini durante el Setup Assistant normalmente evita este problema.

Crearás el Apple ID en la Fase 1 (Paso 3) cuando el Setup Assistant de la Mac Mini te lo pida. Ten listos estos datos:

  • Email: yourname@gmail.com (esto se convierte en tu login del Apple ID)
  • Contraseña: elige una contraseña fuerte y única (distinta a tu contraseña de Gmail) y guárdala inmediatamente en Bitwarden/1Password
  • Teléfono para 2FA: tu número principal
  • Nombre: tu nombre real

Este enfoque mantiene todo simple: un solo email (yourname@gmail.com) sirve como ancla de todo en la Mac Mini, incluyendo macOS, App Store, Google OAuth y las operaciones del sistema OpenClaw.

Paso 2: Prepara tu cuenta dedicada de Google/Gmail (infraestructura)

Esta cuenta se encarga de toda la “plomería” detrás de escena: Google OAuth para autenticación del LLM en OpenClaw, el email de recuperación del Apple ID y como la cuenta general de Google vinculada a esta máquina. Nadie más verá jamás esta dirección de email.

Usa un Gmail dedicado para esto: crea uno nuevo o reutiliza uno que ya tengas y no uses para nada más (p. ej., yourname@gmail.com).

Esta NO es la cuenta que usarás para mandar correos a personas. Este Gmail es estrictamente para operaciones internas de OpenClaw (OAuth, recuperación de cuenta, notificaciones del sistema). Los destinatarios de correos enviados por OpenClaw nunca verán esta dirección. Cuando estés listo para que OpenClaw envíe emails en tu nombre, crearás un correo separado, con apariencia más profesional, para ese propósito (ver Fase 10).

Importante para OpenClaw OAuth: Durante el onboarding de OpenClaw (Fase 4), cuando el asistente te pida autenticar con Google, usa yourname@gmail.com. Los tokens OAuth se guardarán localmente en la Mac Mini en ~/.openclaw/credentials/oauth.json.

Tip: Después de configurar el Apple ID, agrega yourname@gmail.com como email de recuperación del Apple ID para mantener todo enlazado dentro de tus cuentas dedicadas a OpenClaw.

Paso 3: Consigue tus API keys

El asistente de onboarding te pedirá estas credenciales. Consíguelas ahora para no estar corriendo a la mitad de la instalación. Puedes hacer todo esto desde tu teléfono.

Proveedor LLM (elige uno o más):

  • Anthropic API key (recomendado): Consigue una en

    https://console.anthropic.com

    El creador del proyecto recomienda Claude de Anthropic, específicamente Opus 4.6 para mejores resultados.

  • OpenAI API key: Consigue una en https://platform.openai.com si prefieres modelos de OpenAI.

  • Google OAuth: Cuando el asistente ofrezca Google como proveedor de autenticación, inicia sesión con yourname@gmail.com. Esto usa el flujo OAuth Antigravity de Google.

  • Si tienes una suscripción de Claude Code (Codex), puedes reutilizar esas credenciales vía claude setup-token.

Búsqueda web (recomendado — elige al menos una):

  • Brave Search API key (default de OpenClaw): Consigue una en https://brave.com/search/api/. Tiene tier gratis. Buena búsqueda web general. Esto es lo que espera el asistente de onboarding, así que empieza por aquí.

  • Perplexity API key (alternativa integrada): Consigue una en https://www.perplexity.ai/settings/api. Perplexity es un buscador con IA que devuelve respuestas sintetizadas con citas en lugar de links “en bruto”. Es un proveedor integrado en OpenClaw, así que puedes cambiar a él con un ajuste de configuración. Ver Apéndice D para detalles de configuración y una corrección importante de nombre de modelo.

  • Exa.ai API key (skill custom): Consigue una en https://exa.ai/. Exa es un motor de búsqueda neural que devuelve resultados de mayor calidad para consultas de investigación. A diferencia de Brave y Perplexity, Exa requiere configurar un skill custom en lugar de un simple cambio de config. El tier gratis incluye 1,000 búsquedas/mes. Ver Apéndice D para el walkthrough completo.

⚠️ Configura límites de gasto en CADA proveedor de API antes de empezar la instalación. No es opcional. Un agente mal configurado, un loop descontrolado, o incluso un “heartbeat” apuntando al modelo equivocado puede quemar créditos de API alarmantemente rápido. Ve a settings de billing en cada plataforma — Anthropic, OpenAI, Google, Brave, Exa, ElevenLabs — y fija un tope mensual con el que te sientas cómodo. Empieza conservador ($20–50/mes) y súbelo cuando entiendas tus patrones de uso. Siempre puedes aumentar límites después; no puedes “des-gastar” dinero.

Guarda cada key en tu gestor de contraseñas conforme la creas. En la mayoría de plataformas se muestran una sola vez. Si las pierdes, tendrás que generar nuevas.

Paso 4: Crea tu bot de Telegram

Haz esto en tu teléfono (donde Telegram ya está instalado):

  1. Abre Telegram y busca @botfather. Este es el bot oficial de Telegram para crear y administrar bots. Busca el check azul para confirmar que es el real.
  2. Toca Start (o escribe /start) para iniciar conversación con BotFather.
  3. Escribe /newbot y envíalo.
  4. BotFather preguntará: “Alright, a new bot. How are we going to call it?” — Este es el nombre para mostrar. Escribe el nombre que elijas para tu agente (p. ej., Atlas, Jarvis, Friday) y envíalo.
  5. BotFather preguntará: “Good. Now let’s choose a username for your bot.” — Este es el handle, debe ser único globalmente y terminar en “bot”. Prueba youragent_bot. Si está tomado, intenta variaciones como youragent_ai_bot, youragent_openclaw_bot, etc. Envía tu elección.
  6. BotFather responderá con un mensaje de éxito que incluye tu bot token. Se verá más o menos así: 7123456789:AAF1x2y3z4ABCDefghIJKlmnOPQrst-uvw Cópialo de inmediato y guárdalo en tu gestor de contraseñas. Es la única vez que lo verás sin resetearlo.

Opcional pero recomendado — define descripción y foto de perfil:

  • Escribe /setdescription, selecciona tu bot y pon algo como: “Mi asistente personal de IA impulsado por OpenClaw.”
  • Escribe /setuserpic, selecciona tu bot y sube una foto/imagen para el avatar.

Eso es todo. Tu bot de Telegram existe pero está “vacío” — no responderá hasta que OpenClaw se conecte a él durante el onboarding. El token es lo que pegarás en el asistente de onboarding.

Paso 5: Crea tu aplicación de bot de Discord

Haz esto en un navegador (en tu teléfono o en la Mac Mini):

  1. Ve al Discord Developer Portal: https://discord.com/developers/applications
  2. Inicia sesión con tu cuenta existente de Discord.
  3. Haz clic en “New Application” arriba a la derecha.
  4. Ponle nombre (usa el mismo que elegiste para Telegram) y haz clic en “Create”.
  5. Estás en la página de General Information. Anota el Application ID (puede servir más adelante para slash commands).
  6. En la barra lateral izquierda, haz clic en “Bot”.
  7. Debajo del username del bot, haz clic en “Reset Token” (o “Copy” si es tu primera vez). Copia el token inmediatamente y guárdalo en tu gestor de contraseñas. Igual que Telegram, esto se muestra una sola vez.
  8. Ajusta el display name del bot para que coincida con el nombre que elegiste para tu agente, si no coincide.
  9. En la misma página de Bot, baja a “Privileged Gateway Intents” y habilita:
    • Message Content Intent — Requerido. Sin esto, OpenClaw no puede leer mensajes.
    • Server Members Intent — Recomendado. Necesario para allowlists.
  10. Haz clic en “Save Changes”.

Tu aplicación de bot de Discord ya existe y tiene un token. Usarás ese token durante el onboarding. La configuración completa del servidor de Discord (invite URL, permisos y configuración de OpenClaw) ocurre después en la Fase 6 (Paso 18).

Checklist de Pre-Flight

Antes de tocar la Mac Mini, confirma que tienes todo esto guardado:

  • [ ] Gestor de contraseñas listo (Apple Keychain, Bitwarden o 1Password)
  • [ ] Detalles del Apple ID preparados (email, contraseña, número de teléfono)
  • [ ] yourname@gmail.com accesible con 2FA activado
  • [ ] Anthropic API key
  • [ ] OpenAI API key (opcional)
  • [ ] Brave Search API key
  • [ ] Token del bot de Telegram (de @botfather)
  • [ ] Token del bot de Discord (del Developer Portal)
  • [ ] Límites de gasto configurados en Anthropic y OpenAI

Si tienes todo esto, ya estás listo para iniciar la configuración de la Mac Mini. A partir de aquí, todo ocurre en la máquina.

Esta es una Traducción del Post Original

Top comments (0)