​

Preguntas frecuentes

​

Tabla de contenidos

• [Inicio rápido y configuración inicial]
  • Estoy atascado, ¿cuál es la forma más rápida de salir del atasco?
  • ¿Cuál es la forma recomendada de instalar y configurar OpenClaw?
  • ¿Cómo abro el panel después del onboarding?
  • ¿Cómo autentico el panel (token) en localhost vs remoto?
  • ¿Qué runtime necesito?
  • ¿Funciona en Raspberry Pi?
  • ¿Algún consejo para instalaciones en Raspberry Pi?
  • Está atascado en “wake up my friend” / el onboarding no arranca. ¿Y ahora qué?
  • ¿Puedo migrar mi configuración a una máquina nueva (Mac mini) sin rehacer el onboarding?
  • ¿Dónde veo qué hay de nuevo en la última versión?
  • No puedo acceder a docs.openclaw.ai (error SSL). ¿Qué hago?
  • ¿Cuál es la diferencia entre estable y beta?
  • ¿Cómo instalo la versión beta y cuál es la diferencia entre beta y dev?
  • ¿Cómo pruebo lo más reciente?
  • ¿Cuánto suelen tardar la instalación y el onboarding?
  • ¿El instalador está atascado? ¿Cómo obtengo más información?
  • La instalación en Windows dice git no encontrado o openclaw no reconocido
  • La documentación no respondió mi pregunta: ¿cómo obtengo una mejor respuesta?
  • ¿Cómo instalo OpenClaw en Linux?
  • ¿Cómo instalo OpenClaw en un VPS?
  • ¿Dónde están las guías de instalación en la nube/VPS?
  • ¿Puedo pedirle a OpenClaw que se actualice solo?
  • ¿Qué hace realmente el asistente de onboarding?
  • ¿Necesito una suscripción a Claude u OpenAI para ejecutar esto?
  • ¿Puedo usar la suscripción Claude Max sin una clave de API?
  • ¿Cómo funciona la autenticación “setup-token” de Anthropic?
  • ¿Dónde encuentro un setup-token de Anthropic?
  • ¿Admiten autenticación por suscripción de Claude (Claude Pro o Max)?
  • ¿Por qué veo HTTP 429: rate_limit_error de Anthropic?
  • ¿Se admite AWS Bedrock?
  • ¿Cómo funciona la autenticación de Codex?
  • ¿Admiten autenticación por suscripción de OpenAI (Codex OAuth)?
  • ¿Cómo configuro Gemini CLI OAuth?
  • ¿Un modelo local sirve para chats casuales?
  • ¿Cómo mantengo el tráfico de modelos alojados en una región específica?
  • ¿Tengo que comprar un Mac mini para instalar esto?
  • ¿Necesito un Mac mini para compatibilidad con iMessage?
  • Si compro un Mac mini para ejecutar OpenClaw, ¿puedo conectarlo a mi MacBook Pro?
  • ¿Puedo usar Bun?
  • Telegram: ¿qué va en allowFrom?
  • ¿Varias personas pueden usar un número de WhatsApp con distintas instancias de OpenClaw?
  • ¿Puedo ejecutar un agente de “chat rápido” y otro “Opus para programación”?
  • ¿Homebrew funciona en Linux?
  • ¿Cuál es la diferencia entre la instalación hackable (git) y npm?
  • ¿Puedo cambiar entre instalaciones npm y git más adelante?
  • ¿Debería ejecutar el Gateway en mi laptop o en un VPS?
  • ¿Qué tan importante es ejecutar OpenClaw en una máquina dedicada?
  • ¿Cuáles son los requisitos mínimos de un VPS y el SO recomendado?
  • ¿Puedo ejecutar OpenClaw en una VM y cuáles son los requisitos?
• ¿Qué es OpenClaw?
  • ¿Qué es OpenClaw en un párrafo?
  • ¿Cuál es la propuesta de valor?
  • Acabo de configurarlo, ¿qué debería hacer primero?
  • ¿Cuáles son los cinco casos de uso cotidianos principales de OpenClaw?
  • ¿Puede OpenClaw ayudar con generación de leads, outreach, anuncios y blogs para un SaaS?
  • ¿Cuáles son las ventajas frente a Claude Code para desarrollo web?
• Skills y automatización
  • ¿Cómo personalizo skills sin ensuciar el repo?
  • ¿Puedo cargar skills desde una carpeta personalizada?
  • ¿Cómo puedo usar diferentes modelos para distintas tareas?
  • El bot se congela al hacer trabajo pesado. ¿Cómo lo descargo?
  • Cron o recordatorios no se ejecutan. ¿Qué debo revisar?
  • ¿Cómo instalo skills en Linux?
  • ¿Puede OpenClaw ejecutar tareas programadas o continuamente en segundo plano?
  • ¿Puedo ejecutar skills solo de macOS desde Linux?
  • ¿Tienen integración con Notion o HeyGen?
  • ¿Cómo instalo la extensión de Chrome para control del navegador?
• Sandboxing y memoria
  • ¿Hay un documento dedicado a sandboxing?
  • ¿Cómo vinculo una carpeta del host al sandbox?
  • ¿Cómo funciona la memoria?
  • La memoria olvida cosas. ¿Cómo hago que se guarden?
  • ¿La memoria persiste para siempre? ¿Cuáles son los límites?
  • ¿La búsqueda semántica de memoria requiere una clave de API de OpenAI?
• Dónde viven las cosas en disco
  • ¿Todos los datos usados con OpenClaw se guardan localmente?
  • ¿Dónde almacena OpenClaw sus datos?
  • ¿Dónde deben vivir AGENTS.md / SOUL.md / USER.md / MEMORY.md?
  • ¿Cuál es la estrategia de respaldo recomendada?
  • ¿Cómo desinstalo OpenClaw por completo?
  • ¿Pueden los agentes trabajar fuera del espacio de trabajo?
  • Estoy en modo remoto: ¿dónde está el almacén de sesiones?
• Conceptos básicos de configuración
  • ¿Qué formato tiene la configuración? ¿Dónde está?
  • Configuré gateway.bind: "lan" (o "tailnet") y ahora nada escucha / la UI dice no autorizado
  • ¿Por qué ahora necesito un token en localhost?
  • ¿Tengo que reiniciar después de cambiar la configuración?
  • ¿Cómo habilito la búsqueda web (y web fetch)?
  • config.apply borró mi configuración. ¿Cómo recupero y evito esto?
  • ¿Cómo ejecuto un Gateway central con workers especializados en varios dispositivos?
  • ¿El navegador de OpenClaw puede ejecutarse en modo headless?
  • ¿Cómo uso Brave para control del navegador?
• Gateways y nodos remotos
  • ¿Cómo se propagan los comandos entre Telegram, el gateway y los nodos?
  • ¿Cómo puede mi agente acceder a mi computadora si el Gateway está alojado remotamente?
  • Tailscale está conectado pero no recibo respuestas. ¿Qué hago?
  • ¿Pueden hablar entre sí dos instancias de OpenClaw (local + VPS)?
  • ¿Necesito VPS separados para múltiples agentes?
  • ¿Hay un beneficio en usar un nodo en mi laptop personal en lugar de SSH desde un VPS?
  • ¿Los nodos ejecutan un servicio de gateway?
  • ¿Existe una forma API / RPC de aplicar configuración?
  • ¿Cuál es una configuración mínima “sensata” para una primera instalación?
  • ¿Cómo configuro Tailscale en un VPS y me conecto desde mi Mac?
  • ¿Cómo conecto un nodo Mac a un Gateway remoto (Tailscale Serve)?
  • ¿Debería instalar en una segunda laptop o solo agregar un nodo?
