Skip to content

Configuración: CLIProxyAPI

Conecta TomoriBot a un servicio ascendente autorizado mediante CLIProxyAPI, un proxy local de Chat Completions.

Sigue la guía rápida oficial. Los archivos de versiones contienen ejecutables listos para usar; elige tu sistema operativo y CPU, extrae el archivo y verifica su suma de verificación. Compilar desde un clon de Git es opcional.

Configura CLIProxyAPI antes de iniciarlo. Si el instalador inició un servicio, deténlo primero.

Crea config.yaml junto al ejecutable (cli-proxy-api.exe en Windows). Una carpeta de configuración separada es opcional; estos ejemplos mantienen ambos archivos juntos. Reemplaza el marcador de posición de la clave de cliente por al menos 32 bytes aleatorios codificados en hexadecimal o base64, generados por tu gestor de contraseñas.

config-version: 8
server:
host: "127.0.0.1"
port: 8317
discovery:
enabled: false
management:
allow-remote: false
secret-key: ""
disable-control-panel: true
access:
api-keys:
- "REPLACE_WITH_RANDOM_CLIENT_KEY"
oauth:
auth-dir: "~/.cli-proxy-api"

La clave de cliente bajo access.api-keys autentica a TomoriBot ante CLIProxyAPI. Mantén config.yaml y los archivos de credenciales de oauth.auth-dir privados y fuera de Git. Restringe el acceso únicamente a tu cuenta y a la cuenta del proceso.

Deja MANAGEMENT_PASSWORD sin definir y evita --password y la TUI de administración: el secreto de administración vacío mantiene las rutas de administración desactivadas, incluso detrás del túnel. Si tu versión usa un formato de configuración distinto, aplica estos ajustes en su archivo config.example.yaml incluido.

Elige cómo CLIProxyAPI se autentica ante el proveedor del modelo. Ambos métodos usan la configuración base anterior.

Ejecuta el comando de inicio de sesión desde la carpeta que contiene el ejecutable y config.yaml. Estos ejemplos usan Antigravity; sustituye la bandera por la de tu proveedor y revisa su pantalla de consentimiento antes de iniciar sesión:

ProveedorBandera de inicio de sesión
Antigravity--antigravity-login
Claude--claude-login
Codex--codex-login o --codex-device-login
Terminal window
$configPath = (Resolve-Path .\config.yaml).Path
.\cli-proxy-api.exe --config $configPath --antigravity-login

Completa el inicio de sesión en el navegador y espera a que la terminal informe éxito. CLIProxyAPI guarda las credenciales en oauth.auth-dir; una configuración solo con OAuth no necesita ningún bloque de clave de API ascendente. Mantén locales los receptores de retorno de OAuth y usa la misma ruta de configuración para iniciar sesión y para iniciar el servidor. En --help y en las guías de proveedores ascendentes se enumeran otras banderas de inicio de sesión.

Inicia el servidor desde la carpeta que contiene config.yaml. Sustituye la ruta real del ejecutable o el comando instalado si es necesario; mantén --config para que cargue este archivo.

Terminal window
$configPath = (Resolve-Path .\config.yaml).Path
.\cli-proxy-api.exe --config $configPath

Deja el servidor en ejecución y continúa con el paso 5. Mantén server.host en 127.0.0.1; no se necesita ninguna excepción de firewall entrante ni redireccionamiento de puertos en el router.

  1. Para un bot que no sea de producción y se ejecute en la misma computadora que CLIProxyAPI, configura ALLOW_PRIVATE_NETWORK=127.0.0.1:8317 en el entorno de TomoriBot y reinicia el bot. Usa el receptor local configurado arriba; no se necesita ningún túnel.
  2. Ejecuta /providers (administradores del servidor) o /personal providers y agrega un punto de conexión personalizado Compatible con OpenAI con estos ajustes:
CampoValor
URL del punto de conexiónhttp://127.0.0.1:8317/v1
Token de autenticaciónLa clave de cliente de access.api-keys

Selecciona la conexión guardada, agrega un Modelo de texto usando un ID o alias servido por CLIProxyAPI y confirma una respuesta en Discord.

Esta URL asume que el bot se ejecuta directamente en el host. En Docker, 127.0.0.1 identifica al contenedor, por lo que no puede alcanzar el receptor del host mediante esa dirección. Un bot en modo de producción aún requiere la ruta de producción alojada.

Cómo listar los modelos disponibles

Con CLIProxyAPI en ejecución, abre otra terminal para listar sus IDs de modelos. Desactiva las transcripciones de PowerShell o el rastreo de shell antes de cargar la clave de cliente. Cierra esta terminal cuando termines.

