Configuración del cliente

Usa esta página para cambiar cómo se comporta el cliente en una máquina: dónde guarda su estado, cómo llega a la plataforma y cuáles de sus partes se ejecutan.

openlatch init escribe la configuración por ti. Edítala a mano solo para un ajuste que ningún comando cubre, y después ejecuta openlatch restart para aplicarla: el daemon solo lee su configuración una vez, al arrancar.

De dónde vienen los ajustes

El cliente lee cada ajuste de la primera fuente que lo define, en este orden:

1. Una opción en la línea de comandos.
2. Una variable de entorno (OPENLATCH_*).
3. El archivo de configuración, config.toml en el directorio de estado: ~/.openlatch en macOS y Linux, %APPDATA%\openlatch en Windows.
4. El valor predeterminado integrado.

La ruta del proxy es la única excepción: se resuelve clave por clave y, después del archivo de configuración, también tiene en cuenta las variables estándar de la familia https_proxy, y luego los ajustes de proxy del sistema operativo, antes de ir en directo.

El daemon supervisado no hereda las variables de tu shell. Todo lo que necesita, como la dirección de la plataforma, openlatch init lo escribe en config.toml para que el daemon también lo use.

Variables de entorno

Estado y conexión

Variable	Qué define	Predeterminado
OPENLATCH_DIR	El directorio de estado: configuración, credencial, registros y outbox	~/.openlatch en macOS y Linux, %APPDATA%\openlatch en Windows
OPENLATCH_PORT	El puerto del daemon. Si está definida, openlatch init usa exactamente este puerto; si no, busca uno libre del 7443 al 7543	7443
OPENLATCH_API_URL	La dirección de la plataforma a la que el cliente envía los eventos y de la que obtiene las políticas	https://app.openlatch.ai
OPENLATCH_API_KEY	La credencial de registro. openlatch init la guarda en el llavero del sistema operativo, o en un archivo cifrado cuando no hay ningún llavero utilizable	—
OPENLATCH_SKIP_KEYRING	Considera el llavero no disponible, para que prevalezca la variable de entorno	sin definir
OPENLATCH_LOG	Nivel de registro: error, warn, info, debug o trace	info

Proxy

Variable	Qué define	Predeterminado
OPENLATCH_PROXY	La URL del proxy para cada solicitud saliente. Es el único ajuste que puede llevar una credencial; openlatch init mueve la contraseña al llavero en lugar de escribirla en el disco	sin definir
OPENLATCH_NO_PROXY	Destinos adicionales que no pasan por el proxy. Las direcciones de bucle local nunca pasan por él	sin definir
OPENLATCH_PROXY_MODE	auto, manual o direct	auto
OPENLATCH_PROXY_AUTH	auto, none, basic o negotiate (Kerberos). NTLM no es compatible	auto
OPENLATCH_PROXY_PAC_URL	Una URL explícita de configuración automática del proxy, usada en macOS y Windows. Se rechaza en Linux con OL-1225	sin definir
OPENLATCH_PROXY_SPN	El nombre de servicio Kerberos del proxy	HTTP/<proxy-host>
OPENLATCH_CA_BUNDLE	Un paquete PEM que se añade a los certificados de confianza del sistema operativo, para un proxy que inspecciona el tráfico TLS	sin definir

Partes del cliente

Variable	Qué define	Predeterminado
OPENLATCH_POLICY_ENABLED	La evaluación local de políticas. false desactiva por completo la aplicación en esta máquina; no es un modo Monitor (OL-1215)	true
OPENLATCH_MODEL_RELAY_ENABLED	El relé de modelo, el receptor local que registra las llamadas al modelo de cada agente. El daemon solo dirige un agente hacia él cuando una solicitud de prueba demuestra que llega al proveedor	true
OPENLATCH_MODEL_RELAY_PORT	El puerto del relé de modelo	7600
OPENLATCH_INVENTORY_ENABLED	El seguimiento de los archivos de configuración de los agentes (el plano de configuración)	true
OPENLATCH_CLINE_PLUGIN_DELIVERY	La entrega del plugin de OpenLatch a Cline.app y a la extensión de Cline para VS Code. Equivale a plugin_delivery en [cline]	true

Envío a la plataforma

Variable	Qué define	Predeterminado
OPENLATCH_CLOUD_BATCH_MAX_EVENTS	Eventos enviados por lote, de 1 a 100	50
OPENLATCH_CLOUD_BATCH_MAX_WAIT_MS	Cuánto espera el primer evento de un lote antes de que se envíe el lote, en milisegundos	5000
OPENLATCH_CLOUD_OUTBOX_MAX_BYTES	El volumen máximo de eventos no enviados que guarda el outbox, en bytes, antes de descartar los más antiguos. 0 quita el límite	104857600
OPENLATCH_CLOUD_FALLBACK_MAX_BYTES	El volumen máximo de eventos no reproducidos que guarda el registro de respaldo, en bytes, antes de omitir los más antiguos. Limita esa ventana, no el archivo: durante un corte largo, el archivo en disco sigue creciendo hasta que el daemon lo reproduce. Solo lo lee el daemon; el hook mantiene su propio límite de 50 MB. 0 quita el límite	52428800

