config.json

config.json es el archivo de configuración propio del relay: su puerto, quién puede llegar a él, el token de acceso, los temporizadores que deciden cuándo un turn se considera atascado, y los túneles y la preview lane opcionales. oar setup lo crea. Lo editas a mano para todo lo que la configuración inicial no pregunta.

La mayor parte de lo que ajustas en la interfaz web no está en este archivo. Consulta Ajustes en la interfaz web y en el entorno.

Dónde está el archivo #

OAR_STATE_ROOT traslada toda la carpeta de estado de una instalación global (configuración, datos y registros); consulta Dónde guarda OAR sus archivos.

COPILOT_WEB_RELAY_CONFIG apunta el relay a un archivo concreto, esté donde esté, pero solo cuando el relay se inicia sin el lanzador propio de oar: node server/server.js, u oar copilot (cuando el archivo existe). oar setup, oar start, oar restart y el servicio usan siempre el config.json propio de la instalación, diga lo que diga la variable. En un checkout sin server/config.json, oar copilot crea su archivo en ~/.config/copilot-remote en su lugar (%LOCALAPPDATA%\copilot-remote en Windows). Consulta Variables de entorno.

El relay mantiene el archivo legible solo para su propietario (modo 0600 en macOS y Linux), porque contiene el token de acceso en texto plano. Trata una copia del archivo como una contraseña.

Quién lo escribe #

• oar setup escribe el token, localhostOnly y port, y deja cada una de las demás claves tal como la encuentra. Un archivo que crea, o uno al que le faltan, recibe además pollIntervalMs, processingTimeoutMs (600000) y conversationSessionMode. Consulta oar setup y el primer arranque.
• El relay escribe cliBinaries cuando instalas o actualizas la CLI de un proveedor desde Settings (Ajustes). Solo cambia esa clave. Si no puede leer el archivo como JSON, se niega a escribir y conserva la asociación solo para el proceso en marcha.
• El relay crea el archivo cuando no existe ninguno al arrancar, con un authToken vacío, el puerto 3333, localhostOnly: true, pollIntervalMs y conversationSessionMode. También elimina una clave features que haya quedado de versiones anteriores (consulta Claves obsoletas, ignoradas e internas).
• Tú, en cualquier editor de texto.

Editarlo a mano #

El archivo es un único objeto JSON. Las claves que omites toman su valor predeterminado, y un bloque anidado como previews se lee entero. Edítalo y luego reinicia el relay: el relay lee el archivo una sola vez, al arrancar. Nada de lo que tiene un relay en marcha cambia cuando guardas el archivo. Reinicia con oar restart (instalaciones globales), o con 🌄 Restart web relay (Reiniciar el relay web) en el menú ⋯ de una conversación.

• Una clave desconocida se ignora y se conserva. La configuración inicial y las escrituras propias del relay la dejan en su sitio.
• Un JSON no válido no detiene el relay. Registra Failed to read config.json, using defaults. y funciona con los valores predeterminados: puerto 3333, solo esta máquina y un token aleatorio que es nuevo en cada arranque y se imprime en el registro. Tu token guardado deja de funcionar hasta que arreglas el archivo. Un segundo lector, el que elige la carpeta de datos, recurre a la carpeta predeterminada. El relay no toca el archivo roto.
• Un valor incorrecto se trata clave por clave. Los valores predeterminados de abajo son los que usa el relay cuando falta un temporizador o un límite o no se puede usar. Los túneles y la preview lane se quedan desactivados y registran el motivo; el relay en sí sigue funcionando.
• La línea de comandos gana al archivo durante una ejecución: --token <value> y --port <number> en node server/server.js (oar copilot también los pasa; oar start no) anulan authToken y port y nunca se guardan en el archivo. Un --port que no sea un número del 1 al 65535 se ignora con una advertencia.

Red y acceso #

Para la primera conexión, el token y el acceso por LAN, consulta el primer arranque.

Turns y temporizadores #

La duración máxima del turn, el tiempo límite de las tareas en segundo plano y las vigilancias de inactividad no están aquí: consulta Cuando un turn se atasca.

Reinicios y apagado #

Estas claves determinan el reinicio planificado del relay (🌄 Restart web relay). Consulta Reinicios y reanudación. Cada temporizador se expresa en milisegundos; un valor de 0 o menor, o uno que no sea un número, usa el predeterminado.

Memoria Nuevo en 0.9.19 #

Workspace y datos #

CLI de los proveedores #

Esto importa allí donde el relay habla él mismo con la CLI de Copilot instalada, por ejemplo para importar sesiones de Copilot existentes y para listar modelos. La búsqueda mira en la caché de paquetes de la CLI de Copilot (COPILOT_PKG_DIR añade una carpeta en la que buscar primero). Consulta GitHub Copilot.

