Skip to content

Comments

Add OpenClaw configuration schema (openclaw.json)#5392

Open
aronchick wants to merge 2 commits intoSchemaStore:masterfrom
aronchick:add-openclaw-schema
Open

Add OpenClaw configuration schema (openclaw.json)#5392
aronchick wants to merge 2 commits intoSchemaStore:masterfrom
aronchick:add-openclaw-schema

Conversation

@aronchick
Copy link

Summary

Adds a JSON Schema for openclaw.json, the configuration file for OpenClaw — an open-source AI agent gateway that connects LLMs (Claude, GPT, Gemini, etc.) to messaging channels (Telegram, Discord, WhatsApp), scheduled cron tasks, and external tools.

Schema details

What the schema covers

  • gateway — WebSocket server port, bind mode, auth (token/password/none)
  • agents — agent definitions, model routing, heartbeat config
  • channels — Telegram, Discord plugin config with enums for valid values
  • models — custom provider definitions with per-model cost/context info
  • tools — web search, exec, agent-to-agent settings
  • cron — scheduled job definitions with delivery target validation
  • hooks, plugins, skills, session, logging, auth

Motivation

The internal OpenClaw schema exists (compiled into the gateway binary using ajv/zod) but is not publicly exported. Until openclaw/openclaw#22278 is resolved, this community-maintained schema provides IDE validation and auto-complete for all OpenClaw users.

Tested against OpenClaw 2026.2.19-2.

@github-actions
Copy link
Contributor

Thanks for the PR!

This section of the codebase is owned by @madskristensen and @hyperupcall - if they write a comment saying "LGTM" then it will be merged.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant