Preguntas frecuentes: configuración inicial

Use un agente de IA local que pueda ver su equipo. La mayoría de los casos de «estoy atascado» son problemas de configuración local o del entorno que un asistente remoto no puede inspeccionar, por lo que esto resulta más eficaz que preguntar en Discord.

• Claude Code: https://www.anthropic.com/claude-code/
• OpenAI Codex: https://openai.com/codex/

Proporcione al agente el repositorio completo del código fuente mediante la instalación modificable (git), para que pueda leer el código y la documentación, y razonar sobre la versión exacta que ejecuta:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Pida al agente que planifique y supervise la corrección paso a paso y, después, que ejecute únicamente los comandos necesarios; los cambios más pequeños son más fáciles de auditar.

Comparta estas salidas cuando solicite ayuda (en Discord o en una incidencia de GitHub):

¿Ha encontrado un error real o una corrección? Abra una incidencia o envíe una PR: Incidencias / Solicitudes de incorporación de cambios.

Ciclo rápido de depuración: Primeros 60 segundos si algo no funciona. Documentación de instalación: Instalación, Opciones del instalador, Actualización.

En el modo de tareas, las marcas de tiempo programadas solo avanzan después de que finalice una ejecución real de Heartbeat. Las ejecuciones omitidas no marcan las tareas como completadas.

Documentación: Heartbeat, Automatización.

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bashopenclaw onboard --install-daemon

Desde el código fuente (colaboradores/desarrollo):

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm buildpnpm ui:buildopenclaw onboard

¿Todavía no hay una instalación global? Ejecute pnpm openclaw onboard en su lugar. Si faltan los recursos de la interfaz de control, la incorporación intenta compilarlos por sí misma y, si no puede, recurre a pnpm ui:build.

La incorporación abre el navegador en una URL limpia del panel (sin token) justo después de la configuración e imprime el enlace en el resumen. Mantenga abierta esa pestaña; si no se abrió, copie y pegue la URL impresa en el mismo equipo.

Localhost (mismo equipo):

• Abra http://127.0.0.1:18789/.
• Si solicita autenticación mediante secreto compartido, pegue el token o la contraseña configurados en los ajustes de la interfaz de control.
• Origen del token: gateway.auth.token (o OPENCLAW_GATEWAY_TOKEN).
• Origen de la contraseña: gateway.auth.password (o OPENCLAW_GATEWAY_PASSWORD).
• ¿Todavía no hay ningún secreto compartido configurado? Ejecute openclaw doctor --generate-gateway-token (o openclaw doctor --fix --generate-gateway-token).

Fuera de localhost:

• Tailscale Serve (recomendado): mantenga la vinculación al bucle invertido, ejecute openclaw gateway --tailscale serve y abra https://<magicdns>/. Con gateway.auth.allowTailscale: true, los encabezados de identidad satisfacen la autenticación de la interfaz de control/WebSocket (sin pegar un secreto compartido; se presupone un host de Gateway de confianza); las API HTTP siguen necesitando autenticación mediante secreto compartido, salvo que se utilice deliberadamente la entrada privada none o la autenticación HTTP mediante proxy de confianza. Los intentos simultáneos de Serve con autenticación incorrecta procedentes del mismo cliente se serializan antes de que el limitador de autenticaciones fallidas los registre, por lo que un segundo reintento incorrecto ya puede mostrar retry later.
• Vinculación a la tailnet: ejecute openclaw gateway --bind tailnet --token "<token>" (o configure la autenticación mediante contraseña), abra http://<tailscale-ip>:18789/ y pegue el secreto compartido correspondiente en los ajustes del panel.
• Proxy inverso con reconocimiento de identidad: mantenga el Gateway detrás de un proxy de confianza, configure gateway.auth.mode: "trusted-proxy" y abra la URL del proxy. Los proxies de bucle invertido del mismo host necesitan gateway.auth.trustedProxy.allowLoopback: true explícito.
• Túnel SSH: ssh -N -L 18789:127.0.0.1:18789 user@gateway-host; después, abra http://127.0.0.1:18789/. La autenticación mediante secreto compartido sigue aplicándose a través del túnel; pegue el token o la contraseña configurados si se solicitan.

Consulte Panel y Superficies web para obtener detalles sobre los modos de vinculación y la autenticación.

Controlan capas diferentes:

