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
This commit is contained in:
Pulse
@@ -0,0 +1,109 @@
|
||||
# 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`
|
||||
@@ -0,0 +1,56 @@
|
||||
# OpenClaw Config: Schema Sources
|
||||
|
||||
This skill is designed to prevent schema bugs (wrong key/type/missing constraint) that can stop the OpenClaw Gateway from starting or cause unsafe behavior changes.
|
||||
The config format is **JSON5**, and most config objects are **strict** (unknown keys fail validation).
|
||||
|
||||
Reference source version: `openclaw/openclaw@875324e` (cloned on 2026-02-07).
|
||||
Fields can change across versions, so prefer the schema from the OpenClaw version you are actually running.
|
||||
|
||||
## Priority: How To Confirm A Field Exists
|
||||
|
||||
1. When the Gateway is running (recommended)
|
||||
- Fetch the JSON Schema:
|
||||
- `openclaw gateway call config.schema --params '{}'`
|
||||
- Use `jq` or grep/search on the schema to confirm the field path exists before writing keys.
|
||||
|
||||
2. When the Gateway is not running / you need source-level constraints
|
||||
- Clone source:
|
||||
- `git clone https://github.com/openclaw/openclaw.git`
|
||||
- Key schema files:
|
||||
- Root schema: `src/config/zod-schema.ts` (`OpenClawSchema`)
|
||||
- `$include` semantics: `src/config/includes.ts`
|
||||
- agents/tools: `src/config/zod-schema.agents.ts`, `src/config/zod-schema.agent-defaults.ts`, `src/config/zod-schema.agent-runtime.ts`
|
||||
- models: `src/config/zod-schema.core.ts` (`ModelsConfigSchema`)
|
||||
- channels: `src/config/zod-schema.providers.ts`, `src/config/zod-schema.providers-core.ts`, `src/config/zod-schema.providers-whatsapp.ts`
|
||||
- session/messages/commands: `src/config/zod-schema.session.ts`
|
||||
- approvals: `src/config/zod-schema.approvals.ts`
|
||||
- Repo docs with lots of examples:
|
||||
- `docs/gateway/configuration.md`
|
||||
|
||||
## Fast Navigation (Do Not Guess Keys)
|
||||
|
||||
Run from the openclaw repo root:
|
||||
|
||||
```bash
|
||||
rg -n "export const OpenClawSchema" src/config/zod-schema.ts
|
||||
rg -n "\\bgateway:\\s*z" src/config/zod-schema.ts
|
||||
rg -n "\\bskills:\\s*z" src/config/zod-schema.ts
|
||||
rg -n "\\bplugins:\\s*z" src/config/zod-schema.ts
|
||||
|
||||
rg -n "export const ChannelsSchema" src/config/zod-schema.providers.ts
|
||||
rg -n "DiscordConfigSchema|TelegramConfigSchema|SlackConfigSchema" src/config/zod-schema.providers-core.ts
|
||||
|
||||
rg -n "export const ModelsConfigSchema" src/config/zod-schema.core.ts
|
||||
rg -n "export const ToolsSchema" src/config/zod-schema.agent-runtime.ts
|
||||
```
|
||||
|
||||
## How To Read Validation Errors
|
||||
|
||||
`openclaw doctor` issues usually include:
|
||||
- `path`: failing field path (most important)
|
||||
- `message`: why it failed (type mismatch, unknown key, missing required key, cross-field constraint, etc.)
|
||||
|
||||
Fix strategy:
|
||||
- **Unknown key**: the key does not exist in the schema (or is misspelled). Confirm the correct name in schema.
|
||||
- **Type mismatch**: change to the schema's expected type (number/string/boolean/object/array).
|
||||
- **Constraint failure (superRefine)**: satisfy related fields described by the message (for example: some channels require `allowFrom` to include `"*"` when `dmPolicy="open"`).
|
||||
Reference in New Issue
Block a user