Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw leest een optionele -configuratie uit ~/.openclaw/openclaw.json. Het actieve configuratiepad moet een regulier bestand zijn. Gesymlinkte openclaw.json- layouts worden niet ondersteund voor schrijfacties die OpenClaw beheert; een atomische schrijfactie kan het pad vervangen in plaats van de symlink te behouden. Als je configuratie buiten de standaardstatusmap bewaart, laat OPENCLAW_CONFIG_PATH dan rechtstreeks naar het echte bestand wijzen. Als het bestand ontbreekt, gebruikt OpenClaw veilige standaardwaarden. Veelvoorkomende redenen om een configuratie toe te voegen:
  • Kanalen verbinden en bepalen wie de bot berichten kan sturen
  • Modellen, tools, sandboxing of automatisering instellen (Cron, hooks)
  • Sessies, media, netwerken of UI afstemmen
Zie de volledige referentie voor elk beschikbaar veld. Agents en automatisering moeten config.schema.lookup gebruiken voor exacte documentatie op veldniveau voordat ze configuratie bewerken. Gebruik deze pagina voor taakgerichte begeleiding en Configuratiereferentie voor de bredere veldkaart en standaardwaarden.
Nieuw met configuratie? Begin met openclaw onboard voor interactieve installatie, of bekijk de gids Configuratievoorbeelden voor complete configuraties die je kunt kopiëren en plakken.

​
Minimale configuratie

// ~/.openclaw/openclaw.json
{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

​
Configuratie bewerken

openclaw onboard       # full onboarding flow
openclaw configure     # config wizard

​
Strikte validatie

OpenClaw accepteert alleen configuraties die volledig overeenkomen met het schema. Onbekende sleutels, verkeerd gevormde typen of ongeldige waarden zorgen ervoor dat de Gateway weigert te starten. De enige uitzondering op rootniveau is $schema (string), zodat editors JSON Schema-metadata kunnen koppelen.
openclaw config schema toont het canonieke JSON Schema dat door Control UI en validatie wordt gebruikt. config.schema.lookup haalt een enkele node met padscope plus samenvattingen van onderliggende items op voor verdiepende tooling. Documentatiemetadata voor velden title/description wordt doorgegeven via geneste objecten, wildcard (*), array-item ([]) en anyOf/oneOf/allOf-vertakkingen. Runtime plugin- en kanaalschema’s worden samengevoegd wanneer het manifestregister is geladen. Wanneer validatie mislukt:
  • De Gateway start niet op
  • Alleen diagnostische opdrachten werken (openclaw doctor, openclaw logs, openclaw health, openclaw status)
  • Voer openclaw doctor uit om de exacte problemen te zien
  • Voer openclaw doctor --fix (of --yes) uit om reparaties toe te passen
De Gateway bewaart na elke succesvolle start een vertrouwde laatst bekende werkende kopie. Als openclaw.json later niet door validatie komt (of gateway.mode verliest, sterk krimpt, of een losse logregel vooraan krijgt), bewaart OpenClaw het kapotte bestand als .clobbered.*, herstelt de laatst bekende werkende kopie en logt de herstelreden. De volgende agentbeurt ontvangt ook een systeemgebeurteniswaarschuwing, zodat de hoofdagent de herstelde configuratie niet blind herschrijft. Promotie naar laatst bekend werkend wordt overgeslagen wanneer een kandidaat geredigeerde geheime plaatshouders bevat, zoals ***. Wanneer elk validatieprobleem is beperkt tot plugins.entries.<id>..., voert OpenClaw geen herstel van het volledige bestand uit. Het houdt de huidige configuratie actief en toont de plugin-lokale fout, zodat een plugin-schema of hostversie-mismatch niet-gerelateerde gebruikersinstellingen niet kan terugdraaien.

​
Veelvoorkomende taken

Elk kanaal heeft een eigen configuratiesectie onder channels.<provider>. Zie de specifieke kanaalpagina voor installatiestappen:Alle kanalen delen hetzelfde DM-beleidspatroon:
{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123:abc",
      dmPolicy: "pairing",   // pairing | allowlist | open | disabled
      allowFrom: ["tg:123"], // only for allowlist/open
    },
  },
}
Stel het primaire model en optionele fallbacks in:
{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-sonnet-4-6",
        fallbacks: ["openai/gpt-5.4"],
      },
      models: {
        "anthropic/claude-sonnet-4-6": { alias: "Sonnet" },
        "openai/gpt-5.4": { alias: "GPT" },
      },
    },
  },
}
  • agents.defaults.models definieert de modelcatalogus en fungeert als allowlist voor /model.
  • Gebruik openclaw config set agents.defaults.models '<json>' --strict-json --merge om allowlist-items toe te voegen zonder bestaande modellen te verwijderen. Gewone vervangingen die items zouden verwijderen worden geweigerd tenzij je --replace doorgeeft.
  • Modelrefs gebruiken de indeling provider/model (bijv. anthropic/claude-opus-4-6).
  • agents.defaults.imageMaxDimensionPx bepaalt het verkleinen van transcript-/toolafbeeldingen (standaard 1200); lagere waarden verminderen meestal het gebruik van vision-tokens bij runs met veel screenshots.
  • Zie Modellen-CLI om modellen in chat te wisselen en Model-failover voor auth-rotatie en fallbackgedrag.
  • Zie Aangepaste providers in de referentie voor aangepaste/zelfgehoste providers.