• approvals.exec: reenvía las solicitudes de aprobación a destinos de chat.
• channels.<channel>.execApprovals: convierte ese canal en un cliente de aprobación nativo para las aprobaciones de exec.

La política de exec del host sigue siendo la verdadera barrera de aprobación; la configuración del chat solo controla dónde aparecen las solicitudes y cómo responden las personas.

Rara vez se necesitan ambas:

• Si el chat ya admite comandos y respuestas, /approve en el mismo chat funciona mediante la ruta compartida.
• Cuando un canal nativo compatible puede deducir de forma segura quiénes pueden aprobar, OpenClaw activa automáticamente las aprobaciones nativas que priorizan los mensajes directos si channels.<channel>.execApprovals.enabled no está definido o es "auto".
• Cuando hay disponibles tarjetas o botones de aprobación nativos, esa interfaz es la principal; solo mencione un comando manual /approve si el resultado de la herramienta indica que las aprobaciones por chat no están disponibles.
• Use approvals.exec únicamente cuando las solicitudes también deban llegar a otros chats o salas de operaciones explícitas.
• Use channels.<channel>.execApprovals.target: "channel" o "both" únicamente cuando quiera que las solicitudes de aprobación se publiquen de nuevo en la sala o el tema de origen.
• Las aprobaciones de plugins son independientes: /approve en el mismo chat de forma predeterminada, reenvío opcional mediante approvals.plugin y solo algunos canales nativos mantienen también el procesamiento nativo para ellas.

En resumen: el reenvío sirve para el enrutamiento; la configuración del cliente nativo sirve para ofrecer una experiencia de usuario más completa y específica del canal. Consulte Aprobaciones de exec.

Se requiere Node 22.22.3+, 24.15+ o 25.9+ (se recomienda Node 24). pnpm es el gestor de paquetes del repositorio. Bun puede instalar dependencias y ejecutar scripts de paquetes, pero no puede ejecutar la CLI ni el Gateway de OpenClaw porque carece de node:sqlite.

Sí, pero compruebe primero la RAM: Pi 5 y Pi 4 (2 GB+) son las opciones ideales; Pi 3B+ (1 GB) funciona, pero es lento; Pi Zero 2 W (512 MB) no se recomienda.

Mínimo absoluto: 1 GB de RAM, 1 núcleo, 500 MB de espacio libre en disco y un sistema operativo de 64 bits. Dado que el Pi solo ejecuta el Gateway (los modelos llaman a API en la nube), incluso un Pi modesto puede gestionar la carga.

Un Pi/VPS pequeño también puede alojar únicamente el Gateway mientras se emparejan nodos en el portátil o teléfono para usar localmente la pantalla, la cámara o el lienzo, o ejecutar comandos. Consulte Nodos.

Guía completa de configuración: Raspberry Pi.

• Use un sistema operativo de 64 bits; no use Raspberry Pi OS de 32 bits.
• Añada memoria de intercambio en placas de 2 GB o menos.
• Prefiera una unidad SSD USB a una tarjeta SD para mejorar el rendimiento y la vida útil.
• Prefiera la instalación modificable (git) para poder consultar los registros y actualizar rápidamente.
• Empiece sin canales ni Skills y añádalos uno por uno.
• Los fallos extraños de archivos binarios («exec format error») suelen deberse a que falta una compilación ARM64 para una herramienta opcional de una habilidad.

Guía completa: Raspberry Pi. Consulte también Linux.

Esa pantalla depende de que el Gateway sea accesible y esté autenticado. La TUI también envía «Wake up, my friend!» automáticamente durante la primera inicialización cuando hay un proveedor de modelos configurado. Si se omitió la configuración del modelo o la autenticación, la incorporación muestra una nota «Model auth missing» y abre la TUI sin enviar nada; añada un proveedor con openclaw configure --section model. Si aparece la línea de activación sin respuesta y los tokens permanecen en 0, el agente nunca llegó a ejecutarse.

1. Reinicie el Gateway:

openclaw gateway restart

2. Compruebe el estado y la autenticación:

openclaw statusopenclaw models statusopenclaw logs --follow

3. ¿Sigue bloqueado? Ejecute:

openclaw doctor

Si el Gateway es remoto, confirme que la conexión del túnel/Tailscale esté activa y que la interfaz apunte al Gateway correcto. Consulte Acceso remoto.

Sí. Copie el directorio de estado y el espacio de trabajo y, después, ejecute Doctor una vez:

1. Instale OpenClaw en el equipo nuevo.
2. Copie $OPENCLAW_STATE_DIR (valor predeterminado: ~/.openclaw) desde el equipo anterior.
3. Copie su espacio de trabajo (valor predeterminado: ~/.openclaw/workspace).
4. Ejecute openclaw doctor y reinicie el servicio del Gateway.

Esto conserva la configuración, los perfiles de autenticación, las credenciales de WhatsApp, las sesiones y la memoria; mantiene el bot exactamente igual, siempre que se copien ambas ubicaciones. En el modo remoto, el host del Gateway es el propietario del almacén de sesiones y del espacio de trabajo.

Importante: si solo confirma y envía el espacio de trabajo a GitHub, se crea una copia de seguridad de la memoria y los archivos de arranque, pero no del historial de sesiones ni de la autenticación. Estos se encuentran en ~/.openclaw/ (por ejemplo, ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite).

Información relacionada: Migración, Dónde se almacenan los elementos en el disco, Espacio de trabajo del agente, Doctor, Modo remoto.

Consulte el registro de cambios de GitHub: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

Las entradas más recientes aparecen al principio. Si la sección superior es Unreleased, la siguiente sección con fecha corresponde a la última versión publicada. Las entradas se agrupan bajo Aspectos destacados, Cambios y Correcciones (además de secciones de documentación u otras cuando sea necesario).

Algunas conexiones de Comcast/Xfinity bloquean incorrectamente docs.openclaw.ai mediante Xfinity Advanced Security. Desactívelo o añada docs.openclaw.ai a la lista de permitidos y vuelva a intentarlo. Ayúdenos a conseguir que se desbloquee: https://spa.xfinity.com/check_url_status.

¿Sigue bloqueado? La documentación está replicada en GitHub: https://github.com/openclaw/openclaw/tree/main/docs

Estable y beta son dist-tags de npm, no líneas de código independientes:

• latest = estable
• beta = compilación preliminar para pruebas (recurre a latest cuando falta la beta o es anterior a la versión estable actual)

Una versión estable suele publicarse primero en beta y, después, un paso explícito de promoción traslada esa misma versión a latest sin cambiar el número de versión. Los responsables del mantenimiento también pueden publicarla directamente en latest. Por eso, beta y estable pueden apuntar a la misma versión después de la promoción.

Consulte los cambios: CHANGELOG.md.

Para ver comandos de instalación de una sola línea y la diferencia entre beta y dev, consulte el siguiente acordeón.

Beta es el dist-tag de npm beta (puede coincidir con latest después de la promoción). Dev es la cabecera móvil de main (git); cuando se publica en npm, utiliza el dist-tag dev.

Comandos de una sola línea (macOS/Linux):

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Instalador de Windows (PowerShell): iwr -useb https://openclaw.ai/install.ps1 | iex

Más información: Canales de desarrollo y Opciones del instalador.

Hay dos opciones:

1. Canal dev (instalación existente):

openclaw update --channel dev

Esto cambia a un checkout de git de main, aplica rebase sobre el repositorio upstream, compila e instala la CLI desde ese checkout.

2. Instalación modificable (git) (equipo nuevo):

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Se recomienda una clonación manual:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm build

Documentación: Actualización, Canales de desarrollo, Instalación.

Guía aproximada:

• Instalación: 2-5 minutos.
• Incorporación de QuickStart: unos minutos (Gateway de bucle invertido, token automático y espacio de trabajo predeterminado).
• Incorporación avanzada/completa: tarda más cuando el inicio de sesión del proveedor, la vinculación del canal, la instalación del daemon, las descargas de red o las Skills requieren configuración adicional.

El asistente muestra este plazo desde el principio. Omita los pasos opcionales y vuelva más tarde con openclaw configure.

¿Se ha bloqueado? Consulte Estoy atascado más arriba.

Ejecútelo de nuevo con --verbose:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --verbosecurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta --verbosecurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose

install.ps1 no tiene una opción específica de salida detallada; ejecútelo mediante Set-PSDebug -Trace 1 / -Trace 0 en su lugar. Referencia completa de opciones: Opciones del instalador.

Dos problemas habituales en Windows:

1) Error de npm spawn git / no se encuentra git

• Instale Git for Windows y asegúrese de que git esté en PATH.
• Cierre y vuelva a abrir PowerShell; después, ejecute de nuevo el instalador.

2) No se reconoce openclaw después de la instalación

• La carpeta global de binarios de npm no está en PATH.
• Compruébelo: npm config get prefix.
• Añada ese directorio al PATH de usuario (no es necesario el sufijo \bin; en la mayoría de los sistemas es %AppData%\npm).
• Cierre y vuelva a abrir PowerShell.

¿Prefiere una aplicación de escritorio? Utilice Windows Hub. Para una configuración solo mediante terminal, se admiten tanto el instalador de PowerShell como las rutas del Gateway de WSL2. Documentación: Windows.

Normalmente se debe a una discrepancia en la página de códigos de la consola en shells nativos de Windows.

Síntomas: la salida de system.run/exec muestra el chino como texto corrupto; el mismo comando se ve correctamente en otro perfil de terminal.

Solución alternativa en PowerShell:

chcp 65001[Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false)[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)$OutputEncoding = [System.Text.UTF8Encoding]::new($false)

Después, reinicie el Gateway y vuelva a intentarlo:

openclaw gateway restart

¿Sigue ocurriendo con la versión más reciente de OpenClaw? Consulte o informe del problema: Incidencia n.º 30640.

Utilice la instalación modificable (git) para disponer localmente del código fuente y la documentación completos; después, pregunte a su bot (o a Claude/Codex) desde esa carpeta para que pueda leer el repositorio y responder con precisión.

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Más información: Instalación y Opciones del instalador.

• Ruta rápida de Linux e instalación del servicio: Linux.
• Guía completa paso a paso: Primeros pasos.
• Instalador y actualizaciones: Instalación y actualizaciones.

Cualquier VPS con Linux sirve. Instálelo en el servidor y, después, acceda al Gateway mediante SSH/Tailscale.

Guías: exe.dev, Hetzner, Fly.io. Acceso remoto: Gateway remoto.

Centro de alojamiento con proveedores habituales:

• Alojamiento en VPS (todos los proveedores en un solo lugar)
• Fly.io
• Hetzner
• exe.dev

En la nube, el Gateway se ejecuta en el servidor y se accede a él desde un portátil o teléfono mediante la interfaz de control (o Tailscale/SSH). El estado y el espacio de trabajo residen en el servidor, por lo que debe tratarse el host como la fuente de verdad y crear copias de seguridad.

Vincule nodos (Mac/iOS/Android/sin interfaz) a ese Gateway en la nube para acceder localmente a la pantalla, la cámara o el lienzo, o para ejecutar comandos en el portátil, mientras el Gateway permanece en la nube.

Centro: Plataformas. Acceso remoto: Gateway remoto. Nodos: Nodos, CLI de nodos.

Es posible, pero no se recomienda. El proceso de actualización puede reiniciar el Gateway (lo que interrumpe la sesión activa), puede necesitar un checkout de git limpio y puede solicitar confirmación. Es más seguro ejecutar las actualizaciones desde un shell como operador.

openclaw updateopenclaw update statusopenclaw update --channel stable|extended-stable|beta|devopenclaw update --tag <dist-tag|version>openclaw update --no-restart

Automatización desde un agente:

openclaw update --yes --no-restartopenclaw gateway restart

Documentación: Actualización, Cómo actualizar.

openclaw onboard es la ruta de configuración recomendada. En modo local, guía por los siguientes pasos:

1. Modelo/autenticación: OAuth del proveedor, claves de API o autenticación manual (incluidas opciones locales como LM Studio); selección de un modelo predeterminado.
2. Espacio de trabajo: ubicación y archivos de arranque.
3. Gateway: puerto, dirección de enlace, modo de autenticación y exposición mediante Tailscale.
4. Canales: canales de chat integrados y de plugins oficiales: iMessage, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp y otros.
5. Daemon: LaunchAgent (macOS), unidad de usuario de systemd (Linux/WSL2) o tarea programada nativa de Windows.
6. Comprobación de estado: inicia el Gateway y verifica que esté en ejecución.
7. Skills: instala las skills recomendadas y las dependencias opcionales.

Indica desde el principio la duración prevista y avisa si el modelo configurado es desconocido o no tiene autenticación. Desglose completo: Incorporación (CLI).

No. Ejecute OpenClaw con claves de API (Anthropic/OpenAI/otros) o con modelos exclusivamente locales para que los datos permanezcan en el dispositivo. Las suscripciones (Claude Pro/Max, ChatGPT/Codex) son formas opcionales de autenticarse con esos proveedores.

