📦 OpenClaw Reference — 平台参考文档

# OpenClaw 平台参考 OpenClaw 助手平台的结构化参考。源码仓库：~/Projects/openclaw/。跟踪版本：2026.4.1（刷新：2026-04-01）。 ## 快速导航 根据任务加载对应的参考文件： ### 插件与扩展系统 - references/plugin-system.md - 插件发现、加载、清单格式、注册 API、安装 CLI、SDK 导出。在构建/调试插件或理解扩展加载方式时阅读。 ### 配置 - references/configuration.md - 完整配置结构（OpenClawConfig）、配置路径、文件格式（JSON5）、环境变量替换、$include 指令、校验（Zod）、插件级配置、程序化读写。在修改或生成 openclaw 配置时阅读。 ### 启动与供给 - references/boot-provisioning.md - 网关启动顺序、BOOT.md 机制、上线流程（交互式/非交互式）、启动时插件加载、sidecar 启动顺序、健康检查。在设计自动供给或调试启动问题时阅读。 ### 频道与扩展 - references/channels-extensions.md - 所有内置频道（Telegram、Discord、Slack、Signal、iMessage、WhatsApp、Web）+ 扩展频道（MS Teams、Matrix、Zalo、Voice Call、Feishu）。频道插件注册、频道级配置、Telegram 细节。在添加/配置频道时阅读。 ### 模型与提供商 - references/models-providers.md - 提供商配置、models.mode（merge/replace）、x402 提供商、模型目录结构、通过插件注册提供商。在配置模型访问或构建提供商插件时阅读。 ### CLI 命令 - references/cli-commands.md - 配置、插件、频道、代理、上线、网关、技能等关键 CLI 命令。在脚本化 openclaw 设置或构建自动化时阅读。 ### GitHub 上下文（实时 issues、PRs、注意事项） - references/github-context.md - 开放 bug、破坏性变更、近期高影响 PR、插件/配置已知问题、从 GitHub 提炼的开发注意事项。通过 /refresh-openclaw 刷新。在开始任何非平凡的 openclaw 工作前阅读，避免已知陷阱。 ## 关键文件路径（相对于仓库根目录） `` src/plugins/ - 插件加载器、发现、注册表、安装、类型 src/plugin-sdk/ - 供插件使用的 100+ 作用域导出 src/config/ - 配置加载、类型、校验、默认值、路径 src/gateway/ - 网关服务器、启动、启动顺序、服务器方法 src/commands/ - CLI 命令（onboard、config 等） src/cli/ - CLI 绑定（plugins-cli、skills-cli 等） extensions/ - 扩展实现（频道、记忆等） skills/ - 内置技能定义 docs/ - 文档（Mintlify） ` ## 配置文件位置 - 主配置：~/.openclaw/openclaw.json（按 JSON5 解析） - 扩展：~/.openclaw/extensions/ - 技能：~/.openclaw/skills/（受管理）+ 工作区技能 - 代理：~/.openclaw/agents// - 会话：~/.openclaw/agents//sessions/ - 凭据：~/.openclaw/credentials/ - 覆盖：环境变量 OPENCLAW_CONFIG_PATH ## 插件清单速查 `json { "id": "plugin-id", "name": "Display Name", "kind": "memory", "channels": ["channel-id"], "providers": ["provider-id"], "configSchema": { "type": "object" }, "uiHints": { "field": { "label": "...", "sensitive": true } } } ` ## 配置结构速查 OpenClawConfig 顶级键：meta、auth、acp、env、secrets、plugins、skills、models、agents、tools、channels、session、hooks、gateway、logging、browser、memory、messages、approvals、cron`