DM-toegang wordt per kanaal beheerd via dmPolicy:
  • "pairing" (standaard): onbekende afzenders krijgen een eenmalige koppelcode voor goedkeuring
  • "allowlist": alleen afzenders in allowFrom (of de gekoppelde toestemmingsopslag)
  • "open": sta alle inkomende DM’s toe (vereist allowFrom: ["*"])
  • "disabled": negeer alle DM’s
Gebruik voor groepen groupPolicy + groupAllowFrom of kanaalspecifieke allowlists.Zie de volledige referentie voor details per kanaal.
Groepsberichten vereisen standaard een vermelding. Configureer triggerpatronen per agent en houd zichtbare kamerantwoorden op het standaardpad voor berichtentools, tenzij je bewust oudere automatische eindantwoorden wilt:
{
  messages: {
    visibleReplies: "automatic", // set "message_tool" to require message-tool sends everywhere
    groupChat: {
      visibleReplies: "message_tool", // default; use "automatic" for legacy room replies
    },
  },
  agents: {
    list: [
      {
        id: "main",
        groupChat: {
          mentionPatterns: ["@openclaw", "openclaw"],
        },
      },
    ],
  },
  channels: {
    whatsapp: {
      groups: { "*": { requireMention: true } },
    },
  },
}
  • Metadatavermeldingen: native @-vermeldingen (WhatsApp tik-om-te-vermelden, Telegram @bot, enz.)
  • Tekstpatronen: veilige regex-patronen in mentionPatterns
  • Zichtbare antwoorden: messages.visibleReplies kan wereldwijd verzending via berichtentools vereisen; messages.groupChat.visibleReplies overschrijft dat voor groepen/kanalen.
  • Zie de volledige referentie voor zichtbare antwoordmodi, overschrijvingen per kanaal en zelfchatmodus.
Gebruik agents.defaults.skills voor een gedeelde basis en overschrijf daarna specifieke agents met agents.list[].skills:
{
  agents: {
    defaults: {
      skills: ["github", "weather"],
    },
    list: [
      { id: "writer" }, // inherits github, weather
      { id: "docs", skills: ["docs-search"] }, // replaces defaults
      { id: "locked-down", skills: [] }, // no skills
    ],
  },
}
  • Laat agents.defaults.skills weg voor standaard onbeperkte Skills.
  • Laat agents.list[].skills weg om de standaardwaarden te erven.
  • Stel agents.list[].skills: [] in voor geen Skills.
  • Zie Skills, Skills-configuratie en de Configuratiereferentie.
Bepaal hoe agressief de Gateway kanalen herstart die verouderd lijken:
{
  gateway: {
    channelHealthCheckMinutes: 5,
    channelStaleEventThresholdMinutes: 30,
    channelMaxRestartsPerHour: 10,
  },
  channels: {
    telegram: {
      healthMonitor: { enabled: false },
      accounts: {
        alerts: {
          healthMonitor: { enabled: true },
        },
      },
    },
  },
}
  • Stel gateway.channelHealthCheckMinutes: 0 in om health-monitor-herstarts wereldwijd uit te schakelen.
  • channelStaleEventThresholdMinutes moet groter zijn dan of gelijk zijn aan het controle-interval.
  • Gebruik channels.<provider>.healthMonitor.enabled of channels.<provider>.accounts.<id>.healthMonitor.enabled om automatische herstarts voor één kanaal of account uit te schakelen zonder de globale monitor uit te schakelen.
  • Zie Health Checks voor operationele foutopsporing en de volledige referentie voor alle velden.