• Variables de entorno y carga de .env
  • ¿Cómo carga OpenClaw las variables de entorno?
  • “Inicié el Gateway vía el servicio y mis variables de entorno desaparecieron”. ¿Qué hago?
  • Configuré COPILOT_GITHUB_TOKEN, pero el estado de modelos muestra “Shell env: off”. ¿Por qué?
• Sesiones y múltiples chats
  • ¿Cómo inicio una conversación nueva?
  • ¿Las sesiones se reinician automáticamente si nunca envío /new?
  • ¿Hay una forma de hacer un equipo de instancias de OpenClaw con un CEO y muchos agentes?
  • ¿Por qué se truncó el contexto a mitad de tarea? ¿Cómo lo evito?
  • ¿Cómo reinicio OpenClaw por completo pero lo mantengo instalado?
  • Recibo errores de “context too large”. ¿Cómo reinicio o compacto?
  • ¿Por qué veo “LLM request rejected: messages.N.content.X.tool_use.input: Field required”?
  • ¿Por qué recibo mensajes de heartbeat cada 30 minutos?
  • ¿Necesito agregar una “cuenta bot” a un grupo de WhatsApp?
  • ¿Cómo obtengo el JID de un grupo de WhatsApp?
  • ¿Por qué OpenClaw no responde en un grupo?
  • ¿Los grupos/hilos comparten contexto con los mensajes directos?
  • ¿Cuántos espacios de trabajo y agentes puedo crear?
  • ¿Puedo ejecutar múltiples bots o chats al mismo tiempo (Slack) y cómo configurarlo?
• Modelos: valores predeterminados, selección, alias y cambio
  • ¿Qué es el “modelo predeterminado”?
  • ¿Qué modelo recomienda?
  • ¿Cómo cambio de modelo sin borrar mi configuración?
  • ¿Puedo usar modelos autoalojados (llama.cpp, vLLM, Ollama)?
  • ¿Qué usan OpenClaw, Flawd y Krill como modelos?
  • ¿Cómo cambio de modelo al vuelo (sin reiniciar)?
  • ¿Puedo usar GPT 5.2 para tareas diarias y Codex 5.3 para programar?
  • ¿Por qué veo “Model … is not allowed” y luego no hay respuesta?
  • ¿Por qué veo “Unknown model: minimax/MiniMax-M2.1”?
  • ¿Puedo usar MiniMax como predeterminado y OpenAI para tareas complejas?
  • ¿opus / sonnet / gpt son atajos integrados?
  • ¿Cómo defino/sobrescribo atajos (alias) de modelos?
  • ¿Cómo agrego modelos de otros proveedores como OpenRouter o Z.AI?
• Conmutación por error de modelos y “All models failed”
  • ¿Cómo funciona la conmutación por error?
  • ¿Qué significa este error?
  • Lista de verificación para corregir No credentials found for profile "anthropic:default"
  • ¿Por qué también intentó Google Gemini y falló?
• Perfiles de autenticación: qué son y cómo administrarlos
  • ¿Qué es un perfil de autenticación?
  • ¿Cuáles son IDs de perfil típicos?
  • ¿Puedo controlar qué perfil de autenticación se intenta primero?
  • OAuth vs clave de API: ¿cuál es la diferencia?
• Gateway: puertos, “ya en ejecución” y modo remoto
  • ¿Qué puerto usa el Gateway?
  • ¿Por qué openclaw gateway status dice Runtime: running pero RPC probe: failed?
  • ¿Por qué openclaw gateway status muestra Config (cli) y Config (service) diferentes?
  • ¿Qué significa “another gateway instance is already listening”?
  • ¿Cómo ejecuto OpenClaw en modo remoto (el cliente se conecta a un Gateway en otro lugar)?
  • La UI de Control dice “unauthorized” (o se reconecta continuamente). ¿Qué hago?
  • Configuré gateway.bind: "tailnet" pero no puede enlazar / nada escucha
  • ¿Puedo ejecutar múltiples Gateways en el mismo host?
  • ¿Qué significa “invalid handshake” / código 1008?
• Registro y depuración
  • ¿Dónde están los logs?
  • ¿Cómo inicio/detengo/reinicio el servicio del Gateway?
  • Cerré mi terminal en Windows: ¿cómo reinicio OpenClaw?
  • El Gateway está activo pero las respuestas nunca llegan. ¿Qué reviso?
  • “Disconnected from gateway: no reason”: ¿y ahora?
  • Telegram setMyCommands falla con errores de red. ¿Qué reviso?
  • La TUI no muestra salida. ¿Qué reviso?
  • ¿Cómo detengo completamente y luego inicio el Gateway?
  • ELI5: openclaw gateway restart vs openclaw gateway
  • ¿Cuál es la forma más rápida de obtener más detalles cuando algo falla?
• Medios y adjuntos
  • Mi skill generó una imagen/PDF, pero no se envió nada
• Seguridad y control de acceso
  • ¿Es seguro exponer OpenClaw a mensajes directos entrantes?
  • ¿La inyección de prompts solo es una preocupación para bots públicos?
  • ¿Mi bot debería tener su propio correo, cuenta de GitHub o número telefónico?
  • ¿Puedo darle autonomía sobre mis mensajes de texto y es seguro?
  • ¿Puedo usar modelos más baratos para tareas de asistente personal?
  • Ejecuté /start en Telegram pero no recibí un código de emparejamiento
  • WhatsApp: ¿enviará mensajes a mis contactos? ¿Cómo funciona el emparejamiento?
• Comandos de chat, cancelación de tareas y “no se detiene”
  • ¿Cómo evito que los mensajes internos del sistema aparezcan en el chat?
  • ¿Cómo detengo/cancelo una tarea en ejecución?
  • ¿Cómo envío un mensaje de Discord desde Telegram? (“Cross-context messaging denied”)
  • ¿Por qué parece que el bot “ignora” mensajes enviados rápidamente?

​

Primeros 60 segundos si algo está roto

1. Estado rápido (primera verificación)
   openclaw status
   
   Resumen local rápido: SO + actualización, accesibilidad del gateway/servicio, agentes/sesiones, configuración de proveedor + problemas de runtime (cuando el gateway es accesible).
2. Informe copiable (seguro para compartir)
   openclaw status --all
   
   Diagnóstico de solo lectura con cola de logs (tokens ocultos).
3. Estado de demonio + puerto
   openclaw gateway status
   
   Muestra el runtime del supervisor vs accesibilidad RPC, la URL objetivo de la sonda y qué configuración probablemente usó el servicio.
4. Sondeos profundos
   openclaw status --deep
   
   Ejecuta comprobaciones de salud del gateway + sondeos de proveedores (requiere un gateway accesible). Ver Health.
5. Ver el último log
   openclaw logs --follow
   
   Si RPC está caído, use como alternativa:
   tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"
   
   Los logs de archivos son independientes de los logs del servicio; ver Logging y Solución de problemas.
6. Ejecutar el doctor (reparaciones)
   openclaw doctor
   
   Repara/migra configuración/estado + ejecuta comprobaciones de salud. Ver Doctor.
7. Instantánea del Gateway
   openclaw health --json
   openclaw health --verbose   # shows the target URL + config path on errors
   
   Solicita al gateway en ejecución una instantánea completa (solo WS). Ver Health.

​

Inicio rápido y configuración inicial

​