El envío de eventos a la plataforma no se puede desactivar. Para enviarlos a otro lugar, cambia OPENLATCH_API_URL.

Actualizaciones y telemetría

Variable	Qué define	Predeterminado
OPENLATCH_AUTO_UPDATE	Las actualizaciones automáticas: el daemon busca periódicamente una nueva versión y la instala cuando no se está ejecutando ningún hook. true o 1 las activa; cualquier otro valor las desactiva. Equivale a auto_update en [update]	true
OPENLATCH_UPDATE_CHECK	La comprobación de versión al arrancar. false o 0 la desactiva. Equivale a check en [update]	true
OPENLATCH_NPM_REGISTRY	El registro desde el que descarga openlatch update	https://registry.npmjs.org
OPENLATCH_TELEMETRY_DISABLED	1 desactiva la telemetría de uso	sin definir
DO_NOT_TRACK	1 desactiva la telemetría de uso, como en otras herramientas que siguen esta convención	sin definir
OPENLATCH_CRASH_REPORTING	0, false, no u off detiene los informes de fallos, con independencia de la telemetría de uso	activado

Las actualizaciones automáticas nunca se ejecutan en runners de CI.

Archivo de configuración

config.toml en el directorio de estado contiene los ajustes que escriben los comandos, agrupados en secciones. Las secciones que es más probable que leas o edites:

Sección	Clave	Qué define
[policy]	enabled	La evaluación local de políticas, como OPENLATCH_POLICY_ENABLED
[model_relay]	enabled	El relé de modelo, como OPENLATCH_MODEL_RELAY_ENABLED. openlatch system model-relay enable y disable lo escriben
[cline]	plugin_delivery	La entrega del plugin de OpenLatch a los hosts de Cline
[update]	auto_update · check	Las actualizaciones automáticas y la comprobación de versión al arrancar
[proxy]	ver más abajo	La ruta que sigue cada solicitud saliente

La sección [proxy]

openlatch init encuentra la ruta por sí solo cuando puede y la escribe aquí. openlatch system proxy set, discover y clear la cambian; úsalos en lugar de editar el archivo.

[proxy]
mode = "auto"
url = "http://proxy.corp:8080"
auth = "auto"
no_proxy = ".corp.example,10.0.0.0/8"
ca_bundle = "/etc/ssl/corp-root.pem"
allow_direct = true

Clave	Qué define
mode	auto busca una ruta que funcione, manual usa exactamente lo definido y nunca se sustituye, direct nunca usa un proxy
url	El proxy, como http://, https://, socks5:// o socks5h://. Nunca contiene un nombre de usuario ni una contraseña
username	La cuenta con la que autenticarse. La contraseña está en el llavero, nunca en este archivo
auth	auto elige un esquema cuando arranca el daemon; basic, negotiate y none son explícitos
no_proxy	Destinos adicionales que no pasan por el proxy, como example.com, .example.com o 10.0.0.0/8
ca_bundle	Un paquete PEM que se añade a los certificados de confianza, nunca en su lugar
allow_direct	false rechaza una conexión directa cuando no se puede usar ningún proxy (OL-1227)
spn	El nombre de servicio Kerberos del proxy
http1_only	Fuerza HTTP/1.1, para un proxy de inspección que gestiona mal HTTP/2
pac_url	Una URL explícita de configuración automática del proxy. Se rechaza en Linux (OL-1225)

Ejecuta openlatch system proxy test después de cada cambio para comprobar la ruta.

Lo que el cliente escribe en los ajustes de los agentes

Mientras el relé de modelo está activado, el daemon dirige hacia él las llamadas al modelo de cada agente detectado, y quita esa conexión cuando detienes el daemon, desactivas el relé o desinstalas. Un valor que hayas definido tú nunca se sobrescribe: openlatch doctor lo indica en su lugar (OL-RELAY-SETTINGS).

Agente	Dónde va la conexión
Claude Code	Claves de entorno en sus ajustes: la dirección del relé, un identificador de instalación y entradas de bucle local en NO_PROXY
Codex CLI	Una entrada de proveedor openlatch en ~/.codex/config.toml
Cursor	La dirección del relé en los ajustes de usuario del IDE, y un wrapper de shell para la CLI de Cursor que recoge un terminal nuevo
Cline	Un punto de conexión local del relé por cada proveedor configurado, en los archivos de ajustes de Cline

Conectar Claude Code al relé de modelo define su ANTHROPIC_BASE_URL, lo que desactiva Claude Code Remote Control mientras el relé está activado. En una máquina detrás de un proxy, exporta también NO_PROXY=127.0.0.1,localhost en el shell que inicia Codex CLI, para que sus llamadas al modelo lleguen al relé local en lugar de al proxy corporativo.

Ejecuta openlatch system model-relay status para ver qué agentes tienen sus llamadas al modelo pasando por el relé.