Geef lokale clients meer tijd om de pre-auth WebSocket-handshake te voltooien op belaste of energiezuinige hosts:
{
  gateway: {
    handshakeTimeoutMs: 30000,
  },
}
  • Standaard is 15000 milliseconden.
  • OPENCLAW_HANDSHAKE_TIMEOUT_MS heeft nog steeds voorrang voor eenmalige service- of shell-overschrijvingen.
  • Los bij voorkeur eerst vastlopers bij startup/event-loop op; deze knop is bedoeld voor hosts die gezond zijn maar traag tijdens het opwarmen.
Sessies bepalen gesprekscontinuïteit en isolatie:
{
  session: {
    dmScope: "per-channel-peer",  // recommended for multi-user
    threadBindings: {
      enabled: true,
      idleHours: 24,
      maxAgeHours: 0,
    },
    reset: {
      mode: "daily",
      atHour: 4,
      idleMinutes: 120,
    },
  },
}
  • dmScope: main (gedeeld) | per-peer | per-channel-peer | per-account-channel-peer
  • threadBindings: globale standaardwaarden voor sessierouting die aan threads is gebonden (Discord ondersteunt /focus, /unfocus, /agents, /session idle en /session max-age).
  • Zie Sessiebeheer voor scoping, identiteitskoppelingen en verzendbeleid.
  • Zie volledige referentie voor alle velden.
Voer agentsessies uit in geïsoleerde sandboxruntimes:
{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main",  // off | non-main | all
        scope: "agent",    // session | agent | shared
      },
    },
  },
}
Bouw eerst de image: scripts/sandbox-setup.shZie Sandboxing voor de volledige handleiding en volledige referentie voor alle opties.
Relay-ondersteunde push wordt geconfigureerd in openclaw.json.Stel dit in de Gateway-configuratie in:
{
  gateway: {
    push: {
      apns: {
        relay: {
          baseUrl: "https://relay.example.com",
          // Optional. Default: 10000
          timeoutMs: 10000,
        },
      },
    },
  },
}
CLI-equivalent:
openclaw config set gateway.push.apns.relay.baseUrl https://relay.example.com
Wat dit doet:
  • Laat de Gateway push.test, wake-nudges en reconnect-wakes via de externe relay verzenden.
  • Gebruikt een verzendtoekenning met registratiescope die door de gekoppelde iOS-app wordt doorgestuurd. De Gateway heeft geen implementatiebrede relay-token nodig.
  • Bindt elke relay-ondersteunde registratie aan de Gateway-identiteit waarmee de iOS-app is gekoppeld, zodat een andere Gateway de opgeslagen registratie niet opnieuw kan gebruiken.
  • Houdt lokale/handmatige iOS-builds op directe APNs. Relay-ondersteunde verzendingen zijn alleen van toepassing op officiële gedistribueerde builds die via de relay zijn geregistreerd.
  • Moet overeenkomen met de relay-basis-URL die in de officiële/TestFlight-iOS-build is ingebakken, zodat registratie- en verzendverkeer dezelfde relay-implementatie bereiken.
End-to-end-stroom:
  1. Installeer een officiële/TestFlight-iOS-build die met dezelfde relay-basis-URL is gecompileerd.
  2. Configureer gateway.push.apns.relay.baseUrl op de Gateway.
  3. Koppel de iOS-app aan de Gateway en laat zowel node- als operatorsessies verbinding maken.
  4. De iOS-app haalt de Gateway-identiteit op, registreert zich bij de relay met App Attest plus het appbewijs, en publiceert daarna de relay-ondersteunde push.apns.register-payload naar de gekoppelde Gateway.
  5. De Gateway slaat de relay-handle en verzendtoekenning op en gebruikt deze daarna voor push.test, wake-nudges en reconnect-wakes.
Operationele opmerkingen:
  • Als je de iOS-app naar een andere Gateway overschakelt, verbind de app dan opnieuw zodat deze een nieuwe relay-registratie kan publiceren die aan die Gateway is gebonden.
  • Als je een nieuwe iOS-build levert die naar een andere relay-implementatie verwijst, vernieuwt de app de gecachete relay-registratie in plaats van de oude relay-origin opnieuw te gebruiken.
