Guides

Configuración del asistente personal

OpenClaw es un Gateway autoalojado que conecta Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo y más con agentes de IA. Esta guía cubre la configuración de "asistente personal": un número dedicado de WhatsApp que se comporta como tu asistente de IA siempre activo.

⚠️ Seguridad primero

Estás poniendo a un agente en posición de:

ejecutar comandos en tu máquina (según tu política de herramientas)
leer/escribir archivos en tu espacio de trabajo
enviar mensajes de vuelta mediante WhatsApp/Telegram/Discord/Mattermost y otros canales incluidos

Empieza de forma conservadora:

Define siempre channels.whatsapp.allowFrom (nunca lo ejecutes abierto al mundo en tu Mac personal).
Usa un número dedicado de WhatsApp para el asistente.
Los Heartbeats ahora se ejecutan de forma predeterminada cada 30 minutos. Desactívalos hasta que confíes en la configuración definiendo agents.defaults.heartbeat.every: "0m".

Requisitos previos

OpenClaw instalado e incorporado; consulta Primeros pasos si aún no lo has hecho
Un segundo número de teléfono (SIM/eSIM/prepago) para el asistente

La configuración con dos teléfonos (recomendada)

Quieres esto:

flowchart TB
    A["<b>Your Phone (personal)
</b>
Your WhatsApp
+1-555-YOU"] -- message --> B["<b>Second Phone (assistant)
</b>
Assistant WA
+1-555-ASSIST"]
    B -- linked via QR --> C["<b>Your Mac (openclaw)
</b>
AI agent"]

Si vinculas tu WhatsApp personal con OpenClaw, cada mensaje que recibas se convierte en "entrada del agente". Eso rara vez es lo que quieres.

Inicio rápido en 5 minutos

Empareja WhatsApp Web (muestra un QR; escanéalo con el teléfono del asistente):

openclaw channels login

Inicia el Gateway (déjalo en ejecución):

openclaw gateway --port 18789

Coloca una configuración mínima en ~/.openclaw/openclaw.json:

{
  gateway: { mode: "local" },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

Ahora envía un mensaje al número del asistente desde tu teléfono incluido en la lista de permitidos.

Cuando finaliza la incorporación, OpenClaw abre automáticamente el panel e imprime un enlace limpio (no tokenizado). Si el panel solicita autenticación, pega el secreto compartido configurado en la configuración de Control UI. La incorporación usa un token de forma predeterminada (gateway.auth.token), pero la autenticación con contraseña también funciona si cambiaste gateway.auth.mode a password. Para volver a abrirlo más tarde: openclaw dashboard.

Dale al agente un espacio de trabajo (AGENTS)

OpenClaw lee las instrucciones operativas y la "memoria" desde su directorio de espacio de trabajo.

De forma predeterminada, OpenClaw usa ~/.openclaw/workspace como espacio de trabajo del agente y lo creará (junto con los archivos iniciales AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md) automáticamente durante la configuración o la primera ejecución del agente. BOOTSTRAP.md solo se crea cuando el espacio de trabajo es completamente nuevo (no debería volver después de que lo elimines). MEMORY.md es opcional (no se crea automáticamente); cuando está presente, se carga para sesiones normales. Las sesiones de subagentes solo inyectan AGENTS.md y TOOLS.md.

openclaw setup

Diseño completo del espacio de trabajo + guía de copias de seguridad: Espacio de trabajo del agente Flujo de trabajo de memoria: Memoria

Opcional: elige un espacio de trabajo diferente con agents.defaults.workspace (admite ~).

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

Si ya distribuyes tus propios archivos de espacio de trabajo desde un repositorio, puedes desactivar por completo la creación de archivos de arranque:

{
  agents: {
    defaults: {
      skipBootstrap: true,
    },
  },
}

La configuración que lo convierte en "un asistente"

OpenClaw usa de forma predeterminada una buena configuración de asistente, pero normalmente querrás ajustar:

la personalidad/instrucciones en SOUL.md
los valores predeterminados de razonamiento (si lo deseas)
los Heartbeats (cuando confíes en ello)

Ejemplo:

{
  logging: { level: "info" },
  agent: {
    model: "anthropic/claude-opus-4-6",
    workspace: "~/.openclaw/workspace",
    thinkingDefault: "high",
    timeoutSeconds: 1800,
    // Start with 0; enable later.
    heartbeat: { every: "0m" },
  },
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true },
      },
    },
  },
  routing: {
    groupChat: {
      mentionPatterns: ["@openclaw", "openclaw"],
    },
  },
  session: {
    scope: "per-sender",
    resetTriggers: ["/new", "/reset"],
    reset: {
      mode: "daily",
      atHour: 4,
      idleMinutes: 10080,
    },
  },
}

Sesiones y memoria

Archivos de sesión: ~/.openclaw/agents/<agentId>/sessions/{{SessionId}}.jsonl
Metadatos de sesión (uso de tokens, última ruta, etc.): ~/.openclaw/agents/<agentId>/sessions/sessions.json (heredado: ~/.openclaw/sessions/sessions.json)
/new o /reset inicia una sesión nueva para ese chat (configurable mediante resetTriggers). Si se envía solo, OpenClaw confirma el reinicio sin invocar el modelo.
/compact [instructions] compacta el contexto de la sesión e informa el presupuesto de contexto restante.

