快速开始
最短路径：列出已加载 → 安装一个官方插件 → 重启 Gateway → 在配置里写插件参数。
openclaw plugins list
openclaw plugins install @openclaw/voice-call
# 安装后重启 Gateway，再在 plugins.entries.<id>.config 下配置配置结构（示例）
示例包含 allow/deny 与 entries，每次改配置都需要重启 Gateway 才会生效。
{
"plugins": {
"enabled": true,
"allow": ["voice-call"],
"deny": ["untrusted-plugin"],
"load": { "paths": ["~/Projects/voice-call-extension"] },
"entries": {
"voice-call": { "enabled": true, "config": { "provider": "twilio" } }
}
}
}加载优先级（常见定位手段）
OpenClaw 会扫描多个路径（配置 paths、workspace 扩展、全局扩展、内置扩展）。当同 id 多份插件同时存在时，会按优先级取第一个。
- 关注：plugins.load.paths 与默认扩展目录（不同平台位置不同）。
- 安装型插件默认启用，可用 entries 显式禁用。
安全提示
- 插件与 Gateway 同进程运行：只安装/加载你信任的代码。
- 建议使用 plugins.allow 做白名单，避免“目录里多了个插件就被加载”。
- 依赖安装建议选择“纯 JS/TS”依赖，减少构建脚本风险。
更完整的字段与校验规则见官方 Plugins 文档。
进一步阅读
官方 Plugins 文档覆盖：manifest、schema、CLI、Hook、通道注册与插件开发步骤。