Changelog
- 2026-03-19: Initial extraction from repos/openclaw (v2026.3.14), repos/nemoclaw (v0.1.0), repos/anthropic-sdk-python
OpenClaw Source Code Intelligence
Repo Location
/data/.openclaw/workspace-clawexpert/repos/openclaw
Principle
When answering ANY question about OpenClaw internals, config validity, or behavior:
- First check openclaw-schema-map skill for pre-extracted schema knowledge
- If not found, go read the actual source code in the repo
- After reading source, update this skill so you don't re-read next time
- ALWAYS prefer source code over documentation — source is truth
Key Files
Config Schema (THE MOST IMPORTANT FILE)
- Path:
repos/openclaw/src/config/zod-schema.ts
- Exports
OpenClawSchema — every valid config key via .strict()
- READ THIS to answer any "is this key valid?" question
- Imports from: zod-schema.agents.ts, zod-schema.core.ts, zod-schema.providers.ts, etc.
Supporting Schema Files
zod-schema.core.ts — SecretInputSchema, ModelsConfigSchema, IdentitySchema, TtsConfigSchema
zod-schema.agents.ts — AgentsSchema, BindingsSchema, BroadcastSchema
zod-schema.agent-runtime.ts — AgentEntrySchema, HeartbeatSchema, SandboxDockerSchema, ToolsSchema
zod-schema.agent-defaults.ts — AgentDefaultsSchema
zod-schema.providers.ts — ChannelsSchema (all channel types)
zod-schema.hooks.ts — HookMappingSchema, HooksGmailSchema
zod-schema.session.ts — CommandsSchema, MessagesSchema, SessionSchema
MCP Handling
- Path:
repos/openclaw/src/config/mcp-config.ts
- Path:
repos/openclaw/src/acp/translator.ts (line 407)
- MCP capabilities are set to
{ http: false, sse: false } in ACP translator
- The
mcp key IS valid in config — it maps to McpConfigSchema with servers record
- Use
mcp.servers for stdio MCP servers; mcporter bridge is the recommended pattern
Plugin System
- Path:
repos/openclaw/src/config/zod-schema.ts (PluginEntrySchema)
- Plugin entries live at
plugins.entries.<id> with: enabled, hooks, subagent, config
- Plugin installs at
plugins.installs.<id>
- Plugin slots:
plugins.slots.memory, plugins.slots.contextEngine
Gateway Entry
- Path:
repos/openclaw/src/config/zod-schema.ts (gateway section)
gateway.bind: "auto" | "lan" | "loopback" | "custom" | "tailnet"
gateway.mode: "local" | "remote"
gateway.customBindHost: valid key (contrary to old runbook entries)
NemoClaw Integration
- Mechanism: OpenClaw plugin (not fork/wrapper)
- Plugin ID:
nemoclaw
- Plugin JSON:
repos/nemoclaw/nemoclaw/openclaw.plugin.json
- Installed via:
curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash
- Runs OpenClaw inside OpenShell (k3s sandbox with Landlock + seccomp + network policies)
- Config keys: blueprintVersion, blueprintRegistry, sandboxName, inferenceProvider
Agent Lifecycle (AgentEntrySchema)
Valid keys for each agent in agents.list[]:
id (required), default, name, workspace, agentDir
model, skills, memorySearch, humanDelay, heartbeat
identity, groupChat, subagents, sandbox, params
tools, runtime
- NO
systemPrompt key directly on agent — that comes from workspace SOUL.md/AGENTS.md
Session Management
- Path:
repos/openclaw/src/config/zod-schema.session.ts
session key maps to SessionSchema
commands key maps to CommandsSchema
messages key maps to MessagesSchema
Version Intel
- Repo HEAD: 2026.3.14 (one patch ahead of our running 2026.3.13)
- NemoClaw: 0.1.0 alpha
- Unreleased:
/btw side-questions command, OpenShell sandbox backend, Firecrawl integration, bundle plugins (Codex/Claude/Cursor), improved gateway health monitor
Critical Discoveries
MCP IS Valid in Config (Correction to old belief)
The mcp key IS in the schema: mcp: McpConfigSchema
const McpConfigSchema = z.object({
servers: z.record(z.string(), McpServerSchema).optional()
}).strict().optional();
mcporter is RECOMMENDED but native stdio MCP via mcp.servers IS supported.
ACP transport capabilities (http/sse) are disabled — that's different from stdio.
customBindHost IS Valid
gateway.customBindHost: z.string().optional() — it IS in the schema.
$schema Key IS Valid
$schema: z.string().optional() — the schema accepts it.
Config .strict() at Root Level
OpenClawSchema uses .strict() — any unknown top-level key crashes the gateway.
Known valid root keys: $schema, meta, env, wizard, diagnostics, logging, cli, update, browser, ui, secrets, auth, acp, models, nodeHost, agents, tools, bindings, broadcast, audio, media, messages, commands, approvals, session, cron, hooks, web, channels, discovery, canvasHost, talk, gateway, memory, mcp, skills, plugins
1---2name: openclaw-source-code3description: Deep knowledge extracted from the OpenClaw source code. Updated by reading the actual repo.4metadata:5 source: https://skillmd.com/skills/nickgallick/openclaw-source-code6---78# Changelog9- 2026-03-19: Initial extraction from repos/openclaw (v2026.3.14), repos/nemoclaw (v0.1.0), repos/anthropic-sdk-python1011# OpenClaw Source Code Intelligence1213## Repo Location14/data/.openclaw/workspace-clawexpert/repos/openclaw1516## Principle17When answering ANY question about OpenClaw internals, config validity, or behavior:181. First check openclaw-schema-map skill for pre-extracted schema knowledge192. If not found, go read the actual source code in the repo203. After reading source, update this skill so you don't re-read next time214. ALWAYS prefer source code over documentation — source is truth2223## Key Files2425### Config Schema (THE MOST IMPORTANT FILE)26- **Path**: `repos/openclaw/src/config/zod-schema.ts`27- Exports `OpenClawSchema` — every valid config key via `.strict()`28- READ THIS to answer any "is this key valid?" question29- Imports from: zod-schema.agents.ts, zod-schema.core.ts, zod-schema.providers.ts, etc.3031### Supporting Schema Files32- `zod-schema.core.ts` — SecretInputSchema, ModelsConfigSchema, IdentitySchema, TtsConfigSchema33- `zod-schema.agents.ts` — AgentsSchema, BindingsSchema, BroadcastSchema34- `zod-schema.agent-runtime.ts` — AgentEntrySchema, HeartbeatSchema, SandboxDockerSchema, ToolsSchema35- `zod-schema.agent-defaults.ts` — AgentDefaultsSchema36- `zod-schema.providers.ts` — ChannelsSchema (all channel types)37- `zod-schema.hooks.ts` — HookMappingSchema, HooksGmailSchema38- `zod-schema.session.ts` — CommandsSchema, MessagesSchema, SessionSchema3940### MCP Handling41- **Path**: `repos/openclaw/src/config/mcp-config.ts`42- **Path**: `repos/openclaw/src/acp/translator.ts` (line 407)43- MCP capabilities are set to `{ http: false, sse: false }` in ACP translator44- The `mcp` key IS valid in config — it maps to `McpConfigSchema` with `servers` record45- Use `mcp.servers` for stdio MCP servers; mcporter bridge is the recommended pattern4647### Plugin System48- **Path**: `repos/openclaw/src/config/zod-schema.ts` (PluginEntrySchema)49- Plugin entries live at `plugins.entries.<id>` with: enabled, hooks, subagent, config50- Plugin installs at `plugins.installs.<id>`51- Plugin slots: `plugins.slots.memory`, `plugins.slots.contextEngine`5253### Gateway Entry54- **Path**: `repos/openclaw/src/config/zod-schema.ts` (gateway section)55- `gateway.bind`: "auto" | "lan" | "loopback" | "custom" | "tailnet"56- `gateway.mode`: "local" | "remote"57- `gateway.customBindHost`: valid key (contrary to old runbook entries)5859### NemoClaw Integration60- **Mechanism**: OpenClaw **plugin** (not fork/wrapper)61- **Plugin ID**: `nemoclaw`62- **Plugin JSON**: `repos/nemoclaw/nemoclaw/openclaw.plugin.json`63- Installed via: `curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash`64- Runs OpenClaw inside OpenShell (k3s sandbox with Landlock + seccomp + network policies)65- Config keys: blueprintVersion, blueprintRegistry, sandboxName, inferenceProvider6667### Agent Lifecycle (AgentEntrySchema)68Valid keys for each agent in `agents.list[]`:69- `id` (required), `default`, `name`, `workspace`, `agentDir`70- `model`, `skills`, `memorySearch`, `humanDelay`, `heartbeat`71- `identity`, `groupChat`, `subagents`, `sandbox`, `params`72- `tools`, `runtime`73- NO `systemPrompt` key directly on agent — that comes from workspace SOUL.md/AGENTS.md7475### Session Management76- **Path**: `repos/openclaw/src/config/zod-schema.session.ts`77- `session` key maps to SessionSchema78- `commands` key maps to CommandsSchema79- `messages` key maps to MessagesSchema8081## Version Intel82- **Repo HEAD**: 2026.3.14 (one patch ahead of our running 2026.3.13)83- **NemoClaw**: 0.1.0 alpha84- **Unreleased**: `/btw` side-questions command, OpenShell sandbox backend, Firecrawl integration, bundle plugins (Codex/Claude/Cursor), improved gateway health monitor8586## Critical Discoveries8788### MCP IS Valid in Config (Correction to old belief)89The `mcp` key IS in the schema: `mcp: McpConfigSchema`90```typescript91const McpConfigSchema = z.object({92 servers: z.record(z.string(), McpServerSchema).optional()93}).strict().optional();94```95mcporter is RECOMMENDED but native stdio MCP via `mcp.servers` IS supported.96ACP transport capabilities (http/sse) are disabled — that's different from stdio.9798### `customBindHost` IS Valid99`gateway.customBindHost: z.string().optional()` — it IS in the schema.100101### `$schema` Key IS Valid102`$schema: z.string().optional()` — the schema accepts it.103104### Config `.strict()` at Root Level105`OpenClawSchema` uses `.strict()` — any unknown top-level key crashes the gateway.106Known valid root keys: $schema, meta, env, wizard, diagnostics, logging, cli, update, browser, ui, secrets, auth, acp, models, nodeHost, agents, tools, bindings, broadcast, audio, media, messages, commands, approvals, session, cron, hooks, web, channels, discovery, canvasHost, talk, gateway, memory, mcp, skills, plugins