Im stuck whats the fastest way to get unstuck

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

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

openclaw status
openclaw models status
openclaw doctor

• openclaw status: instantánea rápida de salud del gateway/agente + configuración básica.
• openclaw models status: verifica autenticación de proveedores + disponibilidad de modelos.
• openclaw doctor: valida y repara problemas comunes de configuración/estado.

​

What’s the recommended way to install and set up OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build # auto-installs UI deps on first run
openclaw onboard

​

How do I open the dashboard after onboarding

​

How do I authenticate the dashboard token on localhost vs remote

• Abra http://127.0.0.1:18789/.
• Si solicita autenticación, pegue el token de gateway.auth.token (o OPENCLAW_GATEWAY_TOKEN) en la configuración de la UI de Control.
• Recupérelo desde el host del Gateway: openclaw config get gateway.auth.token (o genere uno: openclaw doctor --generate-gateway-token).

• Tailscale Serve (recomendado): mantenga el enlace a loopback, ejecute openclaw gateway --tailscale serve, abra https://<magicdns>/. Si gateway.auth.allowTailscale es true, los encabezados de identidad satisfacen la autenticación (sin token).
• Enlace a tailnet: ejecute openclaw gateway --bind tailnet --token "<token>", abra http://<tailscale-ip>:18789/, pegue el token en la configuración del panel.
• Túnel SSH: ssh -N -L 18789:127.0.0.1:18789 user@host y luego abra http://127.0.0.1:18789/ y pegue el token en la configuración de la UI de Control.

​

What runtime do I need

​

Does it run on Raspberry Pi

​

Any tips for Raspberry Pi installs

• Use un SO de 64 bits y mantenga Node >= 22.
• Prefiera la instalación hackable (git) para ver logs y actualizar rápido.
• Comience sin canales/skills, luego agréguelos uno por uno.
• Si encuentra problemas binarios extraños, normalmente es un problema de compatibilidad ARM.

​

It is stuck on wake up my friend onboarding will not hatch What now

1. Reinicie el Gateway:

openclaw gateway restart

2. Verifique estado + autenticación:

openclaw status
openclaw models status
openclaw logs --follow

3. Si aún se cuelga, ejecute:

openclaw doctor

​

Can I migrate my setup to a new machine Mac mini without redoing onboarding

1. Instale OpenClaw en la máquina nueva.
2. Copie $OPENCLAW_STATE_DIR (predeterminado: ~/.openclaw) desde la máquina antigua.
3. Copie su espacio de trabajo (predeterminado: ~/.openclaw/workspace).
4. Ejecute openclaw doctor y reinicie el servicio del Gateway.

​

Where do I see what is new in the latest version

​

I cant access docs.openclaw.ai SSL error What now

​

What’s the difference between stable and beta

• latest = estable
• beta = compilación temprana para pruebas

​

How do I install the beta version and whats the difference between beta and dev

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

​

How long does install and onboarding usually take

• Instalación: 2–5 minutos
• Onboarding: 5–15 minutos según cuántos canales/modelos configure

​

How do I try the latest bits

1. Canal dev (checkout de git):

openclaw update --channel dev

2. Instalación hackable (desde el sitio del instalador):

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build

​

Installer stuck How do I get more feedback

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --verbose

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --beta --verbose

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose

# install.ps1 has no dedicated -Verbose flag yet.
Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0

​

Windows install says git not found or openclaw not recognized

• Instale Git for Windows y asegúrese de que git esté en su PATH.
• Cierre y vuelva a abrir PowerShell, luego vuelva a ejecutar el instalador.

• Su carpeta bin global de npm no está en PATH.
• Verifique la ruta:
  npm config get prefix
  
• Asegúrese de que <prefix>\\bin esté en PATH (en la mayoría de los sistemas es %AppData%\\npm).
• Cierre y vuelva a abrir PowerShell después de actualizar PATH.

​

The docs didnt answer my question how do I get a better answer

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

​

How do I install OpenClaw on Linux

• Ruta rápida de Linux + instalación del servicio: Linux.
• Recorrido completo: Primeros pasos.
• Instalador + actualizaciones: Instalación y actualizaciones.

​

How do I install OpenClaw on a VPS

​

Where are the cloudVPS install guides

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

​

Can I ask OpenClaw to update itself

openclaw update
openclaw update status
openclaw update --channel stable|beta|dev
openclaw update --tag <dist-tag|version>
openclaw update --no-restart

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

​

What does the onboarding wizard actually do

• Configuración de modelo/autenticación (recomendado setup-token de Anthropic para suscripciones Claude, compatible con OAuth de OpenAI Codex, claves de API opcionales, modelos locales LM Studio compatibles)
• Ubicación del espacio de trabajo + archivos de arranque
• Configuración del Gateway (enlace/puerto/autenticación/tailscale)
• Proveedores (WhatsApp, Telegram, Discord, Mattermost (plugin), Signal, iMessage)
• Instalación del demonio (LaunchAgent en macOS; unidad de usuario systemd en Linux/WSL2)
• Comprobaciones de salud y selección de skills

​

Do I need a Claude or OpenAI subscription to run this

​

Can I use Claude Max subscription without an API key

​

How does Anthropic setuptoken auth work

​

Where do I find an Anthropic setuptoken

claude setup-token

​

Do you support Claude subscription auth (Claude Pro or Max)

​

Why am I seeing HTTP 429 ratelimiterror from Anthropic

​

Is AWS Bedrock supported

​

How does Codex auth work

​

Do you support OpenAI subscription auth Codex OAuth

​

How do I set up Gemini CLI OAuth

1. Habilite el plugin: openclaw plugins enable google-gemini-cli-auth
2. Inicie sesión: openclaw models auth login --provider google-gemini-cli --set-default

​

Is a local model OK for casual chats

​

How do I keep hosted model traffic in a specific region

​

Do I have to buy a Mac Mini to install this

​

Do I need a Mac mini for iMessage support

• Ejecutar el Gateway en Linux/VPS y el servidor BlueBubbles en cualquier Mac con sesión iniciada en Mensajes.
• Ejecutar todo en el Mac si desea la configuración más simple en una sola máquina.

​

If I buy a Mac mini to run OpenClaw can I connect it to my MacBook Pro

• Gateway en el Mac mini (siempre encendido).
• MacBook Pro ejecuta la app de macOS o un host de nodo y se empareja con el Gateway.
• Use openclaw nodes status / openclaw nodes list para verlo.

​

Can I use Bun

​

Telegram what goes in allowFrom

• Envíe un DM a su bot y luego ejecute openclaw logs --follow y lea from.id.

• Envíe un DM a su bot y luego llame a https://api.telegram.org/bot<bot_token>/getUpdates y lea message.from.id.

• Envíe un DM a @userinfobot o @getidsbot.

​

Can multiple people use one WhatsApp number with different OpenClaw instances

​

Can I run a fast chat agent and an Opus for coding agent

​

Does Homebrew work on Linux

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

​

What’s the difference between the hackable git install and npm install

• Instalación hackable (git): checkout completo del código fuente, editable, ideal para contribuyentes. Usted ejecuta compilaciones localmente y puede modificar código/documentación.
• Instalación npm: instalación global de la CLI, sin repo, ideal para “solo ejecutarlo”. Las actualizaciones provienen de dist-tags de npm.

​

Can I switch between npm and git installs later

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
openclaw doctor
openclaw gateway restart

npm install -g openclaw@latest
openclaw doctor
openclaw gateway restart

​

Should I run the Gateway on my laptop or a VPS

