Variables de entorno

TokenWork lee estas variables al arrancar. Para servicios de inicio, openchamber startup enable guarda por defecto una copia del entorno actual, así que vuelve a ejecutarlo después de cambiar variables que quieras usar en el servicio.

Servidor TokenWork

`OPENCHAMBER_HOST`

Dirección donde escucha el servidor web de TokenWork. Usa 0.0.0.0 para permitir acceso desde otras máquinas.

`OPENCHAMBER_UI_PASSWORD`

Contraseña para la interfaz del navegador. Úsala cuando no te limites a localhost, o cuando uses túneles o un proxy inverso.

`OPENCHAMBER_API_ONLY`

Inicia TokenWork en modo headless cuando vale true o 1. Las rutas API siguen disponibles para clientes de escritorio y móviles, pero no se sirve la UI del navegador.

`OPENCHAMBER_DATA_DIR`

Cambia el directorio de datos de TokenWork. Por defecto es ~/.config/openchamber.

`OPENCHAMBER_CHATS_DIR`

Cambia la ubicación de los directorios de chat gestionados que TokenWork crea para chats sin proyecto. Por defecto es ~/.config/openchamber/chats. Indica un directorio que el servidor OpenCode pueda leer cuando TokenWork y OpenCode se ejecutan con usuarios distintos. Los chats existentes no se mueven.

`OPENCHAMBER_COMPRESS_API`

Controla la compresión de respuestas de la API. true o 1 la activa; false o 0 la desactiva.

`OPENCHAMBER_SKIP_API_COMPRESSION`

Desactiva la compresión de respuestas de la API si vale true o 1. Tiene prioridad sobre OPENCHAMBER_COMPRESS_API.

`OPENCHAMBER_VERBOSE_REQUEST_LOGS`

Activa logs HTTP detallados si vale true o 1.

`OPENCHAMBER_UPDATE_API_URL`

Cambia el endpoint de comprobación de actualizaciones. La mayoría de usuarios no debería tocarlo.

`OPENCHAMBER_PACKAGE_MANAGER`

Fuerza el gestor de paquetes usado para actualizar cuando la detección automática se equivoca.

Servidor OpenCode

`OPENCODE_HOST`

Conecta TokenWork a un servidor OpenCode existente. Debe ser un origin http o https con puerto explícito y sin ruta, query ni hash. OPENCODE_HOST tiene prioridad sobre OPENCODE_PORT.

`OPENCODE_PORT`

Define el puerto del servidor OpenCode. Con OpenCode gestionado pide ese puerto; con OPENCODE_SKIP_START=true conecta a un servidor externo en ese puerto.

`OPENCODE_SKIP_START`

Evita que TokenWork arranque su propio servidor OpenCode cuando vale true.

`OPENCHAMBER_OPENCODE_HOSTNAME`

Hostname para el servidor OpenCode gestionado por TokenWork. Por defecto es 127.0.0.1.

`OPENCODE_BINARY`

Ruta al ejecutable opencode que debe usar TokenWork.

`OPENCODE_CONFIG`

Ruta a un archivo de configuración concreto de OpenCode.

`OPENCODE_CONFIG_DIR`

Ruta al directorio de configuración de OpenCode para agents, skills, snippets y descubrimiento de config.

`OPENCODE_DATA_DIR`

Directorio de datos personalizado para el servidor OpenCode gestionado.

`OPENCODE_WSL_DISTRO`

Elige la distro WSL usada para la integración con OpenCode en Windows.

`OPENCHAMBER_OPENCODE_WSL_DISTRO`

Alias específico de TokenWork para elegir la distro WSL. OPENCODE_WSL_DISTRO tiene prioridad si ambas están definidas.

`OPENCODE_JWT_SECRET`

Secreto para firmar tokens de autenticación de la UI. En servicios persistentes, usa un valor largo y aleatorio.

Terminal y Git

`OPENCHAMBER_TERMINAL_SHELL`

Ejecutable de shell para las sesiones de terminal en TokenWork.

`OPENCHAMBER_GIT_BINARY`

Ejecutable de Git usado por las funciones Git de TokenWork.

`GIT_BINARY`

Override alternativo para el ejecutable de Git. Para ajustes específicos de TokenWork, prefiere OPENCHAMBER_GIT_BINARY.

`OPENCHAMBER_GIT_READ_CACHE_TTL_MS`

TTL, en milisegundos, para lecturas de archivos con cache respaldadas por Git. Usa 0 para desactivar la cache al depurar.

Voz y túneles

`OPENAI_API_KEY`

API key para funciones de voz de TokenWork que llaman a servicios compatibles con OpenAI.

`OPENCHAMBER_ALLOW_REMOTE_OPENAI_COMPAT_URLS`

Permite base URLs remotas compatibles con OpenAI para funciones de voz cuando vale true o 1.

`NGROK_AUTHTOKEN`

Token de autenticación de ngrok usado por los comandos de túnel de TokenWork. También puedes configurarlo con ngrok config add-authtoken <token>.

Ayudas de runtime

`BUN_BINARY`

Ejecutable de Bun que TokenWork debe usar al iniciar procesos daemon.

`BUN_INSTALL`

Raíz de instalación de Bun. TokenWork la usa para encontrar bin/bun al iniciar daemons y actualizar.

`VITE_OPENCODE_URL`

API base URL de build-time para la web app construida con Vite. La mayoría de usuarios no debería usarla en CLI o desktop normales.