Notas desde el taller
Cómo entendemos los agentes que viven en tus aplicaciones de mensajería, qué aprendimos al crearlos y los detalles prácticos que puedes usar hoy mismo.
329 artículos
Todos los artículos
Lo que OpenClaw envía a casa
Por defecto, OpenClaw hace una solicitud saliente al día, y la documentación dice exactamente qué lleva: versión, sistema operativo, versión de Node.js, arquitectura y superficie, sin ningún identificador de instalación. Aquí tienes el panorama completo, incluida la ubicación derivada de Cloudflare que se conserva tres meses, y todos los interruptores que detienen las solicitudes.
La Control UI de OpenClaw
El Gateway sirve un panel en el navegador en el puerto 18789, y lo primero que muestra es un único campo Gateway secret. Qué acepta ese campo, por qué un navegador en la misma máquina igualmente tiene que rellenarlo, qué hacen el listado de agentes y el modo equipo, y qué ejecutar cuando la URL de la LAN está bloqueada.
Failed to start Chrome CDP on port 18800
El error te da una sola línea y ninguna pista. En un servidor Linux, la causa casi siempre es el navegador: apt install chromium te entrega un envoltorio snap cuyo confinamiento rompe la forma en que OpenClaw lanza y vigila Chrome. Aquí tienes las soluciones, los seis ajustes que importan y la comprobación que distingue un fallo de arranque de CDP de un bloqueo de navegación.
El relay de navegador de OpenClaw
OpenClaw puede controlar un navegador que no está en la máquina del Gateway: un node host retransmite las acciones, o un cdpUrl se conecta a un Chromium alojado. Así se comportan el enrutamiento, los perfiles y las credenciales.
Agentes ACP de OpenClaw
OpenClaw ejecuta arneses de programación externos mediante el Agent Client Protocol: Claude Code, Gemini CLI, Cursor, Copilot, Droid, OpenCode y once más, lanzados desde un mensaje de chat y seguidos como tareas en segundo plano. La instalación de acpx en dos comandos, las trampas de la primera ejecución, incluida la de plugins.allow, la lista de requisitos que decide si esa vía se ofrece siquiera, y los diecisiete identificadores de destino de los arneses.
Activar OpenClaw desde Gmail
Los eventos de la bandeja de entrada de Gmail llegan a OpenClaw a través de un tema de Google Pub/Sub, un proceso vigilante y el hook HTTP del Gateway, y el preajuste integrado da a cada correo su propia sesión sin restringir nada más. Aquí tienes la configuración del tema y de la vigilancia con gcloud, el modelo de dos tokens, el agente mail_reader restringido y en entorno aislado que recomienda la documentación, y la prueba de límites que te dice si el lector está realmente contenido.
Salir del entorno aislado a propósito
El modo elevado permite que un agente de OpenClaw en un entorno aislado ejecute comandos fuera de él, bajo controles de aprobación que siguen siendo configurables. No hace nada por un agente que nunca estuvo aislado, y no puede sobrescribir la política de herramientas ni un rol que exigió el aislamiento desde el principio. Este artículo cubre las cuatro directivas, el orden de resolución, los controles y las listas de permitidos que deben superarse todos, y lo que la elevación deja intacto a propósito.
Motores de contexto de OpenClaw
Un motor de contexto decide qué mensajes llegan al modelo, cómo se resume el historial más antiguo y cómo cruza el contexto los límites de los subagentes; OpenClaw incluye un motor legacy y lo usa por defecto, un motor de plugin se selecciona mediante un slot de configuración, la interfaz exige ingest, assemble y compact, con hooks opcionales de bootstrap, maintain, ingesta por lotes y subagentes, un motor de plugin que falla queda en cuarentena durante el proceso y el trabajo recurre a legacy, y un ownsCompaction en false no restaura la ruta de compactación de legacy.
El exec en segundo plano y la herramienta process de OpenClaw
Un comando que supera el plazo de cesión devuelve un id de sesión y un breve final de la salida en lugar de bloquear; la salida se queda en memoria hasta el límite agregado, las sesiones terminadas caducan según un tiempo de vida medido desde que terminan, con un máximo de 50 sesiones terminadas y dos millones de caracteres conservados, los entornos de worker respaldados por un nodo mantienen vivos los comandos en segundo plano entre turnos, y la herramienta process sondea, lee registros paginados, escribe en stdin, envía teclas, confirma, pega, mata y limpia.
La herramienta exec de OpenClaw
Exec ejecuta comandos de shell en el espacio de trabajo y puede crear, editar o eliminar archivos allí donde lo permita el host elegido, así que desactivar las herramientas de archivos no lo convierte en solo lectura; el parámetro host se resuelve al entorno aislado cuando hay un runtime de entorno aislado activo y al gateway en caso contrario, la clave mode establece deny, allowlist, ask, auto o full, el revisor automático devuelve allow, deny o ask para las no coincidencias elegibles, con toda la cadena de despacho vinculada y verificada de nuevo antes del lanzamiento, y los comandos de sesión solo pueden endurecer la política.
API OpenResponses de OpenClaw
El gateway sirve un endpoint responses compatible con OpenResponses una vez que se activa gateway.http.endpoints.responses, con las mismas reglas de autenticación, scopes y agente de destino que chat completions; la entrada es una cadena o una lista de elementos, los resultados de herramientas vuelven como function_call_output, previous_response_id reutiliza una sesión dentro del mismo ámbito de agente, usuario y sesión, los archivos se decodifican en el prompt del sistema como contenido no confiable, con los PDF rasterizados cuando escasea el texto, y el streaming emite eventos de respuesta tipados que terminan en DONE.
Autenticación por proxy de confianza en OpenClaw
En el modo de proxy de confianza, el gateway solo confía en un encabezado de identidad de usuario si procede de direcciones de origen incluidas como proxies de confianza, rechaza las fuentes de loopback salvo que la opción se active deliberadamente, rechaza las fuentes que coinciden con sus propias interfaces, exige los encabezados configurados y una coincidencia en la lista de permitidos, se niega a arrancar cuando también hay un token compartido configurado, y la auditoría de seguridad marca el modo como crítico a propósito; los scopes por identidad conceden scopes solo de sesión a usuarios verificados, la aprobación automática de dispositivos puede convertir la identidad del proxy en la frontera de registro, y el encabezado de scopes solo restringe.
Aprobaciones de exec avanzadas en OpenClaw
Los safe bins como cut, head, tail, tr, uniq y wc se ejecutan en modo allowlist sin entradas porque rechazan los argumentos de archivo y los tokens con forma de ruta; grep y sort hay que activarlos explícitamente, awk, sed y jq nunca son safe bins, los intérpretes nunca deben estar ahí, los safe bins deben resolverse desde los directorios del sistema predeterminados salvo que se confíe en otros, el encadenamiento se permite cuando cada segmento pasa, las ejecuciones de intérpretes vinculan toda la cadena de despacho antes de la revisión, resolver una aprobación requiere el scope dedicado approvals y no write, y las solicitudes se pueden reenviar a Slack, Telegram, Discord y otros.
Resolución de problemas del gateway de OpenClaw
El runbook detallado del gateway empieza con los mismos cinco comandos en orden, espera un runtime en ejecución, una sonda de conectividad en ok y una línea de capacidades, y luego deriva por síntoma a seis páginas: actualizaciones y reversiones, skills y proveedores de modelos, respuestas del agente e interfaz de control, servicio y proceso del gateway, validación de configuración y sondas, entrega de canales y herramientas; la mayoría de las roturas tras una actualización son desviaciones de configuración o valores predeterminados más estrictos, que se comprueban a través del modo del gateway y la URL remota, los enlaces fuera de loopback que ahora necesitan una vía de autenticación real y las aprobaciones pendientes de emparejamiento de dispositivos o de mensajes directos.
La API HTTP compatible con OpenAI de OpenClaw
El gateway puede servir chat completions, models y embeddings en su propio puerto una vez activado gateway.http.endpoints.chatCompletions; un token válido es acceso de nivel propietario, así que la documentación lo mantiene en loopback, tailnet o ingress privado; el campo model nombra un agente como openclaw/default y no un modelo de proveedor, la cadena user deriva una clave de sesión estable, x-openclaw-model sobrescribe el modelo de backend, y las herramientas de función, tool_choice y el streaming SSE siguen las formas de OpenAI con límites documentados.
Los scopes de operador de OpenClaw
Los scopes determinan lo que un cliente del gateway puede hacer después de autenticarse, como salvaguarda dentro de un único dominio de operador de confianza y no como aislamiento entre inquilinos hostiles; operator.write implica read y talk, operator.admin lo implica todo, los roles con nombre limitan los scopes y pueden exigir un entorno aislado por creador, las concesiones por identidad asocian scopes a una identidad verificada de proxy o de Tailscale, cada RPC tiene un scope de método de mínimo privilegio, y aprobar una solicitud de dispositivo solo puede emitir scopes que quien aprueba ya tiene.
Control de acceso de Matrix en OpenClaw
Quién puede llegar a OpenClaw a través de Matrix y qué conserva alrededor de un mensaje: los mensajes de otras cuentas de Matrix de OpenClaw configuradas, ignorados de forma predeterminada, y el ajuste allow-bots con true o mentions más sobrescrituras por sala, la protección compartida contra bucles y su precedencia, la regla del propio ID, la definición de escrito por un bot en una plataforma sin indicador de bot, los tres modos de visibilidad del contexto que filtran las respuestas recuperadas, las raíces de hilo y el historial pendiente sin decidir qué activa una respuesta, el ejemplo de políticas de mensajes directos y de salas con listas de permitidos y una sala con mención obligatoria, la desactivación total de los mensajes directos, los comandos de emparejamiento y el código pendiente reutilizado con un recordatorio tras un periodo de espera, y los comandos de barra reconocidos en las salas cuando van precedidos por la propia mención del bot, sujetos igualmente a la misma autorización.
Reglas push de Matrix en OpenClaw para vistas previas silenciosas
La configuración del lado del homeserver que hace que el streaming silencioso de Matrix suene en el momento adecuado: vistas previas enviadas como avisos que no notifican, con la edición finalizada llevando un marcador; clientes que solo notifican cuando una regla push por usuario coincide con él; el modo progress, que finaliza por la misma ruta; los requisitos previos de un usuario destinatario, un usuario bot, el token del destinatario, el ID completo del bot como remitente y pushers sanos; los seis pasos, desde activar el modo quiet hasta generar o reutilizar un token, listar los pushers, instalar la regla override con sus cuatro condiciones y sus acciones de notificación, verificarla y probar una respuesta en streaming; la eliminación; los IDs de regla únicos por bot y por destinatario, con nuevas ejecuciones que actualizan en el sitio; las reglas override de usuario insertadas por delante de las reglas suppress del servidor; las ediciones solo de texto a las que afecta la regla, mientras que los medios, los respaldos de vista previa obsoleta y los finales que activan menciones notifican con normalidad; Synapse, que necesita la condición event-property-is de 2023, con versiones anteriores que en silencio nunca coinciden; y la opción de Tuwunel que suprime las notificaciones cuando hay un dispositivo activo.
Configuración de Microsoft Teams en OpenClaw
Los ajustes de Teams bajo el bloque del canal: las ocho claves de autenticación que las variables de entorno pueden sustituir mientras todo lo demás se queda solo en la configuración, el límite de historial con sus valores de respaldo y el contexto de hilo de Graph, que añade el mensaje principal y hasta cincuenta respuestas sin dejar que se ejecuten los comandos citados, los modos de visibilidad all, allowlist y allowlist-quote, los límites de historial de mensajes directos por usuario, las claves de nube y de URL de servicio para las nubes pública, del gobierno de EE. UU., DoD y China, el puerto y la ruta del webhook, las cuatro políticas de mensajes directos con los ID de objeto de AAD recomendados, el destino predeterminado, el interruptor de emergencia de coincidencia por nombre, el tope de 4000 caracteres por fragmento, la fragmentación por saltos de línea, las listas de hosts de medios permitidos y el respaldo de medios de Graph, el requisito de mención y el estilo de respuesta con sobrescrituras por equipo y por canal, incluidas las políticas de herramientas, el sitio de SharePoint para las subidas en grupos, las tarjetas de bienvenida individual y de grupo con sugerencias de prompt, el prefijo de respuesta, las valoraciones con pulgar arriba o abajo con reflexión, y el SSO con scopes delegados de Graph.
Configurar Telegram en OpenClaw
Conectar un bot de Telegram a OpenClaw desde cero: los flujos por chat y web de BotFather, que terminan ambos en un token; el comando channels add, que lo escribe en la configuración; la alternativa editada a mano con una política de mensajes directos en modo emparejamiento y una entrada de grupo comodín; la variable de entorno de respaldo, que solo sirve a la cuenta predeterminada; por qué no hay comando de inicio de sesión para Telegram; la comprobación de estado con recarga en caliente; los comandos de lista y de aprobación de emparejamientos, con códigos que caducan al cabo de una hora; los dos ID que necesita un grupo y dónde va cada uno; la precedencia de tokens según la cuenta y la caché de identidad de 24 horas; el modo de privacidad y el estado de administrador en el lado de Telegram, con la regla de quitar el bot y volver a añadirlo; los ajustes útiles de BotFather; y la elección de transporte entre el sondeo largo, con su posición de reinicio duradera, y el modo webhook, con su secreto, sus valores predeterminados de escucha, su ruta de salud reservada y su cabecera de aceptación duradera.
Gráficos, tablas y aprobaciones de Slack en OpenClaw
Las superficies de Block Kit que OpenClaw renderiza de forma nativa en Slack: el bloque de gráfico portable convertido en el bloque de visualización de datos de Slack sin scope adicional, los límites que se imponen a títulos, segmentos, series y categorías, la representación en texto que lleva cada gráfico, la recuperación cuando Slack rechaza bloques, el límite no documentado de dos gráficos por mensaje y cómo los gráficos adicionales pasan a mensajes de seguimiento, el bloque de tabla portable convertido en la tabla de datos actual con celdas de texto sin formato y de número sin formato y encabezados de fila, los límites de 20 columnas, 100 filas y 10 000 caracteres, el respaldo en texto completo y el error de tamaño explícito al editar, por qué las tablas Markdown con barras verticales siguen siendo texto y los bloques sin procesar se siguen transmitiendo tal cual, las tablas pegadas entrantes como TSV, los dos patrones de enrutamiento para los envíos de ventanas modales propiedad de plugins y el evento compacto, con datos ocultos, que ve el agente, y Slack como cliente de aprobación nativo para solicitudes de ejecución y de plugins, con sus aprobadores, destinos, filtros y la retención del espacio de trabajo en Enterprise Grid.
Hilos y sesiones de Slack en OpenClaw
Dónde cae un mensaje de Slack en OpenClaw y adónde va la respuesta: los mensajes directos como direct, los canales como channel y los mensajes directos de grupo como group, las vinculaciones de ruta que aceptan las formas de destino de Slack, el ámbito principal de mensajes directos que agrupa los mensajes directos normales, las sesiones por canal y el sufijo de hilo tomado de la marca de tiempo del mensaje principal, la raíz sembrada que mantiene una mención y su hilo en una sola sesión, el ámbito del historial, la herencia del mensaje principal y la recuperación inicial del historial, los dos indicadores de mención implícita y la clave de mención explícita migrada, los modos de respuesta por canal, por tipo de chat y con el antiguo respaldo para mensajes directos, las etiquetas de respuesta manuales, la difusión de respuestas para texto y Block Kit, la exclusión de nivel superior, por qué off en Slack también desactiva las etiquetas explícitas a diferencia de Telegram, y los mensajes directos de Agent View, donde cada raíz del cuadro de redacción es su propia conversación y el marcador se aprende de tres señales y se guarda por cuenta, espacio de trabajo y app.
Mensajes enriquecidos y aprobaciones de Telegram en OpenClaw
Las superficies enriquecidas que puede usar un bot de Telegram de OpenClaw: el HTML estándar de Telegram por defecto, con negrita, cursiva, enlaces, código, spoilers y citas; el indicador de mensajes enriquecidos, que renderiza el Markdown como bloques tipados de Bot API 10.3, como encabezados, tablas, detalles, listas de verificación y fórmulas, con las leyendas todavía en HTML y las tablas de más de 20 columnas convertidas en código; por qué sigue desactivado por compatibilidad con los clientes; las vistas previas de enlaces; los cinco ámbitos de los botones en línea, con allowlist por defecto; el bloque de botones, con acciones de callback y de web app, y la limitación de las Mini Apps a los chats privados; cómo llegan al agente como texto los callbacks no reclamados; la confirmación con la ingesta persistente; las seis acciones de mensaje, con sus alias y sus controles desactivados por defecto; la consulta de la lista de emojis, y las aprobaciones de ejecución, con sus aprobadores, destinos, caducidad y el requisito de botones en línea.
Cifrado y verificación de Matrix en OpenClaw
Cómo una cuenta de Matrix de OpenClaw obtiene cifrado de extremo a extremo y sigue siendo de confianza: el comando de configuración que inicializa el almacenamiento de secretos, la firma cruzada y una copia de seguridad de claves de sala, por qué las claves de recuperación pasan por stdin, las tres señales de confianza independientes y la regla de que solo la verificación por firma cruzada cuenta como verificado por el propietario, la verificación del dispositivo y la autoverificación, el comando de inicialización o reparación y sus alternativas de UIA, el estado, la restauración y el restablecimiento de la copia de seguridad, los comandos de verificación SAS, notas sobre varias cuentas, la autoverificación al arrancar con su periodo de espera, los avisos de verificación y qué hacer cuando el dispositivo se ha eliminado.
Mostrando 24 de 50 artículos
El resto del blog está en inglés. Leerlo en inglés
Deja de leer sobre ello y crea el tuyo
Configura un agente, elige un canal y ponlo a trabajar dentro de la aplicación que ya tienes abierta.