Vistas previas #

El bloque previews activa la preview lane: un segundo listener con su propio puerto y nombre de host que publica servidores de desarrollo y carpetas locales. La configuración, los nombres de host y el proxy frontal están en la página de la herramienta preview.

Si una de estas reglas no se cumple con las vistas previas activadas, el relay registra PREVIEW LANE disabled con el motivo, deja la lane desactivada y sigue funcionando.

Estas variables de entorno anulan las claves correspondientes: COPILOT_PREVIEWS_ENABLED (1, true, 0, false), COPILOT_PREVIEWS_PORT, COPILOT_PREVIEWS_BIND_HOST, COPILOT_PREVIEWS_PUBLIC_BASE_URL y COPILOT_PREVIEWS_ALLOWED_TARGET_HOSTS (separados por comas).

Túneles #

Dos túneles pueden llegar al relay desde fuera de tu red. Son independientes y pueden funcionar a la vez. Los dos están desactivados de forma predeterminada, y un túnel gestionado al que le falta un valor obligatorio se queda desactivado y registra por qué.

sshTunnel #

Un túnel SSH inverso hacia un servidor tuyo. Consulta Túnel SSH.

cloudflaredTunnel #

Ejecuta cloudflared de Cloudflare, que instalas tú; OAR no incluye ninguno. Consulta Cloudflare Tunnel.

Ajustes en la interfaz web y en el entorno #

Los ajustes de la interfaz web no están en este archivo. Los interruptores y las claves de los proveedores, las listas de modelos, la duración máxima del turn, el tiempo límite de las tareas en segundo plano y los flags de funciones se guardan en la base de datos del relay, en la carpeta de datos. El archivo contiene lo que el relay necesita antes de abrir la base de datos (la carpeta de datos, el puerto, el token) y datos sobre la máquina (rutas de CLI, túneles). Lo único que la interfaz escribe en el archivo es cliBinaries. Nuevo en 0.9.17 DeepSeek tampoco tiene ninguna clave aquí: su clave de API, su URL base y su presupuesto se guardan desde Settings → Providers → DeepSeek (Ajustes → Proveedores → DeepSeek) en la base de datos.

Variables de entorno. La lista completa está en Variables de entorno. Cuando existe una variable para una clave, la variable gana al archivo: COPILOT_WEB_RELAY_DATA_DIR (dataDir), COPILOT_WORKSPACE_ROOT_ALLOW_LIST, COPILOT_CLOUDFLARED_* y COPILOT_PREVIEWS_* (enumeradas en sus secciones). COPILOT_TUNNEL_MARKER_HEADERS es la excepción: sus nombres se suman a tunnelMarkerHeaders. Las opciones --token y --port ganan a ambos durante una ejecución. COPILOT_WEB_RELAY_CONFIG se explica en Dónde está el archivo.

Un ejemplo #

Todos los valores son inventados. Borra los bloques que no uses.

{
  "authToken": "0f3c1a9e-example-token-do-not-copy",
  "port": 3333,
  "localhostOnly": false,
  "remotePath": "",
  "trustProxy": "loopback",
  "allowedOrigins": [],
  "publicHostnames": ["relay.example.com"],
  "tunnelMarkerHeaders": ["x-edge-request-id"],
  "processingTimeoutMs": 600000,
  "maxRequeueRetries": 5,
  "contextIndicatorMode": "bar",
  "workspaceRootAllowList": ["/home/dev/projects", "/srv/sites"],
  "dataDir": "data",
  "cliBinaries": {
    "claude": "/home/dev/.local/bin/claude",
    "grok": "/home/dev/.grok/bin/grok"
  },
  "restartShutdownTimeoutMs": 45000,
  "restartGracefulTimeoutMs": 8000,
  "restartSpawnTimeoutMs": 18000,
  "restartRebindTimeoutMs": 20000,
  "restartReadyCooldownMs": 1000,
  "restartMaxAttempts": 3,
  "restartRetryBackoffMs": [1000, 3000, 7000],
  "previews": {
    "enabled": true,
    "port": 3334,
    "bindHost": "127.0.0.1",
    "allowPublicBind": false,
    "publicBaseUrl": "https://preview.example.com",
    "allowedTargetHosts": [],
    "maxLive": 8
  },
  "sshTunnel": {
    "mode": "managed",
    "required": false,
    "user": "ubuntu",
    "host": "vps.example.com",
    "remotePort": 4444,
    "remoteBind": "loopback",
    "identityFile": "~/.ssh/id_ed25519"
  },
  "cloudflaredTunnel": {
    "mode": "disabled",
    "token": "",
    "binary": "cloudflared",
    "extraArgs": []
  }
}

Claves obsoletas, ignoradas e internas #

Si encuentras una de estas en un archivo, puedes dejarla o borrarla: