` | -- | Surcharges anti-rebond par canal |
### `messages.tts`
Configuration de la synthèse vocale.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `auto` | `"off" \| "always" \| "inbound" \| "tagged"` | -- | Mode TTS automatique (préféré à `enabled`) |
| `enabled` | `boolean` | -- | Hérité : activer le TTS automatique lorsque `auto` n'est pas défini |
| `mode` | `"final" \| "all"` | -- | Appliquer le TTS aux réponses finales uniquement ou à toutes les réponses |
| `provider` | `"elevenlabs" \| "openai" \| "edge"` | -- | Fournisseur TTS principal |
| `summaryModel` | `string` | -- | Surcharge de modèle pour le résumé automatique TTS (fournisseur/modèle ou alias) |
| `maxTextLength` | `number` | -- | Plafond strict du texte envoyé au TTS (caractères) |
| `timeoutMs` | `number` | -- | Délai d'attente de la requête API (ms) |
| `prefsPath` | `string` | -- | Chemin du fichier JSON de préférences TTS locales |
#### `messages.tts.modelOverrides`
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Activer les surcharges fournies par le modèle pour le TTS |
| `allowText` | `boolean` | -- | Autoriser les blocs de texte TTS fournis par le modèle |
| `allowProvider` | `boolean` | -- | Autoriser la surcharge de fournisseur fournie par le modèle |
| `allowVoice` | `boolean` | -- | Autoriser la surcharge de voix/voiceId fournie par le modèle |
| `allowModelId` | `boolean` | -- | Autoriser la surcharge de modelId fournie par le modèle |
| `allowVoiceSettings` | `boolean` | -- | Autoriser la surcharge des paramètres de voix fournie par le modèle |
| `allowNormalization` | `boolean` | -- | Autoriser les surcharges de normalisation ou de langue fournies par le modèle |
| `allowSeed` | `boolean` | -- | Autoriser la surcharge de seed fournie par le modèle |
#### `messages.tts.elevenlabs`
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `apiKey` | `string` | -- | Clé API ElevenLabs |
| `baseUrl` | `string` | -- | URL de base ElevenLabs |
| `voiceId` | `string` | -- | ID de voix |
| `modelId` | `string` | -- | ID de modèle |
| `seed` | `number` | -- | Seed pour la génération déterministe |
| `applyTextNormalization` | `"auto" \| "on" \| "off"` | -- | Normalisation du texte |
| `languageCode` | `string` | -- | Code de langue |
| `voiceSettings.stability` | `number` | -- | Stabilité de la voix |
| `voiceSettings.similarityBoost` | `number` | -- | Amplification de la similarité |
| `voiceSettings.style` | `number` | -- | Style |
| `voiceSettings.useSpeakerBoost` | `boolean` | -- | Utiliser l'amplification du locuteur |
| `voiceSettings.speed` | `number` | -- | Vitesse |
#### `messages.tts.openai`
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `apiKey` | `string` | -- | Clé API OpenAI |
| `model` | `string` | -- | Modèle TTS |
| `voice` | `string` | -- | Identifiant de voix |
#### `messages.tts.edge`
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Autoriser explicitement Edge TTS (aucune clé API requise) |
| `voice` | `string` | -- | Identifiant de voix |
| `lang` | `string` | -- | Langue |
| `outputFormat` | `string` | -- | Format de sortie |
| `pitch` | `string` | -- | Hauteur |
| `rate` | `string` | -- | Débit |
| `volume` | `string` | -- | Volume |
| `saveSubtitles` | `boolean` | -- | Enregistrer les sous-titres |
| `proxy` | `string` | -- | URL du proxy |
| `timeoutMs` | `number` | -- | Délai d'attente (ms) |
---
## `commands`
Enregistrement des commandes et contrôle d'accès.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `native` | `NativeCommandsSetting` | `"auto"` | Activer l'enregistrement des commandes natives |
| `nativeSkills` | `NativeCommandsSetting` | `"auto"` | Activer l'enregistrement des commandes natives de compétences |
| `text` | `boolean` | `true` | Activer l'analyse des commandes textuelles |
| `bash` | `boolean` | `false` | Autoriser la commande de chat bash (`!` / alias `/bash`) |
| `bashForegroundMs` | `number` | `2000` | Durée d'attente de bash avant la mise en arrière-plan (0 = immédiatement) |
| `config` | `boolean` | `false` | Autoriser la commande `/config` |
| `debug` | `boolean` | `false` | Autoriser la commande `/debug` |
| `restart` | `boolean` | `false` | Autoriser les commandes/outils de redémarrage |
| `useAccessGroups` | `boolean` | `true` | Appliquer les listes d'autorisation/politiques des groupes d'accès pour les commandes |
---
## `approvals`
Transfert des approbations d'exécution vers les canaux de discussion.
### `approvals.exec`
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `enabled` | `boolean` | `false` | Activer le transfert des approbations d'exécution vers les canaux de discussion |
| `mode` | `"session" \| "targets" \| "both"` | `"session"` | Mode de livraison |
| `agentFilter` | `string[]` | -- | Transférer uniquement pour ces IDs d'agents (omettre = tous) |
| `sessionFilter` | `string[]` | -- | Transférer uniquement pour ces motifs de clés de session (sous-chaîne ou regex) |
| `targets` | `ExecApprovalForwardTarget[]` | -- | Cibles de livraison explicites (utilisées lorsque le mode inclut `"targets"`) |
#### ExecApprovalForwardTarget
| Champ | Type | Description |
|-------|------|-------------|
| `channel` | `string` | ID du canal (ex. `"discord"`, `"slack"`) |
| `to` | `string` | ID de destination (ID de canal/utilisateur selon le canal) |
| `accountId` | `string` | ID de compte optionnel pour les canaux multi-comptes |
| `threadId` | `string \| number` | ID de fil optionnel |
---
## `session`
Portée de session, délai d'inactivité et configuration de réinitialisation.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `scope` | `SessionScope` | -- | Stratégie de portée de session |
| `dmScope` | `DmScope` | `"main"` | Portée de session des messages directs |
| `identityLinks` | `Record` | -- | Associer des identités préfixées par plateforme aux pairs DM canoniques |
| `resetTriggers` | `string[]` | -- | Motifs de messages qui déclenchent une réinitialisation de session |
| `idleMinutes` | `number` | -- | Minutes d'inactivité avant la réinitialisation de session |
| `reset` | `SessionResetConfig` | -- | Configuration globale de réinitialisation de session |
| `resetByType` | `SessionResetByTypeConfig` | -- | Surcharges de réinitialisation par type (dm, group, thread) |
| `resetByChannel` | `Record` | -- | Surcharges de réinitialisation par canal |
| `store` | `string` | -- | Chemin du stockage de session |
| `typingIntervalSeconds` | `number` | -- | Intervalle de l'indicateur de saisie |
| `typingMode` | `TypingMode` | -- | Mode de l'indicateur de saisie |
| `mainKey` | `string` | -- | Clé de session principale |
| `sendPolicy` | `SessionSendPolicyConfig` | -- | Politique d'envoi de session |
| `agentToAgent.maxPingPongTurns` | `number` | `5` | Nombre maximal d'échanges ping-pong entre demandeur/cible (0--5) |
---
## `web`
Configuration du fournisseur web WhatsApp.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `enabled` | `boolean` | `true` | Activer le fournisseur web WhatsApp |
| `heartbeatSeconds` | `number` | -- | Intervalle de battement de cœur |
| `reconnect.initialMs` | `number` | -- | Délai initial de reconnexion (ms) |
| `reconnect.maxMs` | `number` | -- | Délai maximal de reconnexion (ms) |
| `reconnect.factor` | `number` | -- | Facteur d'attente exponentielle |
| `reconnect.jitter` | `number` | -- | Facteur de gigue |
| `reconnect.maxAttempts` | `number` | -- | Nombre maximal de tentatives de reconnexion (0 = illimité) |
---
## `connectors`
Configuration des connecteurs de messagerie. Chaque clé est un ID de connecteur (ex. `telegram`, `discord`, `slack`). La clé `channels` est obsolète en faveur de `connectors`.
```json
{
"connectors": {
"telegram": {
"enabled": true,
"botToken": "123456:ABC..."
},
"discord": {
"enabled": true,
"token": "Bot ..."
}
}
}
```
Champs communs par connecteur :
| Champ | Type | Description |
|-------|------|-------------|
| `enabled` | `boolean` | Activer/désactiver sans supprimer la configuration |
| `botToken` / `token` / `apiKey` | `string` | Identifiant d'authentification |
| `dmPolicy` | `"open" \| "pairing" \| "closed"` | Contrôle d'accès des messages directs |
| `configWrites` | `boolean` | Autoriser le connecteur à écrire la configuration lors d'événements |
La clé `channels` est obsolète. Migrez vers `connectors` pour la compatibilité future.
---
## `cron`
Configuration des tâches planifiées.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Activer les tâches cron |
| `store` | `string` | -- | Chemin de persistance de l'état cron |
| `maxConcurrentRuns` | `number` | -- | Nombre maximal d'exécutions cron simultanées |
---
## `hooks`
Système de hooks événementiels : webhooks, intégration Gmail et hooks d'événements internes de l'agent.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Activer le système de hooks |
| `path` | `string` | -- | Chemin du point de terminaison webhook |
| `token` | `string` | -- | Jeton d'authentification webhook |
| `maxBodyBytes` | `number` | -- | Taille maximale du corps webhook |
| `presets` | `string[]` | -- | Préréglages de hooks à charger |
| `transformsDir` | `string` | -- | Répertoire des modules de transformation de hooks |
| `mappings` | `HookMappingConfig[]` | -- | Tableau des règles de mappage de hooks |
### Hook Mapping Config (`hooks.mappings[]`)
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `id` | `string` | -- | Identifiant du mappage |
| `match.path` | `string` | -- | Motif de chemin URL à correspondre |
| `match.source` | `string` | -- | Filtre de source |
| `action` | `"wake" \| "agent"` | -- | Type d'action du hook |
| `wakeMode` | `"now" \| "next-heartbeat"` | -- | Quand réveiller l'agent |
| `name` | `string` | -- | Nom du hook |
| `sessionKey` | `string` | -- | Surcharge de la clé de session |
| `messageTemplate` | `string` | -- | Modèle pour le contenu du message |
| `textTemplate` | `string` | -- | Modèle pour le contenu textuel |
| `deliver` | `boolean` | -- | Livrer ou non le résultat |
| `allowUnsafeExternalContent` | `boolean` | -- | **Dangereux :** Désactiver l'encapsulation de sécurité du contenu externe |
| `channel` | `string` | -- | Canal cible : `"last"`, `"whatsapp"`, `"telegram"`, `"discord"`, `"googlechat"`, `"slack"`, `"signal"`, `"imessage"`, `"msteams"` |
| `to` | `string` | -- | ID de destination |
| `model` | `string` | -- | Surcharge de modèle pour ce hook (fournisseur/modèle) |
| `thinking` | `string` | -- | Surcharge du niveau de réflexion |
| `timeoutSeconds` | `number` | -- | Délai d'attente du traitement du hook |
| `transform.module` | `string` | -- | Chemin du module de transformation |
| `transform.export` | `string` | -- | Nom de l'export du module de transformation |
### `hooks.gmail`
Intégration webhook Gmail via Google Pub/Sub.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `account` | `string` | -- | Compte Gmail |
| `label` | `string` | -- | Libellé Gmail à surveiller |
| `topic` | `string` | -- | Sujet Pub/Sub |
| `subscription` | `string` | -- | Abonnement Pub/Sub |
| `pushToken` | `string` | -- | Jeton de notification push |
| `hookUrl` | `string` | -- | URL du webhook |
| `includeBody` | `boolean` | -- | Inclure le corps de l'e-mail |
| `maxBytes` | `number` | -- | Nombre maximal d'octets du corps de l'e-mail |
| `renewEveryMinutes` | `number` | -- | Intervalle de renouvellement de la surveillance (minutes) |
| `allowUnsafeExternalContent` | `boolean` | -- | **Dangereux :** Désactiver l'encapsulation de sécurité du contenu externe |
| `serve.bind` | `string` | -- | Adresse de liaison du serveur local |
| `serve.port` | `number` | -- | Port du serveur local |
| `serve.path` | `string` | -- | Chemin du serveur local |
| `tailscale.mode` | `"off" \| "serve" \| "funnel"` | -- | Mode d'exposition Tailscale |
| `tailscale.path` | `string` | -- | Chemin Tailscale |
| `tailscale.target` | `string` | -- | Cible serve/funnel Tailscale (port, host:port, ou URL complète) |
| `model` | `string` | -- | Surcharge de modèle pour le traitement du hook Gmail |
| `thinking` | `"off" \| "minimal" \| "low" \| "medium" \| "high"` | -- | Surcharge du niveau de réflexion |
### `hooks.internal`
Hooks d'événements internes de l'agent.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Activer le système de hooks internes |
| `handlers` | `InternalHookHandlerConfig[]` | -- | Liste héritée de gestionnaires |
| `entries` | `Record` | -- | Surcharges de configuration par hook (`enabled`, `env` et clés arbitraires) |
| `load.extraDirs` | `string[]` | -- | Répertoires supplémentaires de hooks à analyser |
| `installs` | `Record` | -- | Packs de hooks installés |
#### InternalHookHandlerConfig
| Champ | Type | Description |
|-------|------|-------------|
| `event` | `string` | Clé d'événement à écouter (ex. `"command:new"`, `"session:start"`) |
| `module` | `string` | Chemin du module gestionnaire |
| `export` | `string` | Nom de l'export du module (par défaut : `"default"`) |
#### HookInstallRecord
| Champ | Type | Description |
|-------|------|-------------|
| `source` | `"npm" \| "archive" \| "path"` | Source d'installation |
| `spec` | `string` | Spécification npm ou URL d'archive |
| `sourcePath` | `string` | Chemin source d'origine |
| `installPath` | `string` | Chemin d'installation local |
| `version` | `string` | Version installée |
| `installedAt` | `string` | Horodatage ISO de l'installation |
| `hooks` | `string[]` | Noms de hooks fournis par ce pack |
---
## `discovery`
Configuration de la découverte réseau (mDNS et DNS-SD à zone étendue).
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `wideArea.enabled` | `boolean` | -- | Activer la découverte DNS-SD à zone étendue |
| `wideArea.domain` | `string` | -- | Domaine DNS-SD unicast (ex. `"eliza.internal"`) |
| `mdns.mode` | `"off" \| "minimal" \| "full"` | `"minimal"` | Mode de diffusion mDNS (`off` = désactivé, `minimal` = omettre cliPath/sshPort, `full` = inclure tout) |
---
## `talk`
Paramètres vocaux du mode Talk ElevenLabs.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `voiceId` | `string` | -- | ID de voix ElevenLabs par défaut |
| `voiceAliases` | `Record` | -- | Correspondance nom de voix vers ID de voix ElevenLabs |
| `modelId` | `string` | -- | ID de modèle ElevenLabs par défaut |
| `outputFormat` | `string` | -- | Format de sortie par défaut (ex. `mp3_44100_128`) |
| `apiKey` | `string` | -- | Clé API ElevenLabs (repli sur `ELEVENLABS_API_KEY`) |
| `interruptOnSpeech` | `boolean` | `true` | Arrêter de parler lorsque l'utilisateur commence à parler |
---
## `gateway`
Configuration du serveur passerelle : port, adresse de liaison, TLS, auth, points de terminaison HTTP et routage de nœuds.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `port` | `number` | `18789` | Port WS + HTTP de la passerelle |
| `mode` | `"local" \| "remote"` | -- | Mode passerelle (`"remote"` désactive le démarrage local) |
| `bind` | `"auto" \| "lan" \| "loopback" \| "tailnet" \| "custom"` | `"loopback"` | Politique d'adresse de liaison |
| `customBindHost` | `string` | -- | IP personnalisée pour `bind="custom"` (repli : `0.0.0.0`) |
| `trustedProxies` | `string[]` | -- | IPs des proxys inverses de confiance pour `x-forwarded-for` |
### `gateway.tls`
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Activer TLS pour le serveur passerelle |
| `autoGenerate` | `boolean` | `true` | Générer automatiquement un certificat auto-signé si cert/clé sont manquants |
| `certPath` | `string` | -- | Chemin du certificat PEM |
| `keyPath` | `string` | -- | Chemin de la clé privée PEM |
| `caPath` | `string` | -- | Chemin du bundle CA pour mTLS ou racines personnalisées |
### `gateway.auth`
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `mode` | `"token" \| "password"` | `"token"` | Mode d'authentification |
| `token` | `string` | -- | Jeton partagé pour le mode jeton |
| `password` | `string` | -- | Mot de passe partagé pour le mode mot de passe |
| `allowTailscale` | `boolean` | -- | Autoriser les en-têtes d'identité Tailscale lorsque le mode serve est activé |
### `gateway.controlUi`
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Servir l'interface de contrôle (par défaut : `/`) |
| `basePath` | `string` | -- | Préfixe du chemin de base (ex. `"/eliza"`) |
| `root` | `string` | -- | Racine du système de fichiers pour les ressources de l'interface de contrôle (par défaut : `dist/control-ui`) |
| `allowedOrigins` | `string[]` | -- | Origines navigateur autorisées pour les connexions WebSocket |
| `allowInsecureAuth` | `boolean` | `false` | Autoriser l'auth par jeton seul sur HTTP non sécurisé |
| `dangerouslyDisableDeviceAuth` | `boolean` | `false` | **Dangereux :** Désactiver les vérifications d'identité d'appareil |
### `gateway.tailscale`
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `mode` | `"off" \| "serve" \| "funnel"` | -- | Mode d'exposition Tailscale |
| `resetOnExit` | `boolean` | -- | Réinitialiser la configuration serve/funnel à l'arrêt |
### `gateway.remote`
Paramètres de connexion à la passerelle distante.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `url` | `string` | -- | URL WebSocket de la passerelle distante (`ws://` ou `wss://`) |
| `transport` | `"ssh" \| "direct"` | -- | Transport pour les connexions distantes macOS |
| `token` | `string` | -- | Jeton pour l'authentification distante |
| `password` | `string` | -- | Mot de passe pour l'authentification distante |
| `tlsFingerprint` | `string` | -- | Empreinte de certificat TLS attendue (SHA-256) |
| `sshTarget` | `string` | -- | Cible SSH pour le tunneling (`user@host`) |
| `sshIdentity` | `string` | -- | Chemin du fichier d'identité SSH |
### `gateway.reload`
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `mode` | `"off" \| "restart" \| "hot" \| "hybrid"` | `"hybrid"` | Stratégie de rechargement pour les changements de configuration |
| `debounceMs` | `number` | `300` | Fenêtre anti-rebond pour les rechargements de configuration (ms) |
### `gateway.http`
Configuration des points de terminaison de l'API HTTP.
#### `gateway.http.endpoints.chatCompletions`
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `enabled` | `boolean` | `false` | Servir `POST /v1/chat/completions` |
#### `gateway.http.endpoints.responses`
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `enabled` | `boolean` | `false` | Servir `POST /v1/responses` (API OpenResponses) |
| `maxBodyBytes` | `number` | 20 Mo | Taille maximale du corps de requête (octets) |
| `files.allowUrl` | `boolean` | `true` | Autoriser les récupérations d'URL pour `input_file` |
| `files.allowedMimes` | `string[]` | -- | Types MIME autorisés (insensible à la casse) |
| `files.maxBytes` | `number` | 5 Mo | Nombre maximal d'octets par fichier |
| `files.maxChars` | `number` | 200k | Nombre maximal de caractères décodés par fichier |
| `files.maxRedirects` | `number` | `3` | Nombre maximal de redirections lors de la récupération d'une URL |
| `files.timeoutMs` | `number` | 10s | Délai d'attente de récupération (ms) |
| `files.pdf.maxPages` | `number` | `4` | Nombre maximal de pages à analyser/rendre |
| `files.pdf.maxPixels` | `number` | 4M | Nombre maximal de pixels par page rendue |
| `files.pdf.minTextChars` | `number` | `200` | Longueur minimale de texte pour ignorer la rastérisation (caractères) |
| `images.allowUrl` | `boolean` | `true` | Autoriser les récupérations d'URL pour `input_image` |
| `images.allowedMimes` | `string[]` | -- | Types MIME autorisés (insensible à la casse) |
| `images.maxBytes` | `number` | 10 Mo | Nombre maximal d'octets par image |
| `images.maxRedirects` | `number` | `3` | Nombre maximal de redirections |
| `images.timeoutMs` | `number` | 10s | Délai d'attente de récupération (ms) |
### `gateway.nodes`
Configuration du routage de nœuds.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `browser.mode` | `"auto" \| "manual" \| "off"` | `"auto"` | Politique de routage du navigateur pour les proxys navigateur hébergés sur nœud |
| `browser.node` | `string` | -- | Épingler sur un ID/nom de nœud spécifique |
| `allowCommands` | `string[]` | -- | Commandes `node.invoke` supplémentaires à autoriser |
| `denyCommands` | `string[]` | -- | Commandes à refuser même si dans les valeurs par défaut ou les déclarations du nœud |
---
## `memory`
Configuration du backend de mémoire.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `backend` | `"builtin" \| "qmd"` | `"builtin"` | Backend de mémoire |
| `citations` | `"auto" \| "on" \| "off"` | -- | Mode de citation |
| `qmd` | `MemoryQmdConfig` | -- | Configuration du backend de mémoire QMD |
### `memory.qmd`
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `command` | `string` | -- | Commande binaire QMD |
| `includeDefaultMemory` | `boolean` | -- | Inclure le chemin mémoire par défaut |
| `paths` | `MemoryQmdIndexPath[]` | -- | Chemins d'index (chacun : `{ path, name?, pattern? }`) |
| `sessions.enabled` | `boolean` | -- | Activer l'indexation des sessions |
| `sessions.exportDir` | `string` | -- | Répertoire d'export des sessions |
| `sessions.retentionDays` | `number` | -- | Rétention des sessions (jours) |
| `update.interval` | `string` | -- | Intervalle de mise à jour |
| `update.debounceMs` | `number` | -- | Anti-rebond de mise à jour (ms) |
| `update.onBoot` | `boolean` | -- | Exécuter la mise à jour au démarrage |
| `update.embedInterval` | `string` | -- | Intervalle de mise à jour des embeddings |
| `limits.maxResults` | `number` | -- | Nombre maximal de résultats de recherche |
| `limits.maxSnippetChars` | `number` | -- | Nombre maximal de caractères par extrait |
| `limits.maxInjectedChars` | `number` | -- | Nombre maximal de caractères injectés |
| `limits.timeoutMs` | `number` | -- | Délai d'attente de recherche (ms) |
| `scope` | `SessionSendPolicyConfig` | -- | Politique de portée |
---
## `embedding`
Configuration du modèle d'embedding local (modèles GGUF avec support GPU Metal).
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `model` | `string` | -- | Nom de fichier du modèle GGUF (ex. `"nomic-embed-text-v1.5.Q5_K_M.gguf"`) |
| `modelRepo` | `string` | -- | Dépôt/source Hugging Face pour la résolution du modèle |
| `dimensions` | `number` | `768` | Dimension du vecteur d'embedding |
| `contextSize` | `number` | -- | Taille de la fenêtre de contexte d'embedding (doit correspondre au modèle) |
| `gpuLayers` | `number \| "auto" \| "max"` | -- | Couches GPU pour le chargement du modèle |
| `idleTimeoutMinutes` | `number` | `30` | Minutes d'inactivité avant le déchargement du modèle de la mémoire (0 = jamais) |
---
## `database`
Fournisseur de base de données et configuration de connexion.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `provider` | `"pglite" \| "postgres"` | `"pglite"` | Fournisseur de base de données actif |
### `database.pglite`
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `dataDir` | `string` | `~/.eliza/workspace/.eliza/.elizadb` | Répertoire de données PGLite |
### `database.postgres`
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `connectionString` | `string` | -- | Chaîne de connexion PostgreSQL complète (prioritaire sur les champs individuels) |
| `host` | `string` | `localhost` | Hôte PostgreSQL |
| `port` | `number` | `5432` | Port PostgreSQL |
| `database` | `string` | -- | Nom de la base de données |
| `user` | `string` | -- | Utilisateur de la base de données |
| `password` | `string` | -- | Mot de passe de la base de données |
| `ssl` | `boolean` | `false` | Activer la connexion SSL |
---
## `cloud`
Intégration Eliza Cloud pour le provisionnement d'agents distants, le proxying d'inférence et la sauvegarde d'état.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `enabled` | `boolean` | `false` | Activer l'intégration Eliza Cloud |
| `provider` | `string` | -- | ID du fournisseur cloud (ex. `"elizacloud"` ; défini lors de l'intégration) |
| `baseUrl` | `string` | `https://elizacloud.ai/api/v1` | URL de base de l'API |
| `apiKey` | `string` | -- | Clé API en cache (stockée chiffrée via l'auth de la passerelle) |
| `inferenceMode` | `"cloud" \| "byok" \| "local"` | -- | Routage d'inférence : `cloud` (proxié), `byok` (clés utilisateur), `local` (sans cloud) |
| `autoProvision` | `boolean` | `false` | Déployer automatiquement les agents dans le cloud à la création |
### `cloud.bridge`
Paramètres de communication WebSocket pour les agents cloud.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `reconnectIntervalMs` | `number` | `3000` | Base de l'intervalle de reconnexion (ms) |
| `maxReconnectAttempts` | `number` | `20` | Nombre maximal de tentatives de reconnexion |
| `heartbeatIntervalMs` | `number` | `30000` | Intervalle de battement de cœur (ms) |
### `cloud.backup`
Paramètres d'instantané de l'état de l'agent.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `autoBackupIntervalMs` | `number` | `3600000` (1 heure) | Intervalle de sauvegarde automatique (ms) |
| `maxSnapshots` | `number` | `10` | Nombre maximal d'instantanés automatiques à conserver |
### `cloud.container`
Paramètres de conteneur par défaut pour les nouveaux déploiements cloud.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `defaultImage` | `string` | -- | URI d'image ECR par défaut pour les conteneurs d'agents |
| `defaultArchitecture` | `"arm64" \| "x86_64"` | `"arm64"` | Architecture CPU par défaut |
| `defaultCpu` | `number` | `1792` | Unités CPU par défaut |
| `defaultMemory` | `number` | `1792` | Mémoire par défaut (Mo) |
| `defaultPort` | `number` | `2138` | Port de conteneur par défaut |
---
## `x402`
Configuration du protocole de paiement HTTP x402.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Activer les paiements x402 |
| `privateKey` | `string` | -- | Clé privée du portefeuille |
| `network` | `string` | -- | Identifiant du réseau |
| `payTo` | `string` | -- | Adresse du destinataire du paiement |
| `facilitatorUrl` | `string` | -- | URL du service facilitateur |
| `maxPaymentUsd` | `number` | -- | Paiement unique maximal (USD) |
| `maxTotalUsd` | `number` | -- | Total maximal des paiements (USD) |
| `dbPath` | `string` | -- | Chemin de la base de données des paiements |
---
## `media`
Configuration de la génération de médias (fournisseurs d'image, vidéo, audio, vision).
### `media.image`
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Activer la génération d'images |
| `mode` | `"cloud" \| "own-key"` | -- | Cloud (proxié) ou clé API propre |
| `provider` | `"cloud" \| "fal" \| "openai" \| "google" \| "xai"` | -- | Fournisseur d'images |
| `defaultSize` | `string` | -- | Taille d'image par défaut |
| `fal` | `{ apiKey?, model?, baseUrl? }` | -- | Configuration Fal.ai |
| `openai` | `{ apiKey?, model?, quality?, style? }` | -- | Configuration OpenAI (`quality` : `"standard"` ou `"hd"`, `style` : `"natural"` ou `"vivid"`) |
| `google` | `{ apiKey?, model?, aspectRatio? }` | -- | Configuration Google |
| `xai` | `{ apiKey?, model? }` | -- | Configuration xAI |
### `media.video`
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Activer la génération vidéo |
| `mode` | `"cloud" \| "own-key"` | -- | Cloud (proxié) ou clé API propre |
| `provider` | `"cloud" \| "fal" \| "openai" \| "google"` | -- | Fournisseur vidéo |
| `defaultDuration` | `number` | -- | Durée vidéo par défaut |
| `fal` | `{ apiKey?, model?, baseUrl? }` | -- | Configuration Fal.ai |
| `openai` | `{ apiKey?, model? }` | -- | Configuration OpenAI |
| `google` | `{ apiKey?, model? }` | -- | Configuration Google |
### `media.audio`
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Activer la génération audio |
| `mode` | `"cloud" \| "own-key"` | -- | Cloud (proxié) ou clé API propre |
| `provider` | `"cloud" \| "suno" \| "elevenlabs"` | -- | Fournisseur audio |
| `suno` | `{ apiKey?, model?, baseUrl? }` | -- | Configuration Suno |
| `elevenlabs` | `{ apiKey?, duration? }` | -- | Configuration ElevenLabs SFX |
### `media.vision`
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `enabled` | `boolean` | -- | Activer la vision (compréhension d'images) |
| `mode` | `"cloud" \| "own-key"` | -- | Cloud (proxié) ou clé API propre |
| `provider` | `"cloud" \| "openai" \| "google" \| "anthropic" \| "xai" \| "ollama"` | -- | Fournisseur de vision |
| `openai` | `{ apiKey?, model?, maxTokens? }` | -- | Configuration OpenAI |
| `google` | `{ apiKey?, model? }` | -- | Configuration Google |
| `anthropic` | `{ apiKey?, model? }` | -- | Configuration Anthropic |
| `xai` | `{ apiKey?, model? }` | -- | Configuration xAI |
| `ollama` | `{ baseUrl?, model?, maxTokens?, autoDownload? }` | -- | Configuration Ollama |
---
## `mcp`
Définitions de serveurs 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 ..." }
}
}
}
}
```
### Entrée de serveur MCP
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `type` | `string` | -- | Type de serveur (ex. `"stdio"`, `"sse"`) |
| `command` | `string` | -- | Commande à exécuter (pour le type `stdio`) |
| `args` | `string[]` | -- | Arguments de la commande |
| `url` | `string` | -- | URL du serveur (pour les types `sse` ou distants) |
| `env` | `Record` | -- | Variables d'environnement pour le processus serveur |
| `headers` | `Record` | -- | En-têtes HTTP pour les connexions distantes |
| `cwd` | `string` | -- | Répertoire de travail pour le processus serveur |
| `timeoutInMillis` | `number` | -- | Délai d'attente de connexion (ms) |
---
## `registry`
Configuration du registre d'agents ERC-8004 et de la collection NFT ElizaMaker.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `mainnetRpc` | `string` | -- | URL RPC du mainnet Ethereum (ou Anvil local) |
| `registryAddress` | `string` | -- | Adresse du contrat ElizaAgentRegistry |
| `collectionAddress` | `string` | -- | Adresse du contrat de collection ElizaMaker |
---
## `features`
Indicateurs de fonctionnalités pour l'activation automatique des plugins et les bascules de fonctionnalités. Chaque clé correspond soit à un booléen, soit à un objet avec `enabled` et des options supplémentaires.
```json
{
"features": {
"shellEnabled": true,
"someFeature": { "enabled": true, "option": "value" }
}
}
```
---
## `customActions`
Actions personnalisées définies par l'utilisateur pour l'agent. Tableau d'objets `CustomActionDef`.
| Champ | Type | Défaut | Description |
|-------|------|---------|-------------|
| `id` | `string` | -- | **Requis.** Identifiant unique de l'action |
| `name` | `string` | -- | **Requis.** Nom d'affichage de l'action |
| `description` | `string` | -- | **Requis.** Description de l'action |
| `similes` | `string[]` | -- | Phrases de déclenchement alternatives |
| `parameters` | `Array<{ name, description, required }>` | -- | **Requis.** Paramètres de l'action |
| `handler` | `CustomActionHandler` | -- | **Requis.** Définition du gestionnaire (voir sous-table) |
| `enabled` | `boolean` | -- | **Requis.** Si l'action est activée |
| `createdAt` | `string` | -- | **Requis.** Horodatage ISO de création |
| `updatedAt` | `string` | -- | **Requis.** Horodatage ISO de dernière mise à jour |
### CustomActionHandler
Le gestionnaire est l'un des trois types :
**Gestionnaire HTTP :**
| Champ | Type | Description |
|-------|------|-------------|
| `type` | `"http"` | Type de gestionnaire |
| `method` | `string` | Méthode HTTP |
| `url` | `string` | URL de la requête |
| `headers` | `Record` | En-têtes de requête optionnels |
| `bodyTemplate` | `string` | Modèle de corps de requête optionnel |
**Gestionnaire shell :**
| Champ | Type | Description |
|-------|------|-------------|
| `type` | `"shell"` | Type de gestionnaire |
| `command` | `string` | Commande shell à exécuter |
**Gestionnaire code :**
| Champ | Type | Description |
|-------|------|-------------|
| `type` | `"code"` | Type de gestionnaire |
| `code` | `string` | Code JavaScript à exécuter |