Compatibiliteitsopmerking:
  • OPENCLAW_APNS_RELAY_BASE_URL en OPENCLAW_APNS_RELAY_TIMEOUT_MS werken nog steeds als tijdelijke env-overrides.
  • OPENCLAW_APNS_RELAY_ALLOW_HTTP=true blijft een ontwikkelingsuitweg alleen voor local loopback; sla HTTP-relay-URL’s niet persistent op in configuratie.
Zie iOS-app voor de end-to-end-stroom en Authenticatie- en vertrouwensstroom voor het relay-beveiligingsmodel.
{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last",
      },
    },
  },
}
  • every: duurtekenreeks (30m, 2h). Stel 0m in om uit te schakelen.
  • target: last | none | <channel-id> (bijvoorbeeld discord, matrix, telegram of whatsapp)
  • directPolicy: allow (standaard) of block voor Heartbeat-doelen in DM-stijl
  • Zie Heartbeat voor de volledige handleiding.
{
  cron: {
    enabled: true,
    maxConcurrentRuns: 2, // cron dispatch + isolated cron agent-turn execution
    sessionRetention: "24h",
    runLog: {
      maxBytes: "2mb",
      keepLines: 2000,
    },
  },
}
  • sessionRetention: voltooide geïsoleerde uitvoeringssessies uit sessions.json opschonen (standaard 24h; stel false in om uit te schakelen).
  • runLog: cron/runs/<jobId>.jsonl opschonen op grootte en bewaarde regels.
  • Zie Cron-taken voor een functieoverzicht en CLI-voorbeelden.
Schakel HTTP-Webhook-eindpunten in op de Gateway:
{
  hooks: {
    enabled: true,
    token: "shared-secret",
    path: "/hooks",
    defaultSessionKey: "hook:ingress",
    allowRequestSessionKey: false,
    allowedSessionKeyPrefixes: ["hook:"],
    mappings: [
      {
        match: { path: "gmail" },
        action: "agent",
        agentId: "main",
        deliver: true,
      },
    ],
  },
}
Beveiligingsopmerking:
  • Behandel alle hook-/Webhook-payloadinhoud als niet-vertrouwde invoer.
  • Gebruik een speciale hooks.token; hergebruik de gedeelde Gateway-token niet.
  • Hook-authenticatie werkt alleen via headers (Authorization: Bearer ... of x-openclaw-token); querystringtokens worden geweigerd.
  • hooks.path mag niet / zijn; houd Webhook-ingress op een speciaal subpad zoals /hooks.
  • Houd bypassvlaggen voor onveilige inhoud uitgeschakeld (hooks.gmail.allowUnsafeExternalContent, hooks.mappings[].allowUnsafeExternalContent), behalve voor strikt afgebakende foutopsporing.
  • Als je hooks.allowRequestSessionKey inschakelt, stel dan ook hooks.allowedSessionKeyPrefixes in om door de aanroeper gekozen sessiesleutels te begrenzen.
  • Geef voor door hooks aangestuurde agents de voorkeur aan sterke moderne modellagen en strikt toolbeleid (bijvoorbeeld alleen berichten plus sandboxing waar mogelijk).
Zie volledige referentie voor alle mappingopties en Gmail-integratie.
Voer meerdere geïsoleerde agents uit met afzonderlijke werkruimten en sessies:
{
  agents: {
    list: [
      { id: "home", default: true, workspace: "~/.openclaw/workspace-home" },
      { id: "work", workspace: "~/.openclaw/workspace-work" },
    ],
  },
  bindings: [
    { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } },
    { agentId: "work", match: { channel: "whatsapp", accountId: "biz" } },
  ],
}
Zie Multi-agent en volledige referentie voor bindingsregels en toegangsprofielen per agent.
Gebruik $include om grote configuraties te organiseren:
// ~/.openclaw/openclaw.json
{
  gateway: { port: 18789 },
  agents: { $include: "./agents.json5" },
  broadcast: {
    $include: ["./clients/a.json5", "./clients/b.json5"],
  },
}
  • Eén bestand: vervangt het bevattende object
  • Array met bestanden: diep samengevoegd in volgorde (latere wint)
  • Sleutels op hetzelfde niveau: samengevoegd na includes (overschrijven opgenomen waarden)
  • Geneste includes: ondersteund tot 10 niveaus diep
  • Relatieve paden: opgelost relatief ten opzichte van het include-bestand
  • Door OpenClaw beheerde schrijfbewerkingen: wanneer een schrijfbewerking slechts één top-level sectie wijzigt die wordt ondersteund door een include met één bestand, zoals plugins: { $include: "./plugins.json5" }, werkt OpenClaw dat opgenomen bestand bij en laat het openclaw.json intact
  • Niet-ondersteunde doorschrijfbewerking: root-includes, include-arrays en includes met overrides op hetzelfde niveau falen gesloten voor door OpenClaw beheerde schrijfbewerkingen in plaats van de configuratie plat te maken
  • Foutafhandeling: duidelijke fouten voor ontbrekende bestanden, parsefouten en circulaire includes

​
Hot reload van configuratie

De Gateway bewaakt ~/.openclaw/openclaw.json en past wijzigingen automatisch toe — voor de meeste instellingen is geen handmatige herstart nodig. Directe bestandsbewerkingen worden als niet-vertrouwd behandeld totdat ze valideren. De watcher wacht tot temp-write-/rename-activiteit van de editor is gestabiliseerd, leest het uiteindelijke bestand en weigert ongeldige externe bewerkingen door de laatst bekende goede configuratie te herstellen. Door OpenClaw beheerde configuratieschrijfbewerkingen gebruiken dezelfde schemagate voordat ze schrijven; destructieve overschrijvingen zoals het laten vallen van gateway.mode of het verkleinen van het bestand met meer dan de helft worden geweigerd en opgeslagen als .rejected.* voor inspectie. Plugin-lokale validatiefouten zijn de uitzondering: als alle problemen onder plugins.entries.<id>... vallen, behoudt reload de huidige configuratie en rapporteert het Plugin- probleem in plaats van .last-good te herstellen. Als je Config auto-restored from last-known-good of config reload restored last-known-good config in logs ziet, inspecteer dan het bijbehorende .clobbered.*-bestand naast openclaw.json, herstel de geweigerde payload en voer daarna openclaw config validate uit. Zie Gateway-probleemoplossing voor de herstelchecklist.

​
Reload-modi

ModusGedrag
hybrid (standaard)Past veilige wijzigingen direct hot toe. Herstart automatisch voor kritieke wijzigingen.
hotPast alleen veilige wijzigingen hot toe. Logt een waarschuwing wanneer een herstart nodig is — jij handelt dit af.
restartHerstart de Gateway bij elke configuratiewijziging, veilig of niet.
offSchakelt bestandsbewaking uit. Wijzigingen worden van kracht bij de volgende handmatige herstart.
{
  gateway: {
    reload: { mode: "hybrid", debounceMs: 300 },
  },
}

​
Wat hot wordt toegepast versus wat een herstart nodig heeft

De meeste velden worden hot toegepast zonder downtime. In de modus hybrid worden wijzigingen die een herstart vereisen automatisch afgehandeld.
CategorieVeldenHerstart nodig?
Kanalenchannels.*, web (WhatsApp) — alle ingebouwde en Plugin-kanalenNee
Agent en modellenagent, agents, models, routingNee
Automatiseringhooks, cron, agent.heartbeatNee
Sessies en berichtensession, messagesNee
Tools en mediatools, browser, skills, mcp, audio, talkNee
UI en diversenui, logging, identity, bindingsNee
Gateway-servergateway.* (poort, bind, auth, tailscale, TLS, HTTP)Ja
Infrastructuurdiscovery, canvasHost, pluginsJa
gateway.reload en gateway.remote zijn uitzonderingen — het wijzigen hiervan activeert geen herstart.

​
Reload-planning

Wanneer je een bronbestand bewerkt waarnaar via $include wordt verwezen, plant OpenClaw het herladen vanuit de door de bron geschreven lay-out, niet vanuit de afgevlakte in-memory-weergave. Dat houdt beslissingen voor hot-reload (hot-apply versus opnieuw starten) voorspelbaar, zelfs wanneer een enkele sectie op het hoogste niveau in een eigen included bestand staat, zoals plugins: { $include: "./plugins.json5" }. Herlaadplanning faalt gesloten als de bronlay-out ambigu is.

​
Config-RPC (programmatische updates)

Voor tooling die configuratie via de Gateway-API schrijft, gebruik bij voorkeur deze flow:
  • config.schema.lookup om één subtree te inspecteren (ondiepe schemanode + child-samenvattingen)
  • config.get om de huidige snapshot plus hash op te halen
  • config.patch voor gedeeltelijke updates (JSON merge patch: objecten worden samengevoegd, null verwijdert, arrays worden vervangen)
  • config.apply alleen wanneer je de volledige configuratie wilt vervangen
  • update.run voor expliciete self-update plus herstart
  • update.status om de nieuwste update-herstartsentinel te inspecteren en na een herstart de actieve versie te verifiëren
Agents moeten config.schema.lookup behandelen als de eerste halte voor exacte documentatie en beperkingen op veldniveau. Gebruik Configuratiereferentie wanneer ze de bredere configuratiekaart, standaardwaarden of links naar specifieke subsystem-referenties nodig hebben.
Control-plane-schrijfbewerkingen (config.apply, config.patch, update.run) zijn beperkt tot 3 requests per 60 seconden per deviceId+clientIp. Herstartrequests worden samengevoegd en dwingen daarna een cooldown van 30 seconden af tussen herstartcycli. update.status is alleen-lezen maar admin-scoped, omdat de herstartsentinel samenvattingen van updatestappen en staarten van command-uitvoer kan bevatten.
Voorbeeld van een gedeeltelijke patch: 
openclaw gateway call config.get --params '{}'  # capture payload.hash
openclaw gateway call config.patch --params '{
  "raw": "{ channels: { telegram: { groups: { \"*\": { requireMention: false } } } } }",
  "baseHash": "<hash>"
}'
Zowel config.apply als config.patch accepteren raw, baseHash, sessionKey, note en restartDelayMs. baseHash is voor beide methoden vereist wanneer er al een configuratie bestaat.

​
Omgevingsvariabelen

OpenClaw leest env vars uit het parent process plus:
  • .env uit de huidige werkdirectory (indien aanwezig)
  • ~/.openclaw/.env (globale fallback)
Geen van beide bestanden overschrijft bestaande env vars. Je kunt ook inline env vars in de configuratie instellen: 
{
  env: {
    OPENROUTER_API_KEY: "sk-or-...",
    vars: { GROQ_API_KEY: "gsk-..." },
  },
}
Indien ingeschakeld en verwachte sleutels niet zijn ingesteld, voert OpenClaw je login-shell uit en importeert alleen de ontbrekende sleutels:
{
  env: {
    shellEnv: { enabled: true, timeoutMs: 15000 },
  },
}
Equivalent voor env var: OPENCLAW_LOAD_SHELL_ENV=1
Verwijs in elke stringwaarde in de configuratie naar env vars met ${VAR_NAME}:
{
  gateway: { auth: { token: "${OPENCLAW_GATEWAY_TOKEN}" } },
  models: { providers: { custom: { apiKey: "${CUSTOM_API_KEY}" } } },
}
Regels:
  • Alleen namen in hoofdletters matchen: [A-Z_][A-Z0-9_]*
  • Ontbrekende/lege vars geven een fout bij het laden
  • Escape met $${VAR} voor letterlijke uitvoer
  • Werkt binnen $include-bestanden
  • Inline substitutie: "${BASE}/v1" → "https://api.example.com/v1"
Voor velden die SecretRef-objecten ondersteunen, kun je gebruiken:
{
  models: {
    providers: {
      openai: { apiKey: { source: "env", provider: "default", id: "OPENAI_API_KEY" } },
    },
  },
  skills: {
    entries: {
      "image-lab": {
        apiKey: {
          source: "file",
          provider: "filemain",
          id: "/skills/entries/image-lab/apiKey",
        },
      },
    },
  },
  channels: {
    googlechat: {
      serviceAccountRef: {
        source: "exec",
        provider: "vault",
        id: "channels/googlechat/serviceAccount",
      },
    },
  },
}
SecretRef-details (inclusief secrets.providers voor env/file/exec) staan in Secrets Management. Ondersteunde credential-paden staan vermeld in SecretRef Credential Surface.
Zie Omgeving voor volledige prioriteit en bronnen.

​
Volledige referentie

Voor de volledige referentie per veld, zie Configuratiereferentie.
Gerelateerd: Configuratievoorbeelden · Configuratiereferentie · Doctor

​
Gerelateerd