Heartbeats (modo proactivo)

De forma predeterminada, OpenClaw ejecuta un Heartbeat cada 30 minutos con el prompt: Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK. Define agents.defaults.heartbeat.every: "0m" para desactivarlo.

Si HEARTBEAT.md existe pero está efectivamente vacío (solo líneas en blanco y encabezados markdown como # Heading), OpenClaw omite la ejecución del Heartbeat para ahorrar llamadas a la API.
Si falta el archivo, el Heartbeat se ejecuta igualmente y el modelo decide qué hacer.
Si el agente responde con HEARTBEAT_OK (opcionalmente con un relleno corto; consulta agents.defaults.heartbeat.ackMaxChars), OpenClaw suprime la entrega saliente de ese Heartbeat.
De forma predeterminada, se permite la entrega de Heartbeat a destinos de estilo DM user:<id>. Define agents.defaults.heartbeat.directPolicy: "block" para suprimir la entrega a destinos directos mientras mantienes activas las ejecuciones de Heartbeat.
Los Heartbeats ejecutan turnos completos del agente; los intervalos más cortos consumen más tokens.

{
  agent: {
    heartbeat: { every: "30m" },
  },
}

Medios de entrada y salida

Los adjuntos entrantes (imágenes/audio/documentos) pueden exponerse a tu comando mediante plantillas:

{{MediaPath}} (ruta de archivo temporal local)
{{MediaUrl}} (pseudo-URL)
{{Transcript}} (si la transcripción de audio está activada)

Adjuntos salientes del agente: incluye MEDIA:<path-or-url> en su propia línea (sin espacios). Ejemplo:

Here's the screenshot.
MEDIA:https://example.com/screenshot.png

OpenClaw los extrae y los envía como medios junto con el texto.

El comportamiento de rutas locales sigue el mismo modelo de confianza de lectura de archivos que el agente:

Si tools.fs.workspaceOnly es true, las rutas locales salientes de MEDIA: permanecen restringidas a la raíz temporal de OpenClaw, la caché de medios, las rutas del espacio de trabajo del agente y los archivos generados por sandbox.
Si tools.fs.workspaceOnly es false, MEDIA: saliente puede usar archivos locales del host que el agente ya tiene permitido leer.
Las rutas locales pueden ser absolutas, relativas al espacio de trabajo o relativas al directorio personal con ~/.
Los envíos locales del host siguen permitiendo solo medios y tipos de documentos seguros (imágenes, audio, video, PDF y documentos de Office). Los archivos de texto plano y con apariencia de secreto no se tratan como medios enviables.

Eso significa que las imágenes/archivos generados fuera del espacio de trabajo ahora pueden enviarse cuando tu política de fs ya permite esas lecturas, sin reabrir la exfiltración arbitraria de adjuntos de texto del host.

Lista de verificación de operaciones

openclaw status          # local status (creds, sessions, queued events)
openclaw status --all    # full diagnosis (read-only, pasteable)
openclaw status --deep   # asks the gateway for a live health probe with channel probes when supported
openclaw health --json   # gateway health snapshot (WS; default can return a fresh cached snapshot)

Los registros se encuentran en /tmp/openclaw/ (valor predeterminado: openclaw-YYYY-MM-DD.log).

Siguientes pasos

WebChat: WebChat
Operaciones del Gateway: Runbook del Gateway
Cron + activaciones: Tareas Cron
Complemento de barra de menús de macOS: Aplicación de OpenClaw para macOS
Aplicación de nodo iOS: Aplicación iOS
Aplicación de nodo Android: Aplicación Android
Estado de Windows: Windows (WSL2)
Estado de Linux: Aplicación Linux
Seguridad: Seguridad

Configuración del asistente personal

⚠️ Seguridad primero

Requisitos previos

La configuración con dos teléfonos (recomendada)

Inicio rápido en 5 minutos

Dale al agente un espacio de trabajo (AGENTS)

La configuración que lo convierte en "un asistente"

Sesiones y memoria

Heartbeats (modo proactivo)

Medios de entrada y salida

Lista de verificación de operaciones

Siguientes pasos

Relacionado

Ask OpenClaw

# ⚠️ Seguridad primero

# Requisitos previos

# La configuración con dos teléfonos (recomendada)

# Inicio rápido en 5 minutos

# Dale al agente un espacio de trabajo (AGENTS)

# La configuración que lo convierte en "un asistente"

# Sesiones y memoria

# Heartbeats (modo proactivo)

# Medios de entrada y salida

# Lista de verificación de operaciones

# Siguientes pasos

# Relacionado

⚠️ Seguridad primero

Requisitos previos

La configuración con dos teléfonos (recomendada)

Inicio rápido en 5 minutos

Dale al agente un espacio de trabajo (AGENTS)

La configuración que lo convierte en "un asistente"

Sesiones y memoria

Heartbeats (modo proactivo)

Medios de entrada y salida

Lista de verificación de operaciones

Siguientes pasos

Relacionado