• Pros: sin costo de servidor, acceso directo a archivos locales, ventana de navegador visible.
• Contras: suspensión/cortes de red = desconexiones, actualizaciones/reinicios del SO interrumpen, debe mantenerse despierta.

• Pros: siempre encendido, red estable, sin problemas de suspensión, más fácil de mantener en ejecución.
• Contras: a menudo headless (use capturas), acceso remoto a archivos, debe usar SSH para actualizaciones.

​

How important is it to run OpenClaw on a dedicated machine

• Host dedicado (VPS/Mac mini/Pi): siempre encendido, menos interrupciones por suspensión/reinicio, permisos más limpios, más fácil de mantener en ejecución.
• Laptop/desktop compartidos: totalmente bien para pruebas y uso activo, pero espere pausas cuando la máquina duerma o se actualice.

​

What are the minimum VPS requirements and recommended OS

• Mínimo absoluto: 1 vCPU, 1GB RAM, ~500MB de disco.
• Recomendado: 1–2 vCPU, 2GB RAM o más para margen (logs, medios, múltiples canales). Las herramientas de nodos y la automatización de navegador pueden consumir recursos.

​

Can I run OpenClaw in a VM and what are the requirements

• Mínimo absoluto: 1 vCPU, 1GB RAM.
• Recomendado: 2GB RAM o más si ejecuta múltiples canales, automatización de navegador o herramientas de medios.
• SO: Ubuntu LTS u otro Debian/Ubuntu moderno.

​

What is OpenClaw?

​

What is OpenClaw in one paragraph

​

What’s the value proposition

• Sus dispositivos, sus datos: ejecute el Gateway donde quiera (Mac, Linux, VPS) y mantenga el espacio de trabajo + historial de sesiones locales.
• Canales reales, no un sandbox web: WhatsApp/Telegram/Slack/Discord/Signal/iMessage/etc., además de voz móvil y Canvas en plataformas compatibles.
• Agnóstico de modelos: use Anthropic, OpenAI, MiniMax, OpenRouter, etc., con enrutamiento por agente y conmutación por error.
• Opción solo local: ejecute modelos locales para que todos los datos permanezcan en su dispositivo si lo desea.
• Enrutamiento multi‑agente: agentes separados por canal, cuenta o tarea, cada uno con su propio espacio de trabajo y valores predeterminados.
• Código abierto y hackable: inspeccione, extienda y auto‑aloje sin bloqueo de proveedor.

​

I just set it up what should I do first

• Construir un sitio web (WordPress, Shopify o un sitio estático simple).
• Prototipar una app móvil (esquema, pantallas, plan de API).
• Organizar archivos y carpetas (limpieza, nombres, etiquetas).
• Conectar Gmail y automatizar resúmenes o seguimientos.

​

What are the top five everyday use cases for OpenClaw

• Briefings personales: resúmenes del correo, calendario y noticias que le importan.
• Investigación y redacción: investigación rápida, resúmenes y primeros borradores para correos o documentos.
• Recordatorios y seguimientos: avisos y listas de verificación impulsadas por cron o heartbeat.
• Automatización de navegador: completar formularios, recopilar datos y repetir tareas web.
• Coordinación entre dispositivos: envíe una tarea desde su teléfono, deje que el Gateway la ejecute en un servidor y reciba el resultado en el chat.

​

Can OpenClaw help with lead gen outreach ads and blogs for a SaaS

​

What are the advantages vs Claude Code for web development

• Memoria persistente + espacio de trabajo entre sesiones
• Acceso multiplataforma (WhatsApp, Telegram, TUI, WebChat)
• Orquestación de herramientas (navegador, archivos, programación, hooks)
• Gateway siempre encendido (ejecute en un VPS, interactúe desde cualquier lugar)
• Nodos para navegador/pantalla/cámara/exec locales

​

Habilidades y automatización

​

¿Cómo personalizo las habilidades sin mantener el repositorio sucio

​

¿Puedo cargar habilidades desde una carpeta personalizada

​

Cómo puedo utilizar diferentes modelos para diferentes tareas

• Trabajos Cronales: trabajos aislados pueden establecer una anulación model por trabajo.
• Subagentes: enrutar tareas para separar agentes con diferentes modelos predeterminados.
• Interruptor a demanda: usa /model para cambiar el modelo de sesión actual en cualquier momento.

​

El bot se congela mientras realizo un trabajo pesado ¿Cómo puedo descargarlo

​

Cron o recordatorios no disparan ¿Qué debo comprobar

• Confirmar que cron está habilitado (cron.enabled) y OPENCLAW_SKIP_CRON no está definido.
• Compruebe que el Gateway está funcionando 24/7 (sin reiniciarse).
• Verifique la configuración de zona horaria para el trabajo (--tz vs zona horaria del host).

openclaw cron ejecuta <jobId> --force
openclaw cron ejecuta --id <jobId> --limit 50

​

¿Cómo puedo instalar habilidades en Linux

npm i -g clawhub

pnpm add -g clawhub

​

Puede OpenClaw ejecutar tareas en un programa o continuamente en segundo plano

• Trabajos cronales para tareas programadas o recurrentes (persisten entre reinicios).
• Heartbeat para comprobaciones periódicas de la “sesión principal”.
• Trabajos aislados para agentes autónomos que publican resúmenes o entregan a chats.

​

¿Puedo usar las habilidades de Apple macOS de Linux?

1. Crea un envoltorio SSH para el binario (ejemplo: memo para Notas de Apple):
   #!/usr/bin/env bash
   set -euo pipefail
   exec ssh -T user@mac-host /opt/homebrew/bin/memo "$@"
   
2. Pon el envoltorio en PATH en el host Linux (por ejemplo ~/bin/memo).
3. Anular los metadatos de habilidad (espacio de trabajo o ~/.openclaw/skills) para permitir Linux:
   ---
   name: apple-notes
   description: Manage Apple Notes via the memo CLI on macOS.
   metadata: { "openclaw": { "os": ["darwin", "linux"], "requires": { "bins": ["memo"] } } }
   ---
   
4. Comienza una nueva sesión para que las habilidades se actualizen.

​

¿Tienes una noción o integración de HeyGen

• Habilidad personalizada / plugin: mejor para un acceso confiable a la API (Notion/HeyGen ambos tienen APIs).
• Automatización del navegador: funciona sin código pero es más lento y frágil.

• Una página de noción por cliente (contexto + preferencias + trabajo activo).
• Pida al agente que busque esa página al inicio de una sesión.

clawhub instala <skill-slug>
clawhub update --all

​

¿Cómo instalo la extensión Chrome para la adquisición del navegador

openclaw browser extension install
openclaw browser extension path

​

Arenas de arena y memoria

​

Hay un documento de sandboxing dedicado

​

Docker se siente limitado ¿Cómo puedo habilitar todas las funciones

• Persista /home/node con OPENCLAW_HOME_VOLUME para que los cachés sobrevivan.
• Captura deps del sistema en la imagen con OPENCLAW_DOCKER_APT_PACKAGES.
• Instalar navegadores Playwright a través del CLI empaquetado: node /app/node_modules/playwright-core/cli.js install chromium
• Establece PLAYWRIGHT_BROWSERS_PATH y asegúrate de que la ruta persiste.

​

¿Cómo enlazo una carpeta host en el sandbox

​

Cómo funciona la memoria

• Notas diarias en memory/AAY-MM-DD.md
• Notas a largo plazo supervisadas en MEMORY.md (solo sesiones principal/privadas)

​

