tmux para Openclaw

Una habilidad especializada para controlar de forma remota sesiones de tmux para gestionar herramientas CLI interactivas mediante la inyección de pulsaciones de teclas y el raspado de paneles.

brennerspear
v1.0.0
Feb 25, 2026
0
1.4k
0

Instalar y Descargar

1. ClawHub CLI

La forma más rápida de instalar una habilidad directamente desde el registro.

npx clawhub@latest install tmux-remote-control

2. Instalación manual

Copia la carpeta de la habilidad a una de estas ubicaciones

Global
~/.openclaw/skills/
Espacio de trabajo
<project>/skills/

Prioridad: Espacio de trabajo > Local > Integrado

3. Instalación del prompt

Copia este prompt en OpenClaw para instalarlo automáticamente.

Ayúdame a instalar tmux-remote-control usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).

¿Prefieres descargar?

Obtén los archivos originales de la habilidad en un archivo ZIP.

¿Qué es tmux?

La habilidad tmux permite que los agentes de IA interactúen con aplicaciones basadas en terminal que requieren un TTY interactivo completo. Al aprovechar el poder de la multiplexación de terminales, esta habilidad permite la creación de sesiones en segundo plano donde los agentes de codificación o las herramientas de CLI complejas pueden ejecutarse de forma persistente. Es un componente central para los desarrolladores que utilizan Openclaw Skills y necesitan cerrar la brecha entre los scripts automatizados y las interfaces de usuario de terminal interactivas (TUI).

Esta integración se centra en la fiabilidad y la transparencia. Evita rutas de socket oscuras en favor del servidor tmux predeterminado, lo que facilita a los usuarios conectarse y supervisar las sesiones manualmente. Al seguir las convenciones de nomenclatura estandarizadas y el manejo seguro de entradas, proporciona un marco sólido para la automatización basada en terminal.

Casos de uso de tmux

  • Ejecución de agentes de codificación interactivos como Claude Code o Codex en sesiones en segundo plano.
  • Orquestación de múltiples agentes en paralelo en diferentes árboles de trabajo de git.
  • Automatización de la entrada para REPL y aplicaciones TUI que no admiten tuberías estándar.
  • Supervisión de tareas de terminal de larga duración mediante el raspado periódico de los búferes de los paneles en busca de salidas o avisos específicos.

Cómo funciona tmux

  1. La habilidad crea una nueva sesión de tmux separada utilizando la convención de nomenclatura oc-project-feature para garantizar que sea fácilmente identificable como parte de Openclaw Skills.
  2. Los comandos se envían a la sesión utilizando secuencias de teclas literales para manejar de forma segura entradas interactivas complejas.
  3. Se introduce un pequeño retraso entre la entrada de texto y la tecla Enter para evitar que las aplicaciones TUI malinterpreten la secuencia como un único evento de pegado.
  4. El agente supervisa el progreso de la tarea capturando el historial del panel y analizando el texto en busca de avisos de shell o marcadores de éxito.
  5. Al finalizar, el usuario puede conectarse a la sesión para revisarla o eliminarla mediante programación para limpiar el entorno.

Configuración de tmux

Para utilizar esta habilidad, asegúrese de que tmux esté instalado en su sistema host (Darwin o Linux). No se requiere ninguna configuración adicional de sockets personalizados, ya que Openclaw Skills utiliza el servidor predeterminado.

# Instalar tmux en macOS
brew install tmux

# Instalar tmux en Ubuntu/Debian
sudo apt-get update && sudo apt-get install tmux

Esquema de datos y taxonomía de tmux

La habilidad gestiona los datos del terminal y los metadatos de la sesión utilizando la siguiente estructura:

Atributo Especificación Descripción
Prefijo de sesión oc- Identifica las sesiones gestionadas por Openclaw Skills para evitar colisiones con el usuario.
Sintaxis de destino session:window.pane Utiliza la orientación estándar de tmux (por defecto :0.0) para un control preciso.
Rango de captura -S -200 a -500 Define la profundidad del búfer de desplazamiento para el raspado de salida.
Convención de nomenclatura oc-${project}-${feature} Garantiza que las sesiones se puedan buscar a través de `tmux ls

Funciones avanzadas de tmux

  • Soporte de orquestación multiagente para ejecutar correcciones simultáneas en árboles de trabajo de git separados.
  • Detección inteligente de avisos de shell (❯ o $) para identificar cuándo han finalizado las tareas en segundo plano.
  • Optimizaciones específicas del entorno, como la configuración de PYTHON_BASIC_REPL=1 para garantizar flujos de entrada compatibles.
  • Capacidades de limpieza masiva para terminar todas las sesiones activas asociadas con Openclaw Skills en un solo comando.

SKILL.md


Cargando

Habilidades relacionadas de Openclaw

METADATA

Requires
Bins tmux
Github Stars: 0
forks: 0

Presentado*