lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

configuración intermedio hermesopenclawsandbox

OneCLI: ejecuta agentes con acceso mediado por una pasarela

Asigna un entorno y accesos a cada agente de un equipo. La pasarela incorpora credenciales a las peticiones y aplica las políticas configuradas.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: instala en un entorno de ensayo

Comprueba que tienes Git, Node.js ≥22, pnpm 9.0.0 y Docker funcionando, según el package.json y la guía de autohospedado. El README publica:

git clone https://github.com/onecli/onecli.git && cd onecli
pnpm install
pnpm run setup

Paso 2: prepara un agente limitado

Abre http://localhost:10254. Sigue el asistente y la guía de autohospedado para crear una cuenta y un agente. Configura un acceso de prueba desde la consola, sin pegar valores en el chat.

Paso 3: revisa la política

Concede solo el acceso necesario y prueba una operación de lectura. Lee la guía de actualizaciones antes de cambiar una instalación existente.

Comprobación

Comprueba que la operación permitida funciona y que la política rechaza una acción fuera de alcance. Revisa los registros para confirmar que no muestran el valor de la credencial.

Si algo falla

Si un agente usa una imagen antigua tras actualizar, sigue el procedimiento de setup de la guía: el README advierte que actualizar solo los servicios Compose no refresca todos los entornos aislados.

Consulta el README oficial para el procedimiento completo y los cambios de versión.

ver en .md ¿Prefieres el recurso entero?

Qué es

OneCLI es una plataforma para ejecutar asistentes de equipo en entornos separados. Su versión actual amplía el proyecto inicial de custodia de credenciales con gestión de agentes y ejecución.

Para qué te sirve

  • Cuando cada persona necesita un agente con accesos diferentes.
  • Cuando quieres que una petición use credenciales sin incluir su valor en el contexto del agente.
  • Cuando necesitas separar el plano de control de los entornos de ejecución.

Cómo funciona

El servidor API coordina conversaciones y trabajo. El runner, servicio que inicia y administra los entornos aislados de ejecución, los pone en marcha y la pasarela intercepta solicitudes para aplicar políticas e inyectar credenciales. El README describe también integración con gestores de secretos y componentes opcionales.

Antes de empezar

La instalación interactiva documenta Git, Node.js ≥22, pnpm 9.0.0 (fijado en package.json) y Docker para la ruta autohospedada descrita. Prepara una máquina de ensayo y cuentas limitadas. Lee la configuración del runner y conserva de forma segura los datos de cifrado.

Límites y alternativas

GitHub detecta Apache-2.0, pero el README distingue rutas Enterprise con licencia comercial: revisa LICENSE-ENTERPRISE para las funciones que uses. La inspección HTTPS de la pasarela cambia la frontera de confianza. Una sesión no expuesta a la clave aún puede ejercer accesos autorizados; comprueba políticas y revocación.

Recursos