La memoria sigue olvidando las cosas cómo hacer que se pegue

​

La búsqueda semántica de memoria requiere una clave API OpenAI

​

¿La memoria persiste para siempre cuáles son los límites

​

Donde las cosas viven en el disco

​

Se utiliza todos los datos con OpenClaw guardados localmente

• Local por defecto: sesiones, archivos de memoria, configuración y espacio de trabajo en vivo en el host de Gateway (~/.openclaw + tu directorio de espacio de trabajo).
• Remoto por necesidad: mensajes que envías a los proveedores de modelos (Anthropic/OpenAI/etc.) ir a sus APIs, y plataformas de chat (WhatsApp/Telegram/Slack/etc.) almacenar los datos de los mensajes en sus servidores .
• Controla la huella: El uso de modelos locales mantiene indicaciones en tu máquina, pero el tráfico del canal sigue pasando por los servidores del canal.

​

¿Dónde almacena sus datos OpenClaw

​

¿Dónde debe vivir AGENTsmalld SOULmd USERmd MEMORYmd

• Espacio de trabajo (por agente): AGENTS.md, SOUL.md, IDENTITY.md, USER.md, MEMORY.md (o memory.md), memory/YYY-MM-DD.md, opcional HEARTBEAT.md.
• Directorio de estado (~/.openclaw): configuración, credenciales, perfiles de auth, sesiones, registros, y habilidades compartidas (~/.openclaw/skills).

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}

​

¿Cuál es la estrategia de copia de seguridad recomendada

​

¿Cómo desinstalo completamente OpenClaw

​

Los agentes pueden trabajar fuera del área de trabajo

{
  agents: {
    defaults: {
      workspace: "~/Projects/my-repo",
    },
  },
}

​

Estoy en modo remoto donde está el almacén de sesiones

​

Configurar conceptos básicos

​

¿Qué formato es la configuración dónde está

$OPENCLAW_CONFIG_PATH

​

Establezco lan o tailnet de gatewaybind y ahora nada escucha la interfaz de usuario dice no autorizado

{
  gateway: {
    bind: "lan",
    auth: {
      mode: "token",
      token: "replace-me",
    },
  },
}

• gateway.remote.token es sólo para llamadas remotas a CLI; no habilita la autenticación local de la puerta de enlace.
• El Control UI se autentifica a través de connect.params.auth.token (almacenado en la configuración de la aplicación/UI). Evita poner tokens en URLs.

​

¿Por qué necesito un token en localhost ahora

​

Tengo que reiniciar después de cambiar la configuración

• gateway.reload.mode: "hybrid" (por defecto): caliente aplicar cambios seguros, reiniciar para los críticos
• hot, restart, off también están soportados

​

¿Cómo puedo activar la búsqueda y búsqueda web

{
  tools: {
    web: {
      search: {
        enabled: true,
        apiKey: "BRAVE_API_KEY_HERE",
        resultados máximos: 5,
      },
      hetch: {
        enabled: true,
      },
    },
  },
}

• Si utiliza listas permitidas, agregue web_search/web_fetch o group:web.
• web_fetch está habilitado de forma predeterminada (a menos que se deshabilite explícitamente).
• Daemons read env vars from ~/.openclaw/.env (or the service environment).

​

¿Cómo puedo ejecutar una pasarela central con trabajadores especializados a través de dispositivos

• Gateway (central): posee canales (Signal/WhatsApp), enrutamiento y sesiones.
• Nodos (devices): Macs/iOS/Android conectan como periféricos y exponen herramientas locales (system.run, canvas, camera).
• Agentes (trabajadores): separados brains/espacios de trabajo para roles especiales (por ejemplo, “Hetzner ops”, “Datos personales”).
• Subagentes: el fondo de aparición de un agente principal cuando quieres paralelismo.
• TUI: conéctate a la pasarela y cambia de agentes/sesiones.

​

Puede el navegador OpenClaw correr sin cabeza

{
  browser: { headless: true },
  agents: {
    defaults: {
      sandbox: { browser: { headless: true } },
    },
  },
}

• No hay ninguna ventana visible del navegador (use capturas de pantalla si necesita visuales).
• Algunos sitios son más estrictos sobre la automatización en modo sin cabeza (CAPTCHAs, anti-bot). Por ejemplo, X/Twitter a menudo bloquea las sesiones sin cabeza.

​

Cómo uso Brave para el control del navegador

​

Pasarelas y nodos remotos

​

Cómo se propagan los comandos entre Telegram la puerta de enlace y los nodos

​

¿Cómo puede mi agente acceder a mi equipo si el Gateway está alojado de forma remota?

1. Ejecute el Gateway en el host siempre encendido (servidor VPS/casa).
2. Ponga la anfitriona de la pasarela + su computadora en la misma tailnet.
3. Asegúrese de que la pasarela WS es accesible (enlace de tailnet o túnel SSH).
4. Abre la aplicación macOS localmente y conéctate en modo Remoto a través de SSH (o tailnet directo) para que pueda registrarse como nodo.
5. Aprobar el nodo en la puerta de enlace:
   openclaw nodes pending
   openclaw nodes approve <requestId>
   

​

La escala de escape está conectada, pero no obtengo respuestas que ahora

• Gateway se está ejecutando: openclaw gateway status
• Salud de la puerta de enlace: openclaw status
• Salud del canal: estatus de canales de openclaw

• Si utilizas la escala de envergadura, asegúrate de que gateway.auth.allow scale esté configurado correctamente.
• Si se conecta a través del túnel SSH, confirmar que el túnel local está arriba y apunta al puerto derecho.
• Confirme sus listas de permisos (DM o grupo) incluyen su cuenta.

​

Puedes dos instancias OpenClaw hablar entre sí con VPS local

openclaw agent --message "Hola desde el bot local" --deliver --channel telegram --reply-to <chat-id>

​

Necesito VPN separadas para múltiples agentes

​

¿Hay un beneficio para usar un nodo en mi portátil personal en lugar de SSH desde un VPS

• No se requiere SSH entrante. Los nodos se conectan con el WebSocket de Gateway y utilizan el emparejamiento de dispositivos.
• Controles de ejecución más seguros. system.run está bloqueado por listas/aprobaciones de node en ese portátil.
• Más herramientas de dispositivo. Los nodos exponen canvas, camera y screen además de system.run.
• **Automatización local del navegador. * Mantener el Gateway en una VPS, pero ejecuta Chrome localmente y transfiere el control con la extensión Chrome + un host de nodo en la computadora portátil.

​

Debería instalar en un segundo portátil o simplemente añadir un nodo

​

Los nodos ejecutan un servicio de gateway

​

Hay una forma RPC API para aplicar la configuración

​

configapply borrado mi configuración ¿Cómo puedo recuperarme y evitar esto

• Restaurar desde una copia de seguridad (git o un ~/.openclaw/openclaw.json).
• Si no tienes copia de seguridad, vuelve a ejecutar openclaw doctor y reconfigura canales/modelos.
• Si esto era inesperado, archive un error e incluya su última configuración conocida o cualquier copia de seguridad.
• Un agente de codificación local a menudo puede reconstruir una configuración de trabajo a partir de registros o historial.

• Usa openclaw config set para pequeños cambios.
• Usa openclaw configure para ediciones interactivas.

​

Qué es una configuración mínima para una primera instalación

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

​

¿Cómo establezco escala en un VPS y me conecto desde mi Mac

1. Instalar + iniciar sesión en la VPS
   curl -fsSL https://tailscale.com/install.sh | sh
   sudo tailscale up
   