Ejecuta esto desde la carpeta que contiene config.yaml; lee la primera clave de cliente de la estructura anterior.

Terminal window
$keyMatch = [regex]::Match((Get-Content -LiteralPath .\config.yaml -Raw), '(?m)^access:\r?\n api-keys:\r?\n - "([A-Za-z0-9+/=_-]+)"[ \t]*\r?$')
if (!$keyMatch.Success) { throw 'Expected a quoted client key under access.api-keys in config.yaml.' }
$engineKey = $keyMatch.Groups[1].Value
$headers = @{ Authorization = "Bearer $engineKey" }
$base = 'http://127.0.0.1:8317/v1'
$models = Invoke-RestMethod "$base/models" -Headers $headers
$models.data | Select-Object id
Remove-Variable engineKey, keyMatch, headers

Una lista vacía requiere configuración ascendente. HTTP 401 significa que el servidor respondió, pero rechazó la clave de cliente.

SíntomaAcción
401Revisa la clave de cliente, por separado de la clave ascendente.
404Usa la base /v1, sin /chat/completions; verifica el ID del modelo.
Parámetros rechazadosDeja el reemplazo de contexto en blanco y el razonamiento en Auto; TomoriBot ya reintenta rechazos de parámetros elegibles antes de que comience la salida. Revisa los registros en busca de solicitudes degradadas antes de activar herramientas o depender de controles de muestreo.
403, página HTML de inicio de sesión o errores de túnelRevisa la configuración del túnel. Si activaste Cloudflare Access, requiere la configuración opcional de Access y Caddy; el panel de Discord no puede enviar encabezados de Access directamente.
El flujo se detieneRevisa la suspensión de la PC, la cuota ascendente, el estado del túnel y los límites de flujo en la guía de Cloudflare.

Mantén el registro de solicitudes o depuración apagado a menos que estés diagnosticando una reproducción local censurada. Rota cualquier clave de cliente filtrada en CLIProxyAPI y en el punto de conexión guardado de TomoriBot, además de cualquier relé opcional que la use. Revoca por separado las credenciales ascendentes filtradas.

Retirar un inicio de sesión de cuenta

Revoca el acceso en los ajustes de la cuenta ascendente, detén el proxy y elimina sus archivos locales de credenciales. Eliminar solo los archivos no revoca los tokens.

Comprobar la dirección de enlace local

Si la API local es inaccesible, comprueba su dirección de enlace desde otra terminal mientras CLIProxyAPI está en ejecución:

Terminal window
Get-NetTCPConnection -LocalPort 8317 |
Select-Object LocalAddress, LocalPort, State, OwningProcess

Espera únicamente 127.0.0.1; detente si ves 0.0.0.0, ::, * o una dirección de LAN. Revisa las reglas de firewall existentes (wf.msc en Windows); no abras ningún puerto entrante ni agregues redireccionamiento de puertos en el router. El informe de estado TCP de Windows puede omitir un punto de conexión accesible, por lo que la consulta incluye todos los estados; la consulta opcional de modelos prueba la accesibilidad de la API.

Probar una respuesta local

Si un modelo falla al responder en Discord, pruébalo directamente mientras CLIProxyAPI está en ejecución. Desactiva las transcripciones de PowerShell o el rastreo de shell antes de cargar la clave de cliente.

Ejecuta esto desde la carpeta que contiene config.yaml; lee la primera clave de cliente de la estructura anterior.

Terminal window
$keyMatch = [regex]::Match((Get-Content -LiteralPath .\config.yaml -Raw), '(?m)^access:\r?\n api-keys:\r?\n - "([A-Za-z0-9+/=_-]+)"[ \t]*\r?$')
if (!$keyMatch.Success) { throw 'Expected a quoted client key under access.api-keys in config.yaml.' }
$engineKey = $keyMatch.Groups[1].Value
$headers = @{ Authorization = "Bearer $engineKey" }
$base = 'http://127.0.0.1:8317/v1'
$body = @{
model = Read-Host 'Model ID to test'
messages = @(@{ role = 'user'; content = 'Reply with hello.' })
stream = $false
} | ConvertTo-Json -Depth 4
$reply = Invoke-RestMethod "$base/chat/completions" -Method Post -Headers $headers -ContentType 'application/json' -Body $body
$reply.choices.message.content
Remove-Variable engineKey, keyMatch, headers

Una respuesta generada confirma el acceso ascendente. Que la consulta de sockets no devuelva nada por sí sola no demuestra que la API sea inaccesible.