Cómo funciona OpenClaw
OpenClaw no es un chatbot común, sino un asistente personal que vive en tu computadora. Puede recibir instrucciones a través de aplicaciones de mensajería como WeChat, WhatsApp, Telegram, ayudarte a enviar correos, consultar el calendario, abrir el navegador, ejecutar comandos, ¡e incluso hacer cosas automáticamente las 24 horas!
Conceptos clave
| Concepto | Analogía | Función |
|---|---|---|
| Gateway (puerta de enlace) | Recepcionista del edificio | Recibe todos los mensajes externos y los distribuye al espacio de trabajo correcto |
| Workspace (espacio de trabajo) | Tu oficina privada | Maneja tareas específicas, gestiona el historial de conversaciones y las habilidades |
| LLM (Gran Modelo de Lenguaje) | Cerebro asesor de IA | Comprende tus intenciones y genera respuestas |
| Skills (habilidades) | Herramientas dentro de la caja de herramientas | Ejecutan funciones específicas (consultar el clima, escribir código, gestionar agenda, etc.) |
| Channels (canales) | Equipo de comunicación | Conectan diferentes plataformas de mensajería |
¿Qué es exactamente OpenClaw?
OpenClaw es unasistente de IA completamente de código abierto que se ejecuta en tu propia computadora(Antes se llamaba Clawdbot, luego cambió de nombre).
No solo conversa como ChatGPT, sino que realmente se pone manos a la obra:
- Dices en WhatsApp: "Ayúdame a consultar el vuelo de mañana", y automáticamente abrirá el navegador, iniciará sesión en el sitio web de la aerolínea y te enviará una captura de pantalla.
- Admite cientos de habilidades (Skills), y la comunidad sigue agregando más.
- Tiene memoria a largo plazo (recuerda lo que te gusta) y también puede generar nuevas habilidades por sí mismo.
- Lo más importante es:Todos los datos están en tu computadora, no se suben a la nube, privacidad y seguridad.。
Idea central:Conectar el gran modelo de IA (cerebro) + herramientas locales (manos y pies) + aplicaciones de mensajería (boca y oídos)para que la IA se convierta verdaderamente en el administrador de tu computadora.
Arquitectura general: Gateway es el cerebro y centro de mando
La parte más central de OpenClaw se llamaGateway (puerta de enlace). Es como el panel de control central de tu casa, todo gira en torno a él.
Explicación breve de cada parte:
- Channel Bridge (puente de canales): se encarga del "apretón de manos" con aplicaciones de mensajería como WhatsApp, Telegram. Por ejemplo, usa la librería Baileys para conectarse a WhatsApp.
- Gateway: es el único proceso en ejecución (ocupa un puerto, por defecto 18789), como un operador de centralita, reenvía los mensajes a la IA.
- Cerebro de IA: el que realmente piensa es el gran modelo externo (tú proporcionas la API Key), Gateway solo se encarga de "llamarlo para que trabaje".
- Herramientas y habilidades: las manos y los pies de la IA, como abrir el navegador, leer y escribir archivos, enviar correos.
- Sistema de memoria: como un cuaderno, la IA no olvida lo que dijiste la última vez.
¿Cómo se convierte un mensaje en acciones?
Usemos un ejemplo real: "Di en WhatsApp: ayúdame a organizar los correos de hoy en un resumen y envíamelo".
El diagrama de flujo es el siguiente:
Desglose detallado:
- Recepción de instrucciones: envías un mensaje → el Bridge de la aplicación de mensajería empuja el mensaje a Gateway.
- Consulta de memoria: Gateway abre tu "perfil personal" (Session + Memory), sabe que eres un usuario antiguo y qué tono te gustó la última vez.
- Pensamiento de la IA: empaqueta el mensaje + la memoria y lo envía al cerebro de IA. La IA, como un secretario inteligente: "Mmm, primero hay que leer los correos y luego resumirlos".
- Invocación de herramientas: la IA dice "quiero usar la habilidad de Gmail". Gateway lo ejecuta en un sandbox seguro (para evitar que la IA modifique archivos arbitrariamente).
- Ejecución + retroalimentación: la herramienta entrega el resultado a la IA, y la IA escribe el resumen.
- Responder al usuario: Gateway envía el resumen de vuelta a WhatsApp. ¡Y lo recibes!
Arquitectura general
Diseño de arquitectura de tres capas
OpenClaw adopta la clásica arquitectura de tres capas. Vamos a entenderla capa por capa, de afuera hacia adentro:
¿Por qué diseñarlo así?
Analogía: imagina una gran empresa
- Capa externa (interfaz de usuario)= los clientes pueden contactar a la empresa por teléfono, correo, WeChat y otros medios
- Capa intermedia (Gateway)= recepción, atiende a todos los clientes de manera unificada y luego los asigna al departamento adecuado
- Capa interna (Workspace)= los diferentes departamentos de negocio, cada uno responsable de distintos asuntos
- Capa inferior (capa de capacidades)= los recursos de la empresa (consultores expertos, herramientas y equipos, etc.)
Explicación detallada de los componentes principales
Gateway: el portal unificado
¿Qué es Gateway?
Gateway (puerta de enlace) es la puerta de entrada de OpenClaw; todos los mensajes externos deben pasar primero por aquí.
Las tres responsabilidades principales de Gateway:
1. Autenticación (Authentication)
Garantiza que solo las plataformas que autorizas puedan conectarse
2. Enrutamiento (Routing)
Envía los mensajes al espacio de trabajo correcto
3. Registro de eventos (Logging)
Registra todas las interacciones para facilitar la depuración y la auditoría
El comando para iniciar Gateway:
# 启动网关，监听 18789 端口 openclaw gateway --port 18789 --verbose
Workspace: tu oficina privada
¿Qué es Workspace?
Workspace (espacio de trabajo) es el lugar donde se procesan realmente las tareas. Puedes tener varios workspaces, cada uno encargado de diferentes cosas.
Un ejemplo típico de configuración de Workspace:
# workspace-personal.yaml name: "个人助理" llm: provider: "anthropic" # 使用 Claude model: "claude-sonnet-4" apiKey: "sk-ant-xxx" skills: - weather # 查天气 - calendar # 管理日程 - email # 处理邮件 - web-search # 网页搜索 settings: language: "zh-CN" temperature: 0.7 max_tokens: 4000
Escenarios de uso de múltiples workspaces:
LLM: el cerebro de la IA
¿Qué es LLM?
LLM (Large Language Model, Gran Modelo de Lenguaje) es el cerebro inteligente de OpenClaw, responsable de comprender tus intenciones y generar respuestas.
Modelos de LLM compatibles con OpenClaw:
| Proveedor | Ejemplos de modelos | Características | Escenarios de uso |
|---|---|---|---|
| Anthropic | Claude Sonnet 4 | Equilibrado, seguro, buen soporte multilingüe | Conversación cotidiana, escritura |
| OpenAI | GPT-4 | Profesional, amplio conocimiento | Tareas profesionales, análisis |
| DeepSeek | DeepSeek-V3 | Fuerte en código, económico | Asistencia de programación |
| Despliegue local | Ollama | Completamente privado, gratuito | Escenarios sensibles a la privacidad |
Channels: conectando con el mundo exterior
¿Qué son Channels?
Channels (canales) son los "adaptadores" que conectan varias plataformas de mensajería.
El trabajo de cada Channel:
- Recibir mensajes: obtener los mensajes del usuario desde la plataforma
- Conversión de formato: convertir uniformemente al formato interno de OpenClaw
- Enviar respuestas：Enviar la respuesta de OpenClaw de vuelta a la plataforma
Ejemplo: Flujo de trabajo del canal de Telegram
Proceso de flujo de mensajes
Ahora veamos cómo fluye un mensaje completo en OpenClaw:
Diagrama completo del flujo de mensajes
Análisis detallado de pasos
Pasos 1-3: Recepción y estandarización de mensajes
Después de que el usuario envía un mensaje en Telegram, el canal de Telegram lo convierte al formato estándar de OpenClaw:
{
"platform": "telegram",
"channel_id": "telegram_123",
"user": {
"id": "user_456",
"name": "Alice"
},
"message": {
"type": "text",
"content": "上海明天天气?",
"timestamp": "2024-03-09T10:30:00Z"
}
}
Pasos 4-5: Autenticación y enrutamiento
Gateway verifica este mensaje:
- ¿La fuente está autorizada?
- ¿A qué Workspace debe enrutarse?
- ¿El usuario tiene permisos?
Pasos 6-8: Comprensión y decisión de IA
Workspace prepara el contexto completo para enviarlo al LLM:
[系统提示] 你是一个个人助理，可以使用以下技能： - weather: 查询天气 - calendar: 管理日程 - ... [对话历史] Usuario: 你好 助理: 你好！有什么可以帮你的？ [当前消息] Usuario: 上海明天天气?
Pasos 9-12: Ejecución de habilidades
El LLM decide llamar a la habilidad weather, Workspace la ejecuta y obtiene el resultado:
{
"location": "上海",
"date": "2024-03-10",
"weather": "晴转多云",
"temperature": "18-26°C",
"humidity": "60%",
"wind": "东风 3-4级"
}Pasos 13-17: Generar respuesta y devolverla
El LLM genera una respuesta en lenguaje natural basada en los datos meteorológicos y la devuelve al usuario por la misma ruta.
Sistema de habilidades
¿Qué son las habilidades (Skills)?
Las habilidades son los "módulos de capacidad" con los que OpenClaw ejecuta tareas específicas. Si OpenClaw fuera una persona, las habilidades serían las distintas destrezas que esa persona ha aprendido.
Estructura de las habilidades
Cada habilidad incluye:
Ejemplo: Definición de la habilidad meteorológica
Proceso de invocación de habilidades
Mecanismo de seguridad de las habilidades
OpenClaw tiene un control de seguridad estricto sobre las habilidades:
Tipos de permisos:
| Permiso | Descripción | Ejemplo |
|---|---|---|
network |
Acceso a red | Consultar el clima, buscar en la web |
filesystem |
Sistema de archivos | Leer y escribir archivos |
email |
Acceso a correo electrónico | Enviar/recibir correos |
calendar |
Acceso a calendario | Gestionar agendas |
system |
Operaciones del sistema | Ejecutar comandos |
Flujo de trabajo completo
Conectemos todos los conceptos mediante un escenario real:
Escenario: envío programado de un informe meteorológico diario
Requisito：Recibir cada mañana a las 8:00 el clima del día + recordatorio de agenda a través de Telegram
Código de configuración
# workspace-daily-report.yaml
name: "每日报告助理"
# 定时任务
cron_jobs:
- name: "早间报告"
schedule: "0 8 * * *" # 每天早上8点
action:
type: "send_message"
channel: "telegram"
template: |
请生成今日报告：
1. 查询我所在城市的天气
2. 列出今天的所有日程
3. 以友好的方式呈现
# 可用技能
skills:
- weather
- calendar
# LLM 配置
llm:
provider: "anthropic"
model: "claude-sonnet-4"
El mensaje que recibe el usuario
早安！今日简报 天气情况 上海今天多云，气温 15-23°C 建议穿着：薄外套 降雨概率：10% 今日日程 - 09:00 - 10:00 团队晨会 - 14:00 - 15:30 客户演示 - 16:00 - 17:00 代码评审 温馨提示 今天有 3 个会议，建议提前准备演示材料。
Flujo de datos y gestión de estado
¿Cómo se almacenan los datos?
Tipos de datos y método de almacenamiento:
| Tipo de dato | Método de almacenamiento | Tiempo de retención | Ejemplo |
|---|---|---|---|
| Estado de la sesión actual | Memoria | Hasta el final de la sesión | Contexto de la conversación en curso |
| Historial de conversaciones | Base de datos local | Configurable (p. ej., 30 días) | Registros de chat anteriores |
| Configuración del usuario | Archivo de configuración | Permanente | Claves de API, preferencias |
| Datos de habilidades | Gestionados por la propia habilidad | Depende de la habilidad | Agenda, borradores de correo |
| Registros del sistema | Archivos de registro | Configurable | Errores, información de depuración |
Extensibilidad y ecosistema de plugins
¿Cómo agregar nuevas funciones?
El diseño de OpenClaw permite una extensión sencilla:
Proceso de instalación de habilidades