2. Instala + inicia sesión en tu Mac
   • Utiliza la aplicación de escala e inicia sesión en la misma red.
3. Habilitar MagicDNS (recomendado)
   • En la consola de administración de escala alta, habilite MagicDNS para que el VPS tenga un nombre estable.
4. Usa el nombre de host tailnet
   • SSH: ssh [email protected]
   • Portal WS: ws://your-vps.tailnet-xxxx.ts.net:18789

openclaw gateway --tailscale serve

​

¿Cómo puedo conectar un nodo Mac a una remota escala de Gateway Serve

1. Asegúrate de que el VPS + Mac estén en la misma tailnet.
2. Usa la aplicación macOS en modo remoto (SSH objetivo puede ser el nombre de host tailnet). La aplicación túnel el el puerto Gateway y se conectará como un nodo.
3. Aprobar el nodo en la puerta de enlace:
   openclaw nodes pending
   openclaw nodes approve <requestId>
   

​

Carga de Env vars y .env

​

¿Cómo carga OpenClaw las variables de entorno

• .env desde el directorio de trabajo actual
• un respaldo global .env desde ~/.openclaw/.env (también conocido como $OPENCLAW_STATE_DIR/.env)

{
  env: {
    OPENROUTER_API_KEY: "sk-or-...",
    vars: { GROQ_API_KEY: "gsk-..." },
  },
}

​

Empecé la puerta de enlace a través del servicio y mi env varas desapareció Lo que ahora

1. Pon las claves faltantes en ~/.openclaw/.env así que son recogidas incluso cuando el servicio no hereda tu shell env.
2. Habilitar importación de shell (conveniencia opt-in):

{
  env: {
    shellEnv: {
      enabled: true,
      timeoutMs: 15000,
    },
  },
}

​

Establezco COPILOTGITHUBTOKEN pero el estado de los modelos muestra Shell env apagado por qué

1. Pon el token en ~/.openclaw/.env:
   COPILOT_GITHUB_TOKEN=...
   
2. O habilite la importación de shell (env.shellEnv.enabled: true).
3. O añádelo a tu bloque env de configuración (aplica sólo si falta).

openclaw models status

​

Sesiones y múltiples chats

​

Cómo comienzo una conversación nueva

​

Reiniciar sesiones automáticamente si nunca envío nuevas

{
  sesión: {
    idleMinutes: 240,
  },
}

​

Hay una manera de crear un equipo de instancias OpenClaw de un CEO y muchos agentes

​

¿Por qué el contexto se truncó la mitad de la tarea ¿Cómo lo prevengo

• Pida al bot que resuma el estado actual y lo escriba en un archivo.
• Usa /compact antes de tareas largas, y /new al cambiar temas.
• Mantener un contexto importante en el área de trabajo y pedir al bot que lo lea de nuevo.
• Utilice subagentes para el trabajo largo o paralelo para que el chat principal permanezca más pequeño.
• Escoja un modelo con una ventana contextual más grande si esto sucede a menudo.

​

¿Cómo reinicio completamente OpenClaw pero mantenlo instalado

openclaw reset

openclaw reset --scope full --yes --non-interactive

openclaw onboard --install-daemon

• El asistente de incorporación también ofrece Reiniciar si ve una configuración existente. Ver Wizard.
• Si usaste perfiles (--profile / OPENCLAW_PROFILE), reinicia cada directorio de estado (por defecto son ~/.openclaw-<profile>).
• Dev reset: openclaw gateway --dev --reset (sólo dev; wipes dev config + credenciales + sesiones + espacio de trabajo).

​

Estoy obteniendo errores de contexto demasiado grandes como reinicio o compacto

• Compacto (mantiene la conversación pero resume giros antiguos):
  /compacto
  
  o /compact <instructions> para guiar el resumen.
• Reiniciar (ID de sesión fresca para la misma clave de chat):
  /new
  /reset
  

• Activa o sintoniza la poda de sesión (agents.defaults.contextPruning) para recortar la antigua salida de herramientas.
• Utilice un modelo con una ventana contextual más grande.

​

¿Por qué veo la solicitud LLM rechazada por mensajesNcontentXtooluseinput Campo requerido

​

¿Por qué estoy recibiendo mensajes con latidos cardiacos cada 30 minutos

{
  agents: {
    defaults: {
      heartbeat: {
        cada: "2h", // o "0m" para desactivar
      },
    },
  },
}

​

Necesito añadir una cuenta de bot a un grupo de WhatsApp

{
  canales: {
    whatsapp: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

​

¿Cómo obtengo el JID de un grupo de WhatsApp

logs de openclaw --follow --json

lista de grupos de directorio de openclaw --channel whatsapp

​

¿Por qué no responde OpenClaw en un grupo

• La compuerta de menciones está activada (por defecto). Debes @mention el bot (o coincidir con mentionPatterns).
• Has configurado channels.whatsapp.groups sin "*" y el grupo no está permitido.

​

Hacer grupos compartir contexto con DMs

​

Cuántas áreas de trabajo y agentes puedo crear

• Crecimiento del disco: sesiones + transcripciones en vivo bajo ~/.openclaw/agents/<agentId>/sessions/.
• Coste del token: más agentes significa un uso más simultáneo del modelo.
• Ops overhead: por agente perfiles de autor, espacios de trabajo y enrutamiento de canales.

• Mantén un espacio de trabajo activo por agente (agents.defaults.workspace).
• Limpiar sesiones antiguas (borrar JSONL o almacenar entradas) si el disco crece.
• Usa openclaw doctor para detectar espacios de trabajo perdidos y desajustes en el perfil.

​

¿Puedo ejecutar varios bots o chats al mismo tiempo Slack y cómo debería configurarlo

• Anfitrión de Gateway siempre activo (VPS/Mac mini).
• Un agente por rol (enlaces).
• Canal(es) Slack vinculados a esos agentes.
• Navegador local vía relé de extensión (o un nodo) cuando sea necesario.

​

Modelos: predeterminados, selección, alias, cambio

​

¿Cuál es el modelo por defecto

agents.defaults.model.primary

​

Qué modelo recomiendas

​

Puedo usar modelos autoalojados llamacpp vLM Ollama

​

¿Cómo puedo cambiar de modelo sin borrar mi configuración

• /model en el chat (rápido, por sesión)
• openclaw models set ... (actualizaciones sólo configuración del modelo)
• openclaw configure --section model (interactivo)
• edita agents.defaults.model en ~/.openclaw/openclaw.json

​

¿Qué utilizan OpenClaw, Flawd y Krill para modelos

• OpenClaw + Flawd: Opus antropico (antropic/claude-op✫ 4-6) - ver Anthropic.
• Krill: MiniMax M2.1 (minimax/MiniMax-M2.1) - see MiniMax.

​

¿Cómo puedo cambiar los modelos en marcha sin reiniciar

/model sonnet
/model haiku
/model opus
/model gpt
/model gpt-mini
/model gemini
/model gemini-flash

/modelo 3

/model opus@anthropic:default
/model opus@anthropic:work

/model anthropic/claude-op✫ 4-6

​

¿Puedo usar GPT 5.2 para tareas diarias y Codex 5.3 para la codificación

• Interruptor rápido (por sesión): /model gpt-5.2 para tareas diarias, /model gpt-5.3-codex para la codificación.
• Por defecto + switch: establece agents.defaults.model.primary a openai/gpt-5.2, luego cambia a openai-codex/gpt-5.3-codex al codificar (o al revés).
• Subagentes: enrutar tareas de codificación a subagentes con un modelo predeterminado diferente.

​

¿Por qué veo Modelo no está permitido y luego no hay respuesta

Model "provider/model" is not allowed. Use /model to list available models.

​

¿Por qué veo modelo desconocido minimaxMiniMaxM21

1. Actualice a 2026.1.12 (o ejecute desde la fuente main), luego reinicie la puerta de enlace.
2. Asegúrese de que MiniMax está configurado (asistente o JSON), o que existe una clave API MiniMax en los perfiles de env/auth para que el proveedor pueda ser inyectado.
3. Usa el id del modelo exacto (sensible a mayúsculas/minúsculas): minimax/MiniMax-M2.1 o minimax/MiniMax-M2.1-lightning.
4. Run:
   openclaw models list
   
   y escoja de la lista (o /model list en el chat).

​

¿Puedo usar MiniMax como mi predeterminado y OpenAI para tareas complejas

{
  env: { MINIMAX_API_KEY: "sk-...", OPENAI_API_KEY: "sk-... },
  agents: {
    defaults: {
      model: { primary: "minimax/MiniMax-M2. " },
      modelos: {
        "minimax/MiniMax-M2. ": { alias: "minimax" },
        "openai/gpt-5. ": { alias: "gpt" },
      },
    },
  },
}

/model gpt

• Agente un predeterminado: MiniMax
• Agente B por defecto: OpenAI
• Ruta por agente o usa /agent para cambiar

​

Son accesos directos integrados por opus sonnet

• opus → antropic/claude-op→ 4-6
• sonnet → antropic/claude-sonnet-4-5
• gpt → openai/gpt-5.2
• gpt-mini → openai/gpt-5-mini
• gemini → google/gemini-3-pro-preview
• gemini-flash → google/gemini-3-flash-preview

​

¿Cómo defino el alias de los atajos de modelo

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opichard 4-6" },
      modelos: {
        "anthropic/claude-opichard 4-6": { alias: "opus" },
        "antropic/claude-sonnet-4-5": { alias: "sonnet" },
        "antropic/claude-haiku-4-5": { alias: "haiku" },
      },
    },
  },
}

