` | -- | Anulaciones de debounce por canal |
### `messages.tts`
Configuración de texto a voz.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `auto` | `"off" \| "always" \| "inbound" \| "tagged"` | -- | Modo auto-TTS (preferido sobre `enabled`) |
| `enabled` | `boolean` | -- | Heredado: habilitar auto-TTS cuando `auto` no está configurado |
| `mode` | `"final" \| "all"` | -- | Aplicar TTS solo a las respuestas finales o a todas las respuestas |
| `provider` | `"elevenlabs" \| "openai" \| "edge"` | -- | Proveedor primario de TTS |
| `summaryModel` | `string` | -- | Anulación de modelo para auto-resumen de TTS (proveedor/modelo o alias) |
| `maxTextLength` | `number` | -- | Límite máximo para texto enviado a TTS (caracteres) |
| `timeoutMs` | `number` | -- | Tiempo de espera de solicitud de API (ms) |
| `prefsPath` | `string` | -- | Ruta para el JSON de preferencias locales de TTS del usuario |
#### `messages.tts.modelOverrides`
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Habilitar anulaciones proporcionadas por el modelo para TTS |
| `allowText` | `boolean` | -- | Permitir bloques de texto TTS proporcionados por el modelo |
| `allowProvider` | `boolean` | -- | Permitir anulación de proveedor proporcionada por el modelo |
| `allowVoice` | `boolean` | -- | Permitir anulación de voice/voiceId proporcionada por el modelo |
| `allowModelId` | `boolean` | -- | Permitir anulación de modelId proporcionada por el modelo |
| `allowVoiceSettings` | `boolean` | -- | Permitir anulación de configuración de voz proporcionada por el modelo |
| `allowNormalization` | `boolean` | -- | Permitir anulaciones de normalización o idioma proporcionadas por el modelo |
| `allowSeed` | `boolean` | -- | Permitir anulación de seed proporcionada por el modelo |
#### `messages.tts.elevenlabs`
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `apiKey` | `string` | -- | Clave API de ElevenLabs |
| `baseUrl` | `string` | -- | URL base de ElevenLabs |
| `voiceId` | `string` | -- | ID de voz |
| `modelId` | `string` | -- | ID de modelo |
| `seed` | `number` | -- | Seed para generación determinista |
| `applyTextNormalization` | `"auto" \| "on" \| "off"` | -- | Normalización de texto |
| `languageCode` | `string` | -- | Código de idioma |
| `voiceSettings.stability` | `number` | -- | Estabilidad de voz |
| `voiceSettings.similarityBoost` | `number` | -- | Impulso de similitud |
| `voiceSettings.style` | `number` | -- | Estilo |
| `voiceSettings.useSpeakerBoost` | `boolean` | -- | Usar impulso de hablante |
| `voiceSettings.speed` | `number` | -- | Velocidad |
#### `messages.tts.openai`
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `apiKey` | `string` | -- | Clave API de OpenAI |
| `model` | `string` | -- | Modelo de TTS |
| `voice` | `string` | -- | Identificador de voz |
#### `messages.tts.edge`
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Permitir explícitamente Edge TTS (no requiere clave API) |
| `voice` | `string` | -- | Identificador de voz |
| `lang` | `string` | -- | Idioma |
| `outputFormat` | `string` | -- | Formato de salida |
| `pitch` | `string` | -- | Tono |
| `rate` | `string` | -- | Velocidad |
| `volume` | `string` | -- | Volumen |
| `saveSubtitles` | `boolean` | -- | Guardar subtítulos |
| `proxy` | `string` | -- | URL del proxy |
| `timeoutMs` | `number` | -- | Tiempo de espera (ms) |
---
## `commands`
Registro de comandos y control de acceso.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `native` | `NativeCommandsSetting` | `"auto"` | Habilitar registro de comandos nativos |
| `nativeSkills` | `NativeCommandsSetting` | `"auto"` | Habilitar registro de comandos nativos de habilidades |
| `text` | `boolean` | `true` | Habilitar análisis de comandos de texto |
| `bash` | `boolean` | `false` | Permitir comando de chat bash (`!` / alias `/bash`) |
| `bashForegroundMs` | `number` | `2000` | Cuánto espera bash antes de pasar a segundo plano (0 = inmediatamente) |
| `config` | `boolean` | `false` | Permitir comando `/config` |
| `debug` | `boolean` | `false` | Permitir comando `/debug` |
| `restart` | `boolean` | `false` | Permitir comandos/herramientas de reinicio |
| `useAccessGroups` | `boolean` | `true` | Aplicar listas de permitidos/políticas de grupos de acceso para comandos |
---
## `approvals`
Reenvío de aprobaciones de ejecución a canales de chat.
### `approvals.exec`
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `enabled` | `boolean` | `false` | Habilitar reenvío de aprobaciones de ejecución a canales de chat |
| `mode` | `"session" \| "targets" \| "both"` | `"session"` | Modo de entrega |
| `agentFilter` | `string[]` | -- | Solo reenviar para estos IDs de agentes (omitir = todos) |
| `sessionFilter` | `string[]` | -- | Solo reenviar para estos patrones de claves de sesión (subcadena o regex) |
| `targets` | `ExecApprovalForwardTarget[]` | -- | Destinos de entrega explícitos (usados cuando el modo incluye `"targets"`) |
#### ExecApprovalForwardTarget
| Campo | Tipo | Descripción |
|-------|------|-------------|
| `channel` | `string` | ID de canal (ej. `"discord"`, `"slack"`) |
| `to` | `string` | ID de destino (ID de canal/usuario dependiendo del canal) |
| `accountId` | `string` | ID de cuenta opcional para canales multi-cuenta |
| `threadId` | `string \| number` | ID de hilo opcional |
---
## `session`
Alcance de sesión, tiempo de espera por inactividad y configuración de reinicio.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `scope` | `SessionScope` | -- | Estrategia de alcance de sesión |
| `dmScope` | `DmScope` | `"main"` | Alcance de sesión de mensajes directos |
| `identityLinks` | `Record` | -- | Mapear identidades con prefijo de plataforma a pares canónicos de mensajes directos |
| `resetTriggers` | `string[]` | -- | Patrones de mensaje que activan un reinicio de sesión |
| `idleMinutes` | `number` | -- | Minutos de inactividad antes del reinicio de sesión |
| `reset` | `SessionResetConfig` | -- | Configuración global de reinicio de sesión |
| `resetByType` | `SessionResetByTypeConfig` | -- | Anulaciones de reinicio por tipo (dm, group, thread) |
| `resetByChannel` | `Record` | -- | Anulaciones de reinicio por canal |
| `store` | `string` | -- | Ruta del almacén de sesiones |
| `typingIntervalSeconds` | `number` | -- | Intervalo del indicador de escritura |
| `typingMode` | `TypingMode` | -- | Modo del indicador de escritura |
| `mainKey` | `string` | -- | Clave de sesión principal |
| `sendPolicy` | `SessionSendPolicyConfig` | -- | Política de envío de sesión |
| `agentToAgent.maxPingPongTurns` | `number` | `5` | Turnos máximos de ping-pong entre solicitante/objetivo (0--5) |
---
## `web`
Configuración del proveedor web de WhatsApp.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `enabled` | `boolean` | `true` | Habilitar el proveedor web de WhatsApp |
| `heartbeatSeconds` | `number` | -- | Intervalo de heartbeat |
| `reconnect.initialMs` | `number` | -- | Retardo inicial de reconexión (ms) |
| `reconnect.maxMs` | `number` | -- | Retardo máximo de reconexión (ms) |
| `reconnect.factor` | `number` | -- | Factor de retroceso |
| `reconnect.jitter` | `number` | -- | Factor de variación |
| `reconnect.maxAttempts` | `number` | -- | Intentos máximos de reconexión (0 = ilimitado) |
---
## `connectors`
Configuración de conectores de mensajería. Cada clave es un ID de conector (ej. `telegram`, `discord`, `slack`). La clave `channels` está obsoleta en favor de `connectors`.
```json
{
"connectors": {
"telegram": {
"enabled": true,
"botToken": "123456:ABC..."
},
"discord": {
"enabled": true,
"token": "Bot ..."
}
}
}
```
Campos comunes por conector:
| Campo | Tipo | Descripción |
|-------|------|-------------|
| `enabled` | `boolean` | Habilitar/deshabilitar sin eliminar la configuración |
| `botToken` / `token` / `apiKey` | `string` | Credencial de autenticación |
| `dmPolicy` | `"open" \| "pairing" \| "closed"` | Control de acceso a mensajes directos |
| `configWrites` | `boolean` | Permitir que el conector escriba configuración en eventos |
La clave `channels` está obsoleta. Migre a `connectors` para compatibilidad futura.
---
## `cron`
Configuración de tareas programadas.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Habilitar tareas cron |
| `store` | `string` | -- | Ruta de persistencia del estado cron |
| `maxConcurrentRuns` | `number` | -- | Ejecuciones concurrentes máximas de cron |
---
## `hooks`
Sistema de hooks basado en eventos: webhooks, integración con Gmail y hooks de eventos internos del agente.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Habilitar el sistema de hooks |
| `path` | `string` | -- | Ruta del endpoint de webhook |
| `token` | `string` | -- | Token de autenticación de webhook |
| `maxBodyBytes` | `number` | -- | Tamaño máximo del cuerpo del webhook |
| `presets` | `string[]` | -- | Presets de hooks para cargar |
| `transformsDir` | `string` | -- | Directorio para módulos de transformación de hooks |
| `mappings` | `HookMappingConfig[]` | -- | Array de reglas de mapeo de hooks |
### Configuración de mapeo de hooks (`hooks.mappings[]`)
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `id` | `string` | -- | Identificador del mapeo |
| `match.path` | `string` | -- | Patrón de ruta URL a coincidir |
| `match.source` | `string` | -- | Filtro de origen |
| `action` | `"wake" \| "agent"` | -- | Tipo de acción del hook |
| `wakeMode` | `"now" \| "next-heartbeat"` | -- | Cuándo despertar al agente |
| `name` | `string` | -- | Nombre del hook |
| `sessionKey` | `string` | -- | Anulación de clave de sesión |
| `messageTemplate` | `string` | -- | Plantilla para el contenido del mensaje |
| `textTemplate` | `string` | -- | Plantilla para el contenido de texto |
| `deliver` | `boolean` | -- | Si se debe entregar el resultado |
| `allowUnsafeExternalContent` | `boolean` | -- | **Peligroso:** Deshabilitar el envoltorio de seguridad de contenido externo |
| `channel` | `string` | -- | Canal de destino: `"last"`, `"whatsapp"`, `"telegram"`, `"discord"`, `"googlechat"`, `"slack"`, `"signal"`, `"imessage"`, `"msteams"` |
| `to` | `string` | -- | ID de destino |
| `model` | `string` | -- | Anulación de modelo para este hook (proveedor/modelo) |
| `thinking` | `string` | -- | Anulación del nivel de pensamiento |
| `timeoutSeconds` | `number` | -- | Tiempo de espera de procesamiento del hook |
| `transform.module` | `string` | -- | Ruta del módulo de transformación |
| `transform.export` | `string` | -- | Nombre de exportación del módulo de transformación |
### `hooks.gmail`
Integración de webhook de Gmail a través de Google Pub/Sub.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `account` | `string` | -- | Cuenta de Gmail |
| `label` | `string` | -- | Etiqueta de Gmail a observar |
| `topic` | `string` | -- | Tema de Pub/Sub |
| `subscription` | `string` | -- | Suscripción de Pub/Sub |
| `pushToken` | `string` | -- | Token de notificación push |
| `hookUrl` | `string` | -- | URL de webhook |
| `includeBody` | `boolean` | -- | Incluir cuerpo del correo |
| `maxBytes` | `number` | -- | Bytes máximos del cuerpo del correo |
| `renewEveryMinutes` | `number` | -- | Intervalo de renovación de observación (minutos) |
| `allowUnsafeExternalContent` | `boolean` | -- | **Peligroso:** Deshabilitar el envoltorio de seguridad de contenido externo |
| `serve.bind` | `string` | -- | Dirección de enlace del servidor local |
| `serve.port` | `number` | -- | Puerto del servidor local |
| `serve.path` | `string` | -- | Ruta del servidor local |
| `tailscale.mode` | `"off" \| "serve" \| "funnel"` | -- | Modo de exposición de Tailscale |
| `tailscale.path` | `string` | -- | Ruta de Tailscale |
| `tailscale.target` | `string` | -- | Destino serve/funnel de Tailscale (puerto, host:puerto o URL completa) |
| `model` | `string` | -- | Anulación de modelo para procesamiento del hook de Gmail |
| `thinking` | `"off" \| "minimal" \| "low" \| "medium" \| "high"` | -- | Anulación del nivel de pensamiento |
### `hooks.internal`
Hooks de eventos internos del agente.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Habilitar el sistema de hooks internos |
| `handlers` | `InternalHookHandlerConfig[]` | -- | Lista heredada de manejadores |
| `entries` | `Record` | -- | Anulaciones de configuración por hook (`enabled`, `env` y claves arbitrarias) |
| `load.extraDirs` | `string[]` | -- | Directorios adicionales de hooks para escanear |
| `installs` | `Record` | -- | Paquetes de hooks instalados |
#### InternalHookHandlerConfig
| Campo | Tipo | Descripción |
|-------|------|-------------|
| `event` | `string` | Clave de evento a escuchar (ej. `"command:new"`, `"session:start"`) |
| `module` | `string` | Ruta al módulo del manejador |
| `export` | `string` | Nombre de exportación del módulo (predeterminado: `"default"`) |
#### HookInstallRecord
| Campo | Tipo | Descripción |
|-------|------|-------------|
| `source` | `"npm" \| "archive" \| "path"` | Fuente de instalación |
| `spec` | `string` | Especificación npm o URL de archivo |
| `sourcePath` | `string` | Ruta de origen original |
| `installPath` | `string` | Ruta local de instalación |
| `version` | `string` | Versión instalada |
| `installedAt` | `string` | Marca de tiempo ISO de instalación |
| `hooks` | `string[]` | Nombres de hooks proporcionados por este paquete |
---
## `discovery`
Configuración de descubrimiento de red (mDNS y DNS-SD de área amplia).
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `wideArea.enabled` | `boolean` | -- | Habilitar descubrimiento DNS-SD de área amplia |
| `wideArea.domain` | `string` | -- | Dominio DNS-SD unicast (ej. `"eliza.internal"`) |
| `mdns.mode` | `"off" \| "minimal" \| "full"` | `"minimal"` | Modo de difusión mDNS (`off` = deshabilitado, `minimal` = omitir cliPath/sshPort, `full` = incluir todo) |
---
## `talk`
Configuración de voz del modo Talk de ElevenLabs.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `voiceId` | `string` | -- | ID de voz predeterminado de ElevenLabs |
| `voiceAliases` | `Record` | -- | Mapa de nombre de voz a ID de voz de ElevenLabs |
| `modelId` | `string` | -- | ID de modelo predeterminado de ElevenLabs |
| `outputFormat` | `string` | -- | Formato de salida predeterminado (ej. `mp3_44100_128`) |
| `apiKey` | `string` | -- | Clave API de ElevenLabs (respaldo a `ELEVENLABS_API_KEY`) |
| `interruptOnSpeech` | `boolean` | `true` | Dejar de hablar cuando el usuario comience a hablar |
---
## `gateway`
Configuración del servidor Gateway: puerto, dirección de enlace, TLS, autenticación, endpoints HTTP y enrutamiento de nodos.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `port` | `number` | `18789` | Puerto WS + HTTP del Gateway |
| `mode` | `"local" \| "remote"` | -- | Modo del Gateway (`"remote"` deshabilita el inicio local) |
| `bind` | `"auto" \| "lan" \| "loopback" \| "tailnet" \| "custom"` | `"loopback"` | Política de dirección de enlace |
| `customBindHost` | `string` | -- | IP personalizada para `bind="custom"` (respaldo: `0.0.0.0`) |
| `trustedProxies` | `string[]` | -- | IPs de proxies inversos de confianza para `x-forwarded-for` |
### `gateway.tls`
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Habilitar TLS para el servidor Gateway |
| `autoGenerate` | `boolean` | `true` | Auto-generar certificado autofirmado si cert/clave faltan |
| `certPath` | `string` | -- | Ruta del certificado PEM |
| `keyPath` | `string` | -- | Ruta de la clave privada PEM |
| `caPath` | `string` | -- | Ruta del paquete CA para mTLS o raíces personalizadas |
### `gateway.auth`
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `mode` | `"token" \| "password"` | `"token"` | Modo de autenticación |
| `token` | `string` | -- | Token compartido para modo token |
| `password` | `string` | -- | Contraseña compartida para modo contraseña |
| `allowTailscale` | `boolean` | -- | Permitir encabezados de identidad de Tailscale cuando el modo serve está habilitado |
### `gateway.controlUi`
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Servir la interfaz de control (predeterminado: `/`) |
| `basePath` | `string` | -- | Prefijo de ruta base (ej. `"/eliza"`) |
| `root` | `string` | -- | Raíz del sistema de archivos para activos de la interfaz de control (predeterminado: `dist/control-ui`) |
| `allowedOrigins` | `string[]` | -- | Orígenes de navegador permitidos para conexiones WebSocket |
| `allowInsecureAuth` | `boolean` | `false` | Permitir autenticación solo por token sobre HTTP inseguro |
| `dangerouslyDisableDeviceAuth` | `boolean` | `false` | **Peligroso:** Deshabilitar verificaciones de identidad de dispositivo |
### `gateway.tailscale`
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `mode` | `"off" \| "serve" \| "funnel"` | -- | Modo de exposición de Tailscale |
| `resetOnExit` | `boolean` | -- | Reiniciar configuración de serve/funnel al cerrar |
### `gateway.remote`
Configuración de conexión remota del Gateway.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `url` | `string` | -- | URL de WebSocket del Gateway remoto (`ws://` o `wss://`) |
| `transport` | `"ssh" \| "direct"` | -- | Transporte para conexiones remotas en macOS |
| `token` | `string` | -- | Token para autenticación remota |
| `password` | `string` | -- | Contraseña para autenticación remota |
| `tlsFingerprint` | `string` | -- | Huella digital esperada del certificado TLS (SHA-256) |
| `sshTarget` | `string` | -- | Destino SSH para tunneling (`user@host`) |
| `sshIdentity` | `string` | -- | Ruta del archivo de identidad SSH |
### `gateway.reload`
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `mode` | `"off" \| "restart" \| "hot" \| "hybrid"` | `"hybrid"` | Estrategia de recarga para cambios de configuración |
| `debounceMs` | `number` | `300` | Ventana de debounce para recargas de configuración (ms) |
### `gateway.http`
Configuración de endpoints de la API HTTP.
#### `gateway.http.endpoints.chatCompletions`
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `enabled` | `boolean` | `false` | Servir `POST /v1/chat/completions` |
#### `gateway.http.endpoints.responses`
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `enabled` | `boolean` | `false` | Servir `POST /v1/responses` (API OpenResponses) |
| `maxBodyBytes` | `number` | 20MB | Tamaño máximo del cuerpo de la solicitud (bytes) |
| `files.allowUrl` | `boolean` | `true` | Permitir obtención de URLs para `input_file` |
| `files.allowedMimes` | `string[]` | -- | Tipos MIME permitidos (insensible a mayúsculas) |
| `files.maxBytes` | `number` | 5MB | Bytes máximos por archivo |
| `files.maxChars` | `number` | 200k | Caracteres decodificados máximos por archivo |
| `files.maxRedirects` | `number` | `3` | Redirecciones máximas al obtener una URL |
| `files.timeoutMs` | `number` | 10s | Tiempo de espera de obtención (ms) |
| `files.pdf.maxPages` | `number` | `4` | Páginas máximas para analizar/renderizar |
| `files.pdf.maxPixels` | `number` | 4M | Píxeles máximos por página renderizada |
| `files.pdf.minTextChars` | `number` | `200` | Longitud mínima de texto para omitir rasterización (caracteres) |
| `images.allowUrl` | `boolean` | `true` | Permitir obtención de URLs para `input_image` |
| `images.allowedMimes` | `string[]` | -- | Tipos MIME permitidos (insensible a mayúsculas) |
| `images.maxBytes` | `number` | 10MB | Bytes máximos por imagen |
| `images.maxRedirects` | `number` | `3` | Redirecciones máximas |
| `images.timeoutMs` | `number` | 10s | Tiempo de espera de obtención (ms) |
### `gateway.nodes`
Configuración de enrutamiento de nodos.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `browser.mode` | `"auto" \| "manual" \| "off"` | `"auto"` | Política de enrutamiento de navegador para proxies de navegador alojados en nodos |
| `browser.node` | `string` | -- | Fijar a un ID/nombre de nodo específico |
| `allowCommands` | `string[]` | -- | Comandos `node.invoke` adicionales para permitir |
| `denyCommands` | `string[]` | -- | Comandos para denegar incluso si están en los valores predeterminados o reclamaciones del nodo |
---
## `memory`
Configuración del backend de memoria.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `backend` | `"builtin" \| "qmd"` | `"builtin"` | Backend de memoria |
| `citations` | `"auto" \| "on" \| "off"` | -- | Modo de citas |
| `qmd` | `MemoryQmdConfig` | -- | Configuración del backend de memoria QMD |
### `memory.qmd`
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `command` | `string` | -- | Comando del binario QMD |
| `includeDefaultMemory` | `boolean` | -- | Incluir ruta de memoria predeterminada |
| `paths` | `MemoryQmdIndexPath[]` | -- | Rutas de índice (cada una: `{ path, name?, pattern? }`) |
| `sessions.enabled` | `boolean` | -- | Habilitar indexación de sesiones |
| `sessions.exportDir` | `string` | -- | Directorio de exportación de sesiones |
| `sessions.retentionDays` | `number` | -- | Retención de sesiones (días) |
| `update.interval` | `string` | -- | Intervalo de actualización |
| `update.debounceMs` | `number` | -- | Debounce de actualización (ms) |
| `update.onBoot` | `boolean` | -- | Ejecutar actualización al iniciar |
| `update.embedInterval` | `string` | -- | Intervalo de actualización de embeddings |
| `limits.maxResults` | `number` | -- | Resultados máximos de búsqueda |
| `limits.maxSnippetChars` | `number` | -- | Caracteres máximos de fragmento |
| `limits.maxInjectedChars` | `number` | -- | Caracteres máximos inyectados |
| `limits.timeoutMs` | `number` | -- | Tiempo de espera de búsqueda (ms) |
| `scope` | `SessionSendPolicyConfig` | -- | Política de alcance |
---
## `embedding`
Configuración del modelo de embedding local (modelos GGUF con soporte GPU Metal).
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `model` | `string` | -- | Nombre de archivo del modelo GGUF (ej. `"nomic-embed-text-v1.5.Q5_K_M.gguf"`) |
| `modelRepo` | `string` | -- | Repositorio/fuente de Hugging Face para resolución de modelos |
| `dimensions` | `number` | `768` | Dimensión del vector de embedding |
| `contextSize` | `number` | -- | Tamaño de la ventana de contexto de embedding (debe coincidir con el modelo) |
| `gpuLayers` | `number \| "auto" \| "max"` | -- | Capas GPU para carga del modelo |
| `idleTimeoutMinutes` | `number` | `30` | Minutos de inactividad antes de descargar el modelo de la memoria (0 = nunca) |
---
## `database`
Proveedor de base de datos y configuración de conexión.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `provider` | `"pglite" \| "postgres"` | `"pglite"` | Proveedor de base de datos activo |
### `database.pglite`
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `dataDir` | `string` | `~/.eliza/workspace/.eliza/.elizadb` | Directorio de datos de PGLite |
### `database.postgres`
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `connectionString` | `string` | -- | Cadena de conexión completa de PostgreSQL (tiene prioridad sobre campos individuales) |
| `host` | `string` | `localhost` | Host de PostgreSQL |
| `port` | `number` | `5432` | Puerto de PostgreSQL |
| `database` | `string` | -- | Nombre de la base de datos |
| `user` | `string` | -- | Usuario de la base de datos |
| `password` | `string` | -- | Contraseña de la base de datos |
| `ssl` | `boolean` | `false` | Habilitar conexión SSL |
---
## `cloud`
Integración con Eliza Cloud para aprovisionamiento remoto de agentes, proxy de inferencia y respaldo de estado.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `enabled` | `boolean` | `false` | Habilitar integración con Eliza Cloud |
| `provider` | `string` | -- | ID del proveedor de nube (ej. `"elizacloud"`; establecido durante la incorporación) |
| `baseUrl` | `string` | `https://elizacloud.ai/api/v1` | URL base de la API |
| `apiKey` | `string` | -- | Clave API en caché (almacenada cifrada a través de autenticación del gateway) |
| `inferenceMode` | `"cloud" \| "byok" \| "local"` | -- | Enrutamiento de inferencia: `cloud` (con proxy), `byok` (claves del usuario), `local` (sin nube) |
| `autoProvision` | `boolean` | `false` | Auto-desplegar agentes en la nube al crearlos |
### `cloud.bridge`
Configuración de comunicación WebSocket para agentes en la nube.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `reconnectIntervalMs` | `number` | `3000` | Intervalo base de reconexión (ms) |
| `maxReconnectAttempts` | `number` | `20` | Intentos máximos de reconexión |
| `heartbeatIntervalMs` | `number` | `30000` | Intervalo de heartbeat (ms) |
### `cloud.backup`
Configuración de snapshots del estado del agente.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `autoBackupIntervalMs` | `number` | `3600000` (1 hora) | Intervalo de auto-respaldo (ms) |
| `maxSnapshots` | `number` | `10` | Máximo de auto-snapshots a retener |
### `cloud.container`
Configuración predeterminada de contenedores para nuevos despliegues en la nube.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `defaultImage` | `string` | -- | URI de imagen ECR predeterminada para contenedores de agentes |
| `defaultArchitecture` | `"arm64" \| "x86_64"` | `"arm64"` | Arquitectura de CPU predeterminada |
| `defaultCpu` | `number` | `1792` | Unidades de CPU predeterminadas |
| `defaultMemory` | `number` | `1792` | Memoria predeterminada (MB) |
| `defaultPort` | `number` | `2138` | Puerto predeterminado del contenedor |
---
## `x402`
Configuración del protocolo de pago HTTP x402.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Habilitar pagos x402 |
| `privateKey` | `string` | -- | Clave privada de la billetera |
| `network` | `string` | -- | Identificador de red |
| `payTo` | `string` | -- | Dirección del destinatario del pago |
| `facilitatorUrl` | `string` | -- | URL del servicio facilitador |
| `maxPaymentUsd` | `number` | -- | Pago máximo individual (USD) |
| `maxTotalUsd` | `number` | -- | Pagos totales máximos (USD) |
| `dbPath` | `string` | -- | Ruta de la base de datos de pagos |
---
## `media`
Configuración de generación de medios (proveedores de imagen, video, audio, visión).
### `media.image`
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Habilitar generación de imágenes |
| `mode` | `"cloud" \| "own-key"` | -- | Nube (con proxy) o clave API propia |
| `provider` | `"cloud" \| "fal" \| "openai" \| "google" \| "xai"` | -- | Proveedor de imágenes |
| `defaultSize` | `string` | -- | Tamaño de imagen predeterminado |
| `fal` | `{ apiKey?, model?, baseUrl? }` | -- | Configuración de Fal.ai |
| `openai` | `{ apiKey?, model?, quality?, style? }` | -- | Configuración de OpenAI (`quality`: `"standard"` o `"hd"`, `style`: `"natural"` o `"vivid"`) |
| `google` | `{ apiKey?, model?, aspectRatio? }` | -- | Configuración de Google |
| `xai` | `{ apiKey?, model? }` | -- | Configuración de xAI |
### `media.video`
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Habilitar generación de video |
| `mode` | `"cloud" \| "own-key"` | -- | Nube (con proxy) o clave API propia |
| `provider` | `"cloud" \| "fal" \| "openai" \| "google"` | -- | Proveedor de video |
| `defaultDuration` | `number` | -- | Duración de video predeterminada |
| `fal` | `{ apiKey?, model?, baseUrl? }` | -- | Configuración de Fal.ai |
| `openai` | `{ apiKey?, model? }` | -- | Configuración de OpenAI |
| `google` | `{ apiKey?, model? }` | -- | Configuración de Google |
### `media.audio`
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Habilitar generación de audio |
| `mode` | `"cloud" \| "own-key"` | -- | Nube (con proxy) o clave API propia |
| `provider` | `"cloud" \| "suno" \| "elevenlabs"` | -- | Proveedor de audio |
| `suno` | `{ apiKey?, model?, baseUrl? }` | -- | Configuración de Suno |
| `elevenlabs` | `{ apiKey?, duration? }` | -- | Configuración de SFX de ElevenLabs |
### `media.vision`
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Habilitar visión (comprensión de imágenes) |
| `mode` | `"cloud" \| "own-key"` | -- | Nube (con proxy) o clave API propia |
| `provider` | `"cloud" \| "openai" \| "google" \| "anthropic" \| "xai" \| "ollama"` | -- | Proveedor de visión |
| `openai` | `{ apiKey?, model?, maxTokens? }` | -- | Configuración de OpenAI |
| `google` | `{ apiKey?, model? }` | -- | Configuración de Google |
| `anthropic` | `{ apiKey?, model? }` | -- | Configuración de Anthropic |
| `xai` | `{ apiKey?, model? }` | -- | Configuración de xAI |
| `ollama` | `{ baseUrl?, model?, maxTokens?, autoDownload? }` | -- | Configuración de Ollama |
---
## `mcp`
Definiciones de servidores MCP (Model Context Protocol).
```json
{
"mcp": {
"servers": {
"my-server": {
"type": "stdio",
"command": "bunx",
"args": ["-y", "@some/mcp-server"],
"env": { "API_KEY": "..." }
},
"remote-server": {
"type": "sse",
"url": "https://mcp.example.com/sse",
"headers": { "Authorization": "Bearer ..." }
}
}
}
}
```
### Entrada de servidor MCP
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `type` | `string` | -- | Tipo de servidor (ej. `"stdio"`, `"sse"`) |
| `command` | `string` | -- | Comando a ejecutar (para tipo `stdio`) |
| `args` | `string[]` | -- | Argumentos del comando |
| `url` | `string` | -- | URL del servidor (para tipos `sse` o remotos) |
| `env` | `Record` | -- | Variables de entorno para el proceso del servidor |
| `headers` | `Record` | -- | Encabezados HTTP para conexiones remotas |
| `cwd` | `string` | -- | Directorio de trabajo para el proceso del servidor |
| `timeoutInMillis` | `number` | -- | Tiempo de espera de conexión (ms) |
---
## `registry`
Registro de agentes ERC-8004 y configuración de la colección NFT ElizaMaker.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `mainnetRpc` | `string` | -- | URL RPC de mainnet de Ethereum (o Anvil local) |
| `registryAddress` | `string` | -- | Dirección del contrato ElizaAgentRegistry |
| `collectionAddress` | `string` | -- | Dirección del contrato de la colección ElizaMaker |
---
## `features`
Indicadores de características para auto-habilitación de plugins y alternancia de funciones. Cada clave mapea a un booleano o a un objeto con `enabled` y opciones adicionales.
```json
{
"features": {
"shellEnabled": true,
"someFeature": { "enabled": true, "option": "value" }
}
}
```
---
## `customActions`
Acciones personalizadas definidas por el usuario para el agente. Array de objetos `CustomActionDef`.
| Campo | Tipo | Predeterminado | Descripción |
|-------|------|---------|-------------|
| `id` | `string` | -- | **Requerido.** Identificador único de la acción |
| `name` | `string` | -- | **Requerido.** Nombre para mostrar de la acción |
| `description` | `string` | -- | **Requerido.** Descripción de la acción |
| `similes` | `string[]` | -- | Frases alternativas de activación |
| `parameters` | `Array<{ name, description, required }>` | -- | **Requerido.** Parámetros de la acción |
| `handler` | `CustomActionHandler` | -- | **Requerido.** Definición del manejador (ver sub-tabla) |
| `enabled` | `boolean` | -- | **Requerido.** Si la acción está habilitada |
| `createdAt` | `string` | -- | **Requerido.** Marca de tiempo ISO de creación |
| `updatedAt` | `string` | -- | **Requerido.** Marca de tiempo ISO de última actualización |
### CustomActionHandler
El manejador es uno de tres tipos:
**Manejador HTTP:**
| Campo | Tipo | Descripción |
|-------|------|-------------|
| `type` | `"http"` | Tipo de manejador |
| `method` | `string` | Método HTTP |
| `url` | `string` | URL de la solicitud |
| `headers` | `Record` | Encabezados opcionales de solicitud |
| `bodyTemplate` | `string` | Plantilla opcional del cuerpo de la solicitud |
**Manejador de shell:**
| Campo | Tipo | Descripción |
|-------|------|-------------|
| `type` | `"shell"` | Tipo de manejador |
| `command` | `string` | Comando de shell a ejecutar |
**Manejador de código:**
| Campo | Tipo | Descripción |
|-------|------|-------------|
| `type` | `"code"` | Tipo de manejador |
| `code` | `string` | Código JavaScript a ejecutar |