{"id":"eef01a91-bb67-42ab-9ca9-259e76095c0a","shortId":"ub4FbS","kind":"skill","title":"openclaw-ref","tagline":"OpenClaw platform reference - plugin system, extensions, configuration, boot/provisioning, channels, models, CLI. Use when working on openclaw codebase, building openclaw plugins/extensions, configuring openclaw instances, provisioning openclaw gateways, designing agent provision","description":"# OpenClaw Platform Reference\n\nStructured reference for the OpenClaw assistant platform. Source repo: `~/Projects/openclaw/`. Tracking version: **2026.4.7** (refresh: 2026-04-07).\n\n## Quick Navigation\n\nLoad the relevant reference file based on the task:\n\n### Plugin & Extension System\n- **`references/plugin-system.md`** - Plugin discovery, loading, manifest format, registration API, installation CLI, SDK exports. Read when building/debugging plugins or understanding how extensions are loaded.\n\n### Configuration\n- **`references/configuration.md`** - Full config structure (`OpenClawConfig`), config paths, file format (JSON5), env var substitution, `$include` directives, validation (Zod), per-plugin config, programmatic read/write. Read when modifying or generating openclaw config.\n\n### Boot & Provisioning\n- **`references/boot-provisioning.md`** - Gateway startup sequence, BOOT.md mechanism, onboarding flows (interactive/non-interactive), plugin loading during boot, sidecar startup order, health checks. Read when designing automated provisioning or debugging startup.\n\n### Channels & Extensions\n- **`references/channels-extensions.md`** - All built-in channels (Telegram, Discord, Slack, Signal, iMessage, WhatsApp, Web) + extension channels (MS Teams, Matrix, Zalo, Voice Call, Feishu). Channel plugin registration, per-channel config, Telegram specifics. Read when adding/configuring channels.\n\n### Models & Providers\n- **`references/models-providers.md`** - Provider configuration, `models.mode` (merge/replace), x402 providers, model catalog structure, provider registration via plugins. Read when configuring model access or building provider plugins.\n\n### CLI Commands\n- **`references/cli-commands.md`** - Key CLI commands for config, plugins, channels, agents, onboarding, gateway, skills. Read when scripting openclaw setup or building automation.\n\n### GitHub Context (live issues, PRs, gotchas)\n- **`references/github-context.md`** - Open bugs, breaking changes, recent impactful PRs, plugin/config known issues, dev gotchas synthesized from GitHub. Refreshed via `/refresh-openclaw`. Read before starting any non-trivial openclaw work to avoid known pitfalls.\n\n## Key File Paths (repo-root relative)\n\n```\nsrc/plugins/           - Plugin loader, discovery, registry, install, types\nsrc/plugin-sdk/        - 100+ scoped exports for plugin consumption\nsrc/config/            - Config loading, types, validation, defaults, paths\nsrc/gateway/           - Gateway server, boot, startup, server methods\nsrc/commands/          - CLI commands (onboard, config, etc.)\nsrc/cli/               - CLI wiring (plugins-cli, skills-cli, etc.)\nextensions/            - Extension implementations (channels, memory, etc.)\nskills/                - Built-in skill definitions\ndocs/                  - Documentation (Mintlify)\n```\n\n## Config File Locations\n\n- Main config: `~/.openclaw/openclaw.json` (parsed as JSON5)\n- Extensions: `~/.openclaw/extensions/`\n- Skills: `~/.openclaw/skills/` (managed) + workspace skills\n- Agents: `~/.openclaw/agents/<agent-id>/`\n- Sessions: `~/.openclaw/agents/<agent-id>/sessions/`\n- Credentials: `~/.openclaw/credentials/`\n- Override: `OPENCLAW_CONFIG_PATH` env var\n\n## Plugin Manifest Quick Ref\n\n```json\n{\n  \"id\": \"plugin-id\",\n  \"name\": \"Display Name\",\n  \"kind\": \"memory\",\n  \"channels\": [\"channel-id\"],\n  \"providers\": [\"provider-id\"],\n  \"configSchema\": { \"type\": \"object\" },\n  \"uiHints\": { \"field\": { \"label\": \"...\", \"sensitive\": true } }\n}\n```\n\n## Config Structure Quick Ref\n\nTop-level keys in `OpenClawConfig`:\n`meta`, `auth`, `acp`, `env`, `secrets`, `plugins`, `skills`, `models`, `agents`, `tools`, `channels`, `session`, `hooks`, `gateway`, `logging`, `browser`, `memory`, `messages`, `approvals`, `cron`","tags":["openclaw","ref","skills","tenequm","agent-skills","ai-agents","claude-code","claude-skills","clawhub","erc-8004","mpp","solana"],"capabilities":["skill","source-tenequm","skill-openclaw-ref","topic-agent-skills","topic-ai-agents","topic-claude-code","topic-claude-skills","topic-clawhub","topic-erc-8004","topic-mpp","topic-openclaw","topic-skills","topic-solana","topic-x402"],"categories":["skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/tenequm/skills/openclaw-ref","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add tenequm/skills","source_repo":"https://github.com/tenequm/skills","install_from":"skills.sh"}},"qualityScore":"0.461","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 23 github stars · SKILL.md body (3,746 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T01:01:39.999Z","embedding":null,"createdAt":"2026-04-18T23:05:19.640Z","updatedAt":"2026-04-22T01:01:39.999Z","lastSeenAt":"2026-04-22T01:01:39.999Z","tsv":"'-04':51 '-07':52 '/.openclaw/agents':353,355 '/.openclaw/credentials':358 '/.openclaw/extensions':346 '/.openclaw/openclaw.json':341 '/.openclaw/skills':348 '/projects/openclaw':45 '/refresh-openclaw':256 '/sessions':356 '100':285 '2026':50 '2026.4.7':48 'access':205 'acp':407 'adding/configuring':183 'agent':31,220,352,413 'api':74 'approv':423 'assist':41 'auth':406 'autom':143,231 'avoid':267 'base':60 'boot':120,134,301 'boot.md':126 'boot/provisioning':11 'break':241 'browser':420 'bug':240 'build':21,207,230 'building/debugging':81 'built':153,329 'built-in':152,328 'call':170 'catalog':195 'chang':242 'channel':12,148,155,164,172,177,184,219,324,379,381,415 'channel-id':380 'check':139 'cli':14,76,210,214,306,312,316,319 'codebas':20 'command':211,215,307 'config':92,95,110,119,178,217,292,309,336,340,361,395 'configschema':387 'configur':10,24,89,189,203 'consumpt':290 'context':233 'credenti':357 'cron':424 'debug':146 'default':296 'definit':332 'design':30,142 'dev':249 'direct':104 'discord':157 'discoveri':69,280 'display':375 'doc':333 'document':334 'env':100,363,408 'etc':310,320,326 'export':78,287 'extens':9,65,86,149,163,321,322,345 'feishu':171 'field':391 'file':59,97,271,337 'flow':129 'format':72,98 'full':91 'gateway':29,123,222,299,418 'generat':117 'github':232,253 'gotcha':237,250 'health':138 'hook':417 'id':370,373,382,386 'imessag':160 'impact':244 'implement':323 'includ':103 'instal':75,282 'instanc':26 'interactive/non-interactive':130 'issu':235,248 'json':369 'json5':99,344 'key':213,270,402 'kind':377 'known':247,268 'label':392 'level':401 'live':234 'load':55,70,88,132,293 'loader':279 'locat':338 'log':419 'main':339 'manag':349 'manifest':71,366 'matrix':167 'mechan':127 'memori':325,378,421 'merge/replace':191 'messag':422 'meta':405 'method':304 'mintlifi':335 'model':13,185,194,204,412 'models.mode':190 'modifi':115 'ms':165 'name':374,376 'navig':54 'non':262 'non-trivi':261 'object':389 'onboard':128,221,308 'open':239 'openclaw':2,4,19,22,25,28,33,40,118,227,264,360 'openclaw-ref':1 'openclawconfig':94,404 'order':137 'overrid':359 'pars':342 'path':96,272,297,362 'per':108,176 'per-channel':175 'per-plugin':107 'pitfal':269 'platform':5,34,42 'plugin':7,64,68,82,109,131,173,200,209,218,278,289,315,365,372,410 'plugin-id':371 'plugin/config':246 'plugins-c':314 'plugins/extensions':23 'programmat':111 'provid':186,188,193,197,208,383,385 'provider-id':384 'provis':27,32,121,144 'prs':236,245 'quick':53,367,397 'read':79,113,140,181,201,224,257 'read/write':112 'recent':243 'ref':3,368,398 'refer':6,35,37,58 'references/boot-provisioning.md':122 'references/channels-extensions.md':150 'references/cli-commands.md':212 'references/configuration.md':90 'references/github-context.md':238 'references/models-providers.md':187 'references/plugin-system.md':67 'refresh':49,254 'registr':73,174,198 'registri':281 'relat':276 'relev':57 'repo':44,274 'repo-root':273 'root':275 'scope':286 'script':226 'sdk':77 'secret':409 'sensit':393 'sequenc':125 'server':300,303 'session':354,416 'setup':228 'sidecar':135 'signal':159 'skill':223,318,327,331,347,351,411 'skill-openclaw-ref' 'skills-c':317 'slack':158 'sourc':43 'source-tenequm' 'specif':180 'src/cli':311 'src/commands':305 'src/config':291 'src/gateway':298 'src/plugin-sdk':284 'src/plugins':277 'start':259 'startup':124,136,147,302 'structur':36,93,196,396 'substitut':102 'synthes':251 'system':8,66 'task':63 'team':166 'telegram':156,179 'tool':414 'top':400 'top-level':399 'topic-agent-skills' 'topic-ai-agents' 'topic-claude-code' 'topic-claude-skills' 'topic-clawhub' 'topic-erc-8004' 'topic-mpp' 'topic-openclaw' 'topic-skills' 'topic-solana' 'topic-x402' 'track':46 'trivial':263 'true':394 'type':283,294,388 'uihint':390 'understand':84 'use':15 'valid':105,295 'var':101,364 'version':47 'via':199,255 'voic':169 'web':162 'whatsapp':161 'wire':313 'work':17,265 'workspac':350 'x402':192 'zalo':168 'zod':106","prices":[{"id":"d9626cd6-504e-4ea5-922b-e07562e445fa","listingId":"eef01a91-bb67-42ab-9ca9-259e76095c0a","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"tenequm","category":"skills","install_from":"skills.sh"},"createdAt":"2026-04-18T23:05:19.640Z"}],"sources":[{"listingId":"eef01a91-bb67-42ab-9ca9-259e76095c0a","source":"github","sourceId":"tenequm/skills/openclaw-ref","sourceUrl":"https://github.com/tenequm/skills/tree/main/skills/openclaw-ref","isPrimary":false,"firstSeenAt":"2026-04-18T23:05:19.640Z","lastSeenAt":"2026-04-22T01:01:39.999Z"}],"details":{"listingId":"eef01a91-bb67-42ab-9ca9-259e76095c0a","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"tenequm","slug":"openclaw-ref","github":{"repo":"tenequm/skills","stars":23,"topics":["agent-skills","ai-agents","claude-code","claude-skills","clawhub","erc-8004","mpp","openclaw","skills","solana","x402"],"license":"mit","html_url":"https://github.com/tenequm/skills","pushed_at":"2026-04-14T16:24:57Z","description":"Agent skills for building, shipping, and growing software products","skill_md_sha":"3795f7fbe64543ad4ca163441e60034d8713025e","skill_md_path":"skills/openclaw-ref/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/tenequm/skills/tree/main/skills/openclaw-ref"},"layout":"multi","source":"github","category":"skills","frontmatter":{"name":"openclaw-ref","description":"OpenClaw platform reference - plugin system, extensions, configuration, boot/provisioning, channels, models, CLI. Use when working on openclaw codebase, building openclaw plugins/extensions, configuring openclaw instances, provisioning openclaw gateways, designing agent provisioning flows (e.g. agentbox), or debugging openclaw config/plugin/channel issues. Triggers on openclaw, openclaw config, openclaw plugin, openclaw extension, openclaw channel, openclaw gateway, openclaw provisioning, openclaw onboarding, openclaw boot, openclaw skills, BOOT.md, openclaw.plugin.json, openclaw-x402, agentbox provisioning."},"skills_sh_url":"https://skills.sh/tenequm/skills/openclaw-ref"},"updatedAt":"2026-04-22T01:01:39.999Z"}}