​

¿Cómo puedo añadir modelos de otros proveedores como OpenRouter o ZAI

{
  agents: {
    defaults: {
      model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
      modelos: { "openrouter/anthropic/claude-sonnet-4-5": {} },
    },
  },
  env: { OPENROUTER_API_KEY: "sk-or-. ." },
}

{
  agents: {
    defaults: {
      model: { primary: "zai/glm-4. " },
      modelos: { "zai/glm-4. ": {} },
    },
  },
  env: { ZAI_API_KEY: "..." },
}

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

• Ejecuta openclaw agents add <id> y configure la autenticación durante el asistente.
• O copia auth-profiles.json del agente principal agentDir en el nuevo agente agentDir.

​

Modelo de tolerancia contra fallos y “Todos los modelos fallidos”

​

Cómo funciona la tolerancia contra fallos

1. Rotación de perfil de autorización dentro del mismo proveedor.
2. Fallback de modelos al siguiente modelo en agents.defaults.model.fallbacks.

​

Qué significa este error

No se encontraron credenciales para el perfil "anthropic:default"

​

Corregir lista de verificación para No se encontraron credenciales para el perfil antroppicdefault

• Confirma dónde viven los perfiles de autor (nuevas vs rutas heredadas)
  • Actual: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • Legancia: ~/.openclaw/agent/* (migrado por openclaw doctor)
• **Confirma que la variable env está cargada por la pasarela **
  • Si establece ANTHROPIC_API_KEY en su shell pero ejecuta el Gateway vía systemd/launchd, no puede heredarlo. Colócalo en ~/.openclaw/.env o habilite env.shellEnv.
• Asegúrate de que estás editando el agente correcto
  • Configuraciones multiagente significan que puede haber múltiples archivos auth-profiles.json.
• Estado del modelo/autenticación de comprobación de anidades
  • Usa openclaw models status para ver los modelos configurados y si los proveedores están autenticados.

• Usa un token de configuración
  • Ejecuta claude setup-token, luego pégalo con openclaw models auth setup-token --provider anthropic.
  • Si el token fue creado en otra máquina, use openclaw models auth paste-token --provider anthropic.
• Si quieres usar una clave API en su lugar
  • Pon ANTHROPIC_API_KEY en ~/.openclaw/.env en el host de puerta de enlace.
  • Limpia cualquier orden fijada que obligue a perder un perfil:
    modelos de openclaw auth order clear --provider anthropic
    
• Confirma que estás ejecutando comandos en el host del concentrador
  • En modo remoto, los perfiles de autenticación viven en la máquina puerta de enlace, no en su portátil.

​

¿Por qué lo hizo también probar Google Gemini y fallar

​

Perfiles de autor: qué son y cómo gestionarlos

​

Qué es un perfil de autenticación

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

​

Qué son los IDs de perfil típicos

• anthropic:default (común cuando no existe identidad de correo electrónico)
• antropía:<email> para identidades de OAuth
• IDs personalizados que elijas (p. ej., anthropic:work)

​

¿Puedo controlar qué perfil de autenticación se prueba primero

# Por defecto el agente predeterminado configurado (omit --agent)
openclaw models auth order get --provider anthropic

# Bloquea la rotación a un solo perfil (solo prueba este)
openclaw models auth order set --provider anthropic:default

# O establece un pedido explícito (respaldo dentro del proveedor)
openclaw model auth order set --provider anthropic:work anthropic:default

# Borrar la anulación (caer de vuelta a la autenticación de configuración). rder / round-robin)
modelos de openclaw auth order clear --provider anthropic

modelo de openclaw auth order set --provider anthropic --agent main anthropic:default

​

La clave OAuth vs API es la diferencia

• OAuth a menudo aprovecha el acceso a la suscripción (si es aplicable).
• Las claves de API usan facturación de pay-per-token.

​

Puerta de enlace: puertos, “ya en ejecución” y modo remoto

​

Qué puerto utiliza la puerta de enlace

--port > OPENCLAW_GATEWAY_PORT > gateway.port > por defecto 18789

​

¿Por qué el estado de openclaw gateway dice Ejecutar tiempo pero la sonda RPC falló

• Destino de sonda: (la URL que la sonda utiliza realmente)
• Escuchando: (lo que está realmente vinculado en el puerto)
• Último error de puerta de enlace: (causa raíz común cuando el proceso está vivo pero el puerto no está escuchando)

​

¿Por qué el estado de la pasarela de openclaw muestra el servicio Config cli y Config diferente

openclaw gateway install --force

​

¿Qué significa otra instancia de gateway ya está escuchando

​

¿Cómo ejecutar OpenClaw en cliente de modo remoto se conecta a un Gateway en otro lugar

{
  gateway: {
    mode: "remote",
    remote: {
      url: "ws://gateway.tailnet:18789",
      token: "your-token",
      password: "your-password",
    },
  },
}

• openclaw gateway sólo se inicia cuando gateway.mode es local (o pasas la bandera overwrite).
• La aplicación macOS observa el archivo de configuración y cambia los modos en vivo cuando estos valores cambian.

​

La interfaz de control dice no autorizado o sigue reconectando lo que ahora

• La interfaz de control almacena el token en la clave de almacenamiento local del navegador openclaw.control.settings.v1.

• Más rápido: openclaw dashboard (imprime + copia la URL del tablero, intenta abrir; muestra la pista SSH si no tiene cabeza).
• Si aún no tienes un token: openclaw doctor --generate-gateway-token.
• If remote, tunnel first: ssh -N -L 18789:127.0.0.1:18789 user@host then open http://127.0.0.1:18789/.
• Establece gateway.auth.token (o OPENCLAW_GATEWAY_TOKEN) en el host de la puerta de enlace.
• En la configuración de la interfaz de Control, pegue el mismo token.
• ¿Aún atascado? Ejecuta openclaw status --all y sigue Troubleshooting. Ver Dashboard para más detalles.

​

Establezco red de enlace pero no puedo enlazar nada escucha

• Iniciar escala en ese host (por lo que tiene una dirección 100.x), o
• Cambia a gateway.bind: "loopback" / "lan".

​

¿Puedo ejecutar múltiples pasarelas en el mismo host

• OPENCLAW_CONFIG_PATH (configuración por instancia)
• OPENCLAW_STATE_DIR (estado por instancia)
• agents.defaults.workspace (aislamiento del espacio de trabajo)
• gateway.port (puertos únicos)

• Usa openclaw --profile <name> … por instancia (auto-creates ~/.openclaw-<name>).
• Establece un gateway.port único en cada configuración de perfil (o pasa --port para ejecuciones manuales).
• Install a per-profile service: openclaw --profile <name> gateway install.

​

¿Qué significa el código 1008 de agitador de manos inválido

• Has abierto la URL HTTP en un navegador (http://...) en lugar de un cliente WS.
• Utilizaste el puerto o ruta incorrectos.
• Un proxy o túnel despojó cabeceras de autenticación o envió una petición no Gateway.

1. Usa la URL WS: ws://<host>:18789 (o wss://... if HTTPS).
2. No abra el puerto WS en una pestaña normal del navegador.
3. Si la autenticación está activada, incluya el token/password en el marco connect.

openclaw tui --url ws://<host>:18789 --token <token>

​

Registro y depuración

​

Dónde están los registros

/tmp/openclaw/openclaw-YYYY-MM-DD.log

openclaw logs --follow

• macOS: $OPENCLAW_STATE_DIR/logs/gateway.log y gateway.err.log (por defecto: ~/.openclaw/logs/...; los perfiles usan ~/.openclaw-<profile>/logs/...)
• Linux: journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager
• Windows: schtasks /Query /TN "OpenClaw Gateway (<profile>)" /V /FO LIST

​

¿Cómo empiezo el servicio Gateway

estado de la puerta de enlace de openclaw
reinicio de la puerta de enlace

​

Cerré mi terminal en Windows cómo reinicio OpenClaw

wsl
openclaw gateway status
reinicio de openclaw gateway

openclaw gateway run

estado de la puerta de enlace de openclaw
reinicio de la puerta de enlace

openclaw gateway run

​

La puerta de enlace está arriba pero las respuestas nunca llegan Lo que debería comprobar

openclaw status
openclaw models status
openclaw channels status
openclaw logs --follow

• La autenticación del modelo no se cargó en el host de la puerta de enlace (compruebe model status).
• Emparejamiento de canales/lista permitida bloqueando respuestas (compruebe la configuración del canal + registros).
• WebChat/Panel de control está abierto sin el token correcto.

​

Desconectado de la puerta de enlace no hay razón para lo que ahora

1. ¿Está funcionando la puerta de enlace? openclaw gateway status
2. ¿La pasarela está sana? openclaw status
3. ¿Tiene la IU el código correcto? openclaw dashboard
4. Si es remoto, ¿está el túnel/escala hacia arriba?

openclaw logs --follow

​

Telegram setMyCommands falla con errores de red ¿Qué debo comprobar

estado de canales de openclaw
canales de openclaw logs --channel telegram

​

TUI no muestra salida ¿Qué debo comprobar

openclaw status
openclaw models status
openclaw logs --follow

​

¿Cómo me detengo completamente entonces iniciar el Gateway

puerta de enlace openclaw stop
inicio de la puerta de enlace openclaw

openclaw gateway run

​

Reiniciar la puerta de enlace de openclaw ELI5 vs puerta de enlace de openclaw

• openclaw gateway restart: reinicia el servicio de fondo (launchd/systemd).
• puerta de enlace openclaw: ejecuta la puerta de enlace en el primer plano para esta sesión de terminal.

​

¿Cuál es la forma más rápida de obtener más detalles cuando algo falle

​

Multimedia y archivos adjuntos

​

Mi habilidad generó una imagen PDF pero no se envió nada

mensaje de openclaw enviar --target +155550123 --message "Here you go" --media /path/to/file.png

• El canal de destino soporta medios salientes y no está bloqueado por listas permitidas.
• El archivo está dentro de los límites de tamaño del proveedor (las imágenes se redimensionan hasta máximo 2048px).

​

Control de seguridad y acceso

​

Es seguro exponer OpenClaw a DMs entrantes

• El comportamiento por defecto en los canales compatibles con DM está emparejando:
  • Los remitentes desconocidos reciben un código de emparejamiento; el bot no procesa su mensaje.
  • Aprobar con: emparejamiento de openclaw aprobar <channel> <code>
  • Las solicitudes pendientes tienen un límite de 3 por canal; comprueba la lista de emparejamiento de openclaw <channel> si un código no llegó.
• Abrir DMs públicamente requiere opt-in explícito (dmPolicy: "open" y allowlist `”*”).

​

Es la inyección rápida sólo una preocupación para los robots públicos

• usando un agente de “lector” de sólo lectura o de herramientas desactivadas para resumir contenido no confiable
• mantener desconectado web_search / web_fetch / browser para agentes habilitados por herramientas
• sandboxing y listas de herramientas estrictas

​

Mi bot debería tener su propia cuenta o número de teléfono de GitHub de correo electrónico

​

¿Puedo darle autonomía sobre mis mensajes de texto y es tan seguro

• Mantenga las DMs en modo de emparejamiento o en una lista de permitidos ajustada.
• Usa un número o cuenta separada si quieres que te envíe un mensaje en tu nombre.
• Deje que borre, luego apruebe antes de enviar.

​

¿Puedo usar modelos más baratos para tareas personales de asistente

​

Corre el inicio en Telegram pero no conseguí un código de emparejamiento

openclaw pairing list telegram

​

WhatsApp enviará mensajes a mis contactos ¿Cómo funciona el emparejamiento

openclaw pairing approve whatsapp <code>

openclaw pairing list whatsapp

​

Comandos de chat, abortando tareas, y “no se detendrá”

​

¿Cómo puedo evitar que los mensajes del sistema interno se muestren en el chat

/verbose
/reasoning off

​

¿Cómo dejo de cancelar una tarea en ejecución

detener
abortar
esc
esperar
salir
interrumpir

proceso acción:matar sessionId:XXX

​

¿Cómo puedo enviar un mensaje de Discord desde Telegram Crosscontext denegado

{
  agents: {
    defaults: {
      tools: {
        message: {
          crossContext: {
            allowAcrossProviders: true, Marcador de
            : { habilitado: true, prefijo: "[de {channel}] " },
          },
        },
      },
    },
  },
}

​

¿Por qué se siente que el bot ignora los mensajes de fuego rápido

• steer - nuevos mensajes redireccionan la tarea actual
• seguimiento - ejecuta mensajes uno a la vez
• collect - agrupar mensajes y responder una vez (por defecto)
• steer-backlog - dirige ahora, luego procesa backlog
• interrumpido - aborta la ejecución actual e inicia fresco

​

Responder a la pregunta exacta de la captura de pantalla/registro de chat