Para Anthropic: una clave de API ofrece la facturación estándar de pago por uso; Claude CLI reutiliza un inicio de sesión existente de Claude Code en el mismo host. Actualmente, Anthropic considera que la ruta no interactiva claude -p de Claude CLI constituye un uso programático o del Agent SDK que sigue consumiendo los límites del plan de la suscripción; consulte la documentación actual sobre facturación de Anthropic antes de depender del comportamiento de la suscripción. Para hosts de Gateway de larga duración y automatización compartida, una clave de API de Anthropic es la opción más predecible.

OAuth de OpenAI Codex (suscripción a ChatGPT/Codex) es totalmente compatible con los modelos de agente. OpenClaw también admite opciones alojadas de tipo suscripción, entre ellas Qwen Cloud Coding Plan, MiniMax Coding Plan y Z.AI / GLM Coding Plan.

Documentación: Anthropic, OpenAI, Qwen Cloud, MiniMax, Z.AI (GLM), Modelos locales, Modelos.

Sí. OpenClaw permite reutilizar Claude CLI con los planes Pro/Max/Team/Enterprise. Actualmente, Anthropic considera que la ruta claude -p que utiliza OpenClaw es un uso sujeto a los límites del plan de suscripción, no una asignación gratuita independiente; consulte Anthropic para obtener información actualizada sobre la facturación y enlaces a los propios artículos de soporte de Anthropic. Para obtener la configuración del lado del servidor más predecible, utilice en su lugar una clave de API de Anthropic.

Sí, mediante la reutilización de Claude CLI. El tratamiento de facturación que Anthropic aplica al uso de claude -p/Agent SDK ha cambiado con el tiempo; consulte Anthropic para conocer el estado actual y acceder a enlaces fechados a los artículos de soporte de Anthropic antes de depender de un comportamiento de facturación concreto.

La autenticación mediante token de configuración de Anthropic también sigue siendo una vía de token compatible, pero OpenClaw prefiere reutilizar la CLI de Claude y claude -p cuando estén disponibles. Para cargas de trabajo de producción o multiusuario, una clave de API de Anthropic sigue siendo la opción más segura y predecible. Otras opciones alojadas de tipo suscripción: OpenAI, Qwen Cloud, MiniMax, Z.AI (GLM).

Se ha agotado la cuota o el límite de solicitudes de Anthropic para el período actual. En la CLI de Claude, espere a que el período se reinicie o mejore su plan. Con una clave de API de Anthropic, compruebe el uso y la facturación en Anthropic Console y aumente los límites según sea necesario.

Si el mensaje es específicamente Extra usage is required for long context requests, la solicitud está intentando usar la ventana de contexto de 1M de Anthropic (un modelo Claude 4.x con capacidad de 1M y disponibilidad general, o la configuración heredada params.context1m: true), y su credencial actual no cumple los requisitos para la facturación de contexto largo.

Configure un modelo alternativo para que OpenClaw siga respondiendo mientras un proveedor tenga limitado el número de solicitudes. Consulte Modelos, OAuth y Uso adicional requerido por el error 429 de Anthropic para contexto largo.

Sí. OpenClaw incluye un proveedor integrado de Amazon Bedrock (Converse). Cuando están presentes los indicadores de entorno de AWS (AWS_ACCESS_KEY_ID, AWS_PROFILE, AWS_BEARER_TOKEN_BEDROCK), OpenClaw activa automáticamente el proveedor implícito de Bedrock para descubrir modelos; de lo contrario, configure plugins.entries.amazon-bedrock.config.discovery.enabled: true o añada una entrada de proveedor manual. Consulte Amazon Bedrock y Proveedores de modelos. Un proxy compatible con OpenAI delante de Bedrock sigue siendo una opción válida si se prefiere un flujo de claves gestionado.

OpenClaw admite OpenAI Codex mediante OAuth (inicio de sesión en ChatGPT). Una configuración nueva sin modelo principal usa exactamente openai/gpt-5.6-sol para la autenticación de suscripción de ChatGPT/Codex y la ejecución nativa del servidor de aplicaciones de Codex. La reautenticación conserva un modelo explícito existente, incluido openai/gpt-5.5. Si el espacio de trabajo de Codex no ofrece GPT-5.6, seleccione openai/gpt-5.5 explícitamente; OpenClaw no cambia silenciosamente a una versión inferior. Las referencias de modelos con el prefijo heredado de Codex son configuración heredada que repara openclaw doctor --fix. El acceso directo mediante una clave de API de OpenAI sigue disponible para las superficies de API de OpenAI que no sean de agentes y también, mediante un perfil ordenado de clave de API openai, para los modelos de agentes. Consulte Proveedores de modelos e Incorporación (CLI).

openai es el identificador actual de proveedor y perfil de autenticación tanto para las claves de API de OpenAI como para OAuth de ChatGPT/Codex; OpenAI Codex está integrado en él. Es posible que todavía aparezca un prefijo heredado openai-codex en configuraciones antiguas y advertencias de migración:

• openai/gpt-5.6-sol = configuración nueva de suscripción de ChatGPT/Codex con el entorno de ejecución nativo de Codex para los turnos del agente.
• openai/gpt-5.5 = selección compatible explícita para configuraciones existentes o cuentas sin acceso a GPT-5.6.
• Referencias de modelos heredadas openai-codex/* = ruta heredada reparada por openclaw doctor --fix.
• openai/gpt-5.5 más un perfil ordenado de clave de API openai = autenticación mediante clave de API para un modelo de agente de OpenAI.
• Identificadores de perfil de autenticación heredados openai-codex = identificadores heredados migrados por openclaw doctor --fix.

¿Desea facturación directa de OpenAI Platform? Configure OPENAI_API_KEY. ¿Desea autenticación mediante suscripción de ChatGPT/Codex? Ejecute openclaw models auth login --provider openai. Mantenga las referencias de modelos bajo el proveedor canónico openai/*. La configuración nueva de suscripción usa exactamente openai/gpt-5.6-sol; doctor repara las referencias con el prefijo heredado de Codex sin actualizar una selección explícita de openai/gpt-5.5.

OAuth de Codex usa períodos de cuota gestionados por OpenAI y dependientes del plan que pueden diferir de la experiencia del sitio web o la aplicación de ChatGPT, incluso con la misma cuenta.

openclaw models status muestra los períodos de uso y cuota del proveedor visibles actualmente, pero no crea ni convierte los derechos de ChatGPT web en acceso directo a la API. Para la vía directa de facturación y límites de OpenAI Platform, use openai/* con una clave de API.

Sí, totalmente. OpenAI permite explícitamente usar OAuth de suscripción en herramientas y flujos de trabajo externos como OpenClaw. La incorporación puede ejecutar el flujo de OAuth.

Consulte OAuth, Proveedores de modelos e Incorporación (CLI).

La CLI de Gemini usa un flujo de autenticación de Plugin, no un identificador ni secreto de cliente en openclaw.json.

1. Instale la CLI de Gemini localmente para que gemini esté en PATH:
   • Homebrew: brew install gemini-cli
   • npm: npm install -g @google/gemini-cli
2. Active el Plugin: openclaw plugins enable google
3. Inicie sesión: openclaw models auth login --provider google-gemini-cli --set-default
4. Modelo predeterminado después de iniciar sesión: google/gemini-3.1-pro-preview (entorno de ejecución google-gemini-cli)
5. ¿Las solicitudes fallan después de iniciar sesión? Configure GOOGLE_CLOUD_PROJECT o GOOGLE_CLOUD_PROJECT_ID en el host del Gateway y vuelva a intentarlo.

Los tokens de OAuth se almacenan en perfiles de autenticación en el host del Gateway. Detalles: Google, Proveedores de modelos.

Normalmente no. OpenClaw necesita un contexto amplio y una seguridad robusta; las tarjetas pequeñas truncan el contexto y omiten los filtros de seguridad del proveedor. Si es imprescindible, ejecute localmente la compilación de modelo más grande posible (LM Studio); consulte Modelos locales. Los modelos más pequeños o cuantizados aumentan el riesgo de inyección de instrucciones; consulte Seguridad.

Elija endpoints asociados a una región. OpenRouter ofrece opciones alojadas en EE. UU. para MiniMax, Kimi y GLM; elija la variante alojada en EE. UU. para mantener los datos en la región. Aun así, puede incluir Anthropic/OpenAI junto a estas opciones con models.mode: "merge" para que los modelos alternativos sigan disponibles respetando el proveedor regional seleccionado.

No. OpenClaw se ejecuta en macOS o Linux (Windows mediante WSL2). Un Mac mini es una opción popular como host siempre activo, pero también sirve un VPS pequeño, un servidor doméstico o un equipo de la categoría de Raspberry Pi.

Solo se necesita un Mac para herramientas exclusivas de macOS. Para iMessage, use iMessage con imsg en cualquier Mac que tenga una sesión iniciada en Messages; si el Gateway se ejecuta en Linux o en otro lugar, configure channels.imessage.cliPath con un contenedor SSH que ejecute imsg en ese Mac. Para otras herramientas exclusivas de macOS, ejecute el Gateway en un Mac o vincule un Node de macOS.

Documentación: iMessage, Nodes, Modo remoto de Mac.

Se necesita algún dispositivo macOS con una sesión iniciada en Messages; no necesariamente un Mac mini, cualquier Mac sirve. Use iMessage con imsg; el Gateway puede ejecutarse en ese Mac o en otro lugar mediante un contenedor SSH cliPath.

Configuraciones habituales:

• Gateway en Linux/VPS, con channels.imessage.cliPath configurado como un contenedor SSH que ejecuta imsg en un Mac con una sesión iniciada en Messages.
• Todo en un solo Mac para obtener la configuración más sencilla en un único equipo.

Documentación: iMessage, Nodes, Modo remoto de Mac.

Sí. El Mac mini puede ejecutar el Gateway y el MacBook Pro se conecta como Node (dispositivo complementario). Los Nodes no ejecutan el Gateway; añaden funciones como pantalla, cámara, lienzo y system.run en ese dispositivo.

Patrón habitual: el Gateway se ejecuta en el Mac mini siempre activo; el MacBook Pro ejecuta la aplicación de macOS o un host de Node y se vincula al Gateway. Compruébelo con openclaw nodes status / openclaw nodes list.

Documentación: Nodes, CLI de Nodes.

Se puede usar Bun para instalar dependencias o ejecutar scripts de paquetes. La CLI y el Gateway de OpenClaw requieren Node porque el almacén de estado canónico usa node:sqlite; Bun no proporciona esa API.

channels.telegram.allowFrom es el identificador de usuario de Telegram del remitente humano (numérico), no el nombre de usuario del bot. La configuración solo solicita identificadores de usuario numéricos; openclaw doctor --fix puede intentar resolver entradas heredadas @username.

Opción más segura (sin bot de terceros): envíe un mensaje directo a su bot, ejecute openclaw logs --follow y consulte from.id.

API oficial de bots: envíe un mensaje directo a su bot, llame a https://api.telegram.org/bot<bot_token>/getUpdates y consulte message.from.id.

Terceros (menos privado): envíe un mensaje directo a @userinfobot o @getidsbot.

Consulte Control de acceso de Telegram.

Sí, mediante el enrutamiento multiagente. Vincule el mensaje directo de WhatsApp de cada remitente (peer: { kind: "direct", id: "+15551234567" }) a un agentId distinto, lo que proporciona a cada persona su propio espacio de trabajo y almacén de sesiones. Las respuestas siguen procediendo de la misma cuenta de WhatsApp; el control de acceso a mensajes directos (channels.whatsapp.dmPolicy / channels.whatsapp.allowFrom) es global para cada cuenta. Consulte Enrutamiento multiagente y WhatsApp.

Sí. Use el enrutamiento multiagente: asigne a cada agente su propio modelo predeterminado y, después, vincule las rutas entrantes (cuenta del proveedor o interlocutores específicos) a cada agente. Configuración de ejemplo: Enrutamiento multiagente. Consulte también Modelos y Configuración.

Sí, mediante Linuxbrew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profileeval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"brew install <formula>

Al ejecutar OpenClaw mediante systemd, asegúrese de que la variable PATH del servicio incluya /home/linuxbrew/.linuxbrew/bin (o el prefijo de brew correspondiente) para que las herramientas instaladas mediante brew se resuelvan en shells sin inicio de sesión. Las compilaciones recientes también anteponen directorios binarios de usuario habituales en los servicios systemd de Linux (por ejemplo, ~/.local/bin, ~/.npm-global/bin, ~/.local/share/pnpm, ~/.bun/bin) y respetan PNPM_HOME, NPM_CONFIG_PREFIX, BUN_INSTALL, VOLTA_HOME, ASDF_DATA_DIR, NVM_DIR y FNM_DIR cuando están configurados.

• Instalación modificable (git): copia de trabajo completa del código fuente, editable e idónea para contribuidores. Se compila localmente y permite modificar el código o la documentación.
• Instalación mediante npm: instalación global de la CLI, sin repositorio e idónea para «simplemente ejecutarlo». Las actualizaciones proceden de las etiquetas de distribución de npm.

Documentación: Primeros pasos, Actualización.

Sí, con openclaw update --channel ... en una instalación existente. Esto no elimina sus datos; solo cambia la instalación del código de OpenClaw. El estado (~/.openclaw) y el espacio de trabajo (~/.openclaw/workspace) permanecen intactos.

De npm a git:

openclaw update --channel dev

De git a npm:

openclaw update --channel stable

Añada --dry-run para previsualizar primero el cambio de modo previsto. El actualizador ejecuta las tareas posteriores de Doctor, actualiza los orígenes de los plugins para el canal de destino y reinicia el Gateway, a menos que se especifique --no-restart.

El instalador también puede forzar cualquiera de los dos modos:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method gitcurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method npm

Consejos para copias de seguridad: Dónde se almacenan los elementos en el disco.

¿Se busca fiabilidad las 24 horas del día, los 7 días de la semana? Use un VPS. ¿Se busca la menor fricción posible y se aceptan las suspensiones y los reinicios? Ejecútelo localmente.

Portátil (Gateway local)

• Ventajas: sin coste de servidor, acceso directo a archivos locales y una ventana activa del navegador.
• Desventajas: la suspensión o las interrupciones de red lo desconectan, las actualizaciones y los reinicios del sistema operativo lo interrumpen, y el equipo debe permanecer activo.

VPS/nube

• Ventajas: siempre activo, red estable, sin problemas de suspensión del portátil y más fácil de mantener en ejecución.
• Desventajas: suele funcionar sin interfaz gráfica (use capturas de pantalla), solo permite acceso remoto a archivos y requiere SSH para las actualizaciones.

WhatsApp/Telegram/Slack/Mattermost/Discord funcionan correctamente desde un VPS; la verdadera disyuntiva es usar un navegador sin interfaz gráfica o una ventana visible. Consulte Navegador.

Recomendación predeterminada: use un VPS si ya se han producido desconexiones del Gateway; la ejecución local es excelente cuando se usa activamente el Mac y se desea acceder a archivos locales o automatizar la interfaz de usuario mediante un navegador visible.

No es obligatorio, pero se recomienda para mejorar la fiabilidad y el aislamiento.

• Host dedicado (VPS/Mac mini/Raspberry Pi): siempre activo, menos interrupciones por suspensiones o reinicios, permisos más claros y más fácil de mantener en ejecución.
• Portátil/equipo de escritorio compartido: adecuado para pruebas y uso activo, pero se producirán pausas cuando la máquina se suspenda o se actualice.

Para obtener lo mejor de ambos entornos, mantenga el Gateway en un host dedicado y vincule el portátil como Node para las herramientas locales de pantalla, cámara y ejecución. Consulte Nodos y Seguridad.

• Mínimo absoluto: 1 vCPU, 1 GB de RAM y ~500 MB de disco.
• Recomendado: 1-2 vCPU y 2 GB o más de RAM para disponer de margen (registros, contenido multimedia y varios canales). Las herramientas de Node y la automatización del navegador pueden consumir muchos recursos.

Sistema operativo: Ubuntu LTS (o cualquier versión moderna de Debian/Ubuntu), la ruta de instalación de Linux más probada.

Documentación: Linux, Alojamiento en VPS.

Sí. Trate una máquina virtual como un VPS: debe estar siempre activa, ser accesible y disponer de suficiente RAM para el Gateway y los canales que se habiliten.

• Mínimo absoluto: 1 vCPU y 1 GB de RAM.
• Recomendado: 2 GB o más de RAM para varios canales, la automatización del navegador o las herramientas multimedia.
• Sistema operativo: Ubuntu LTS u otra versión moderna de Debian/Ubuntu.

En Windows, use Windows Hub para la configuración del escritorio o WSL2 para disponer de una máquina virtual de Gateway similar a Linux con amplia compatibilidad con herramientas. Consulte Windows, Alojamiento en VPS. Para ejecutar macOS en una máquina virtual, consulte Máquina virtual de macOS.