Files
pulse-memory/skills/openclaw-config/references/openclaw-config-fields.md
T
Pulse 22d9f5b21d feat: skill expansion — browser, security, SQL, files (16 skills total)
Novas skills instaladas:
- openclaw-agent-browser   v1.0.0  CLI Chromium — navegação, login, screenshots, state
- skill-security-audit    v1.0.0  SAST scanning, prompt injection, secrets audit
- sql-toolkit             v1.0.0  PostgreSQL/MySQL/SQLite — schema, query, otimização
- file                    v1.0.0  Organização de arquivos por contexto
- file-summary            v1.0.0  Extração e resumo de PDFs, Word, Excel

Workspace expandido:
- TOOLS.md: +Browser automation, Security audit, SQL, File management
- AGENTS.md: +Linux Analyst section (comandos, logs, rede, scripts) + Full-stack strategy
- MEMORY.md: 16 skills indexadas, stack map, comandos Linux ref
- SESSION-STATE.md: atualizado com contexto completo
- lock.json: sincronizado com 16 skills instaladas
2026-05-19 20:51:05 -03:00

4.6 KiB

OpenClaw Config Field Index (openclaw.json)

Reference source version: openclaw/openclaw@875324e (2026-02-07). Fields can change across versions, so prefer config.schema from the running Gateway when possible.

Config file: ~/.openclaw/openclaw.json (JSON5)

  • Override path via OPENCLAW_CONFIG_PATH
  • Split config via $include (semantics in src/config/includes.ts)

Root Keys (OpenClawSchema)

The root object is strict; aside from $include preprocessing, unknown keys fail validation.

  • meta: metadata written by the system (lastTouchedVersion, lastTouchedAt)
  • env: shell env import + env var sugar (string catchall)
  • wizard: wizard run metadata
  • diagnostics: diagnostics/otel/cacheTrace
  • logging: log level/output/redaction
  • update: update channel + check-on-start
  • browser: Browser/CDP settings
  • ui: UI styling + assistant name/avatar
  • auth: auth profiles/order/cooldowns
  • models: model providers/definitions
  • nodeHost: node host settings (currently includes browserProxy)
  • agents: agents.defaults + agents.list
  • tools: global tool policy + exec/web/media/links
  • bindings: route channel/account/peer to agents
  • broadcast: broadcast strategy + peer->agentId mapping
  • audio: audio settings (e.g., transcription)
  • media: media pipeline settings (e.g., preserveFilenames)
  • messages: message behavior/prefixing (see session schema)
  • commands: chat command settings (see session schema)
  • approvals: approvals policy (see approvals schema)
  • session: session policy (see session schema)
  • cron: cron store/concurrency
  • hooks: hooks server + gmail/internal mappings
  • web: web socket/reconnect settings
  • channels: channel providers (whatsapp/telegram/discord/slack/...)
  • discovery: mdns/wideArea
  • canvasHost: Canvas Host
  • talk: talk/TTS shortcuts
  • gateway: gateway service/auth/remote/tls/http endpoints/nodes
  • memory: memory backend/citations/qmd
  • skills: skills loading/install/entries
  • plugins: plugins loading/entries/installs

gateway (Commonly Edited Keys)

Source: gateway section in src/config/zod-schema.ts.

  • gateway.port: number
  • gateway.mode: "local" | "remote"
  • gateway.bind: "auto" | "lan" | "loopback" | "custom" | "tailnet"
  • gateway.controlUi:
    • enabled, basePath, root, allowedOrigins
    • allowInsecureAuth, dangerouslyDisableDeviceAuth
  • gateway.auth:
    • mode: "token" | "password"
    • token, password, allowTailscale
  • gateway.trustedProxies: string[]
  • gateway.tailscale: { mode: "off" | "serve" | "funnel", resetOnExit }
  • gateway.remote:
    • url, transport: "ssh" | "direct"
    • token, password, tlsFingerprint
    • sshTarget, sshIdentity
  • gateway.reload: { mode: "off" | "restart" | "hot" | "hybrid", debounceMs }
  • gateway.tls: { enabled, autoGenerate, certPath, keyPath, caPath }
  • gateway.http.endpoints:
    • chatCompletions.enabled
    • responses.enabled, responses.maxBodyBytes
    • responses.files / responses.images (allowUrl/allowedMimes/maxBytes/maxRedirects/timeoutMs, etc.)
  • gateway.nodes:
    • browser.mode: "auto" | "manual" | "off"
    • browser.node: string
    • allowCommands, denyCommands: string[]

skills / plugins (Install + Entries)

Source: skills / plugins sections in src/config/zod-schema.ts.

skills:

  • skills.allowBundled: string[]
  • skills.load: { extraDirs, watch, watchDebounceMs }
  • skills.install: { preferBrew, nodeManager: "npm"|"pnpm"|"yarn"|"bun" }
  • skills.entries.<id>:
    • enabled: boolean
    • apiKey: string
    • env: record<string,string>
    • config: record<string,unknown>

plugins:

  • plugins.enabled: boolean
  • plugins.allow / plugins.deny: string[]
  • plugins.load.paths: string[]
  • plugins.slots.memory: string
  • plugins.entries.<id>: { enabled, config }
  • plugins.installs.<id>:
    • source: "npm" | "archive" | "path"
    • spec, sourcePath, installPath, version, installedAt

channels / models / agents / tools (Use Schema Files)

These sections are large and can change quickly; locate keys via schema files instead of guessing:

  • channels: src/config/zod-schema.providers.ts + src/config/zod-schema.providers-core.ts
    • Note: channels is passthrough (allows extension channel keys)
    • But each provider object (telegram/discord/slack/...) is usually strict
  • models: ModelsConfigSchema in src/config/zod-schema.core.ts
  • agents: src/config/zod-schema.agents.ts / src/config/zod-schema.agent-defaults.ts / src/config/zod-schema.agent-runtime.ts
  • tools: ToolsSchema in src/config/zod-schema.agent-runtime.ts