人工智能大模型LLM 网关AI Agent即时通讯【免费下载链接】openclaw-zero-tokenOpenClaw: Use All Major AI Models NO API Token! Claude/ChatGPT/Gemini/DeepSeek/Doubao/Grok/Qwen/Manus/Kimi项目地址https://gitcode.com/gh_mirrors/op/openclaw-zero-token点击查看免费下载openclaw plugins是 OpenClaw 管理 Gateway 网关插件/扩展进程内加载的核心命令行入口覆盖列出、查看详情、安装、启用/禁用、更新、卸载与健康诊断等全生命周期操作。本文以 docs/zh-CN/cli/plugins.md 为骨架结合仓库内 cli/plugins-cli.ts 等源码实现系统讲解每个子命令的用法、输出含义、底层加载与验证原理并给出可落地的安全配置建议。读完本文你将能够熟练使用openclaw plugins完成插件的安装、启停、排障与更新并理解插件清单openclaw.plugin.json为什么是所有插件不可省略的身份证。概览插件是什么以及openclaw plugins管什么OpenClaw 的插件本质上是一个小型代码模块用额外功能智能体工具、CLI 命令、Gateway 网关 RPC 方法、HTTP 处理程序、后台服务、消息渠道、Skills 等扩展 OpenClaw。插件与 Gateway 网关在同一进程中运行因此被视为受信任代码。openclaw plugins管理的正是这类进程内加载的插件其全部子命令在 cli/plugins-cli.ts 的registerPluginsCli中注册openclaw plugins list openclaw plugins info id openclaw plugins enable id openclaw plugins disable id openclaw plugins doctor openclaw plugins update id openclaw plugins update --all核心设计原则务必牢记内置插件随 OpenClaw 一起发布但默认禁用。使用plugins enable来激活它们已安装的插件默认启用但可用同样方式禁用。所有插件必须提供openclaw.plugin.json文件其中包含内联 JSON SchemaconfigSchema即使为空。缺少或无效的清单或模式会阻止插件加载并导致配置验证失败。插件的身份证明openclaw.plugin.json清单与configSchema在深入 CLI 之前先理解插件加载的硬性门槛因为所有plugins子命令的行为都建立在这套验证之上。每个插件都必须在其插件根目录下提供openclaw.plugin.json。OpenClaw 使用此清单在不执行插件代码的情况下验证配置详见 docs/zh-CN/plugins/manifest.md。清单解析逻辑位于 plugins/manifest.ts 的loadPluginManifest{ id: voice-call, configSchema: { type: object, additionalProperties: false, properties: {} } }必填键只有两个id字符串插件的规范 idconfigSchema对象插件配置的 JSON Schema内联形式。可选键包括kind插件类型如memory、channels插件注册的渠道 id、providers注册的提供商 id、skills相对插件根目录的 Skills 目录、name/description/version、uiHintsUI 渲染用的标签/占位符/敏感标志等。JSON Schema 的几个关键规则与plugins doctor的报错直接相关每个插件都必须提供 JSON Schema即使不接受任何配置空 Schema 是可接受的如{ type: object, additionalProperties: false }Schema 在配置读取/写入时验证而非在运行时。在 plugins/loader.ts 中加载器对manifestRecord.configSchema缺失的插件直接报missing config schema错误并将状态置为error对已配置值调用validateJsonSchemaValue校验失败则报invalid config: ...并阻止加载。验证行为还包含这些容易踩坑的规则未知的channels.*键会被视为错误除非该渠道 id 已在插件清单中声明plugins.entries.id、plugins.allow、plugins.deny和plugins.slots.*必须引用可发现的插件 id未知 id 视为错误插件已安装但清单或 Schema 损坏/缺失时验证失败doctor会报告插件错误插件配置存在但插件已禁用时配置会被保留并在doctor和日志中显示警告。列出与查看插件list与info/inspectopenclaw plugins list列出所有被发现的插件。源码中该子命令支持三个选项见 cli/plugins-cli.ts--json以 JSON 输出含workspaceDir、plugins数组、diagnostics便于脚本化处理--enabled只显示已启用status loaded的插件--verbose显示每个插件的详细信息format、source、origin、version、providers、error 等。默认表格输出的列包括Name、ID、Format、Statusloaded/disabled/error、Source、Version并会列出本次命中的Source rootsstock随 OpenClaw 捆绑的扩展目录workspace工作区扩展目录global全局扩展目录帮助快速定位插件来自哪里。openclaw plugins info id别名inspect查看单个插件的完整体检报告是排查插件为什么加载失败的第一工具。inspect输出plugins/status.ts 的buildPluginInspectReport生成包含Status/Format/Source/Origin/VersionShape插件形态hook-only、plain-capability、hybrid-capability、non-capabilityCapabilities能力清单如cli-backend、text-inference、speech、media-understanding、image-generation、web-search、channelTyped hooks、Custom hooks、Tools、Commands、CLI commands、Services、Gateway methods、MCP servers、LSP servers、HTTP routesPolicyallowPromptInjection、allowModelOverride、allowedModels等安全策略字段Diagnostics与Install记录source/spec/install path/version/installed at出错时末尾会附Error:详情。也支持openclaw plugins inspect --all配合--json可一次性导出全部插件的体检数据id与--all不能同时使用。启用与禁用enable/disable内置插件默认禁用用以下命令激活openclaw plugins enable id openclaw plugins disable id从 plugins/enable.ts 的实现可以看出enable背后的行为若plugins.enabled false或插件命中plugins.deny拒绝列表启用会失败并给出原因plugins disabled/blocked by denylist成功时会把plugins.entries.id.enabled置为true并自动把该插件加入plugins.allow允许列表ensurePluginAllowlisted对于内置渠道插件如 matrix、nostrenable还会同步写channels.id.enabled true见 plugins/toggle-config.ts命令执行后提示Restart the gateway to apply——配置更改需要重启 Gateway 网关才能生效。plugins doctor中看到的disabled状态即来自这类配置开关plugins/loader.ts 通过resolveEffectiveEnableState综合enabled主开关、allow/deny、entries.id.enabled、清单enabledByDefault与 memory 槽位策略得出最终启停决定。安装插件install path-or-specopenclaw plugins install path-or-spec该子命令接受的参数形态非常丰富源码实现见 cli/plugins-install-command.ts按优先级依次尝试本地路径.ts/.js/.mjs/.cjs单文件或包含插件清单/package.json的目录本地归档.zip、.tgz、.tar.gz、.tarnpm 包openclaw plugins install openclaw/voice-call内部使用npm pack拉取并解压到~/.openclaw/extensions/id/ClawHub 包clawhub:name规格安装时校验pluginApiRange/minGatewayVersion兼容性与完整性见 plugins/clawhub.tsClaude marketplace 插件--marketplace source从本地仓库或 git/GitHub 源安装捆绑插件兜底当 npm 失败且存在同名内置插件时回退到捆绑源。常用示例# 复制本地文件/目录到 ~/.openclaw/extensions/id openclaw plugins install ./extensions/voice-call # 从本地 tarball/zip 安装 openclaw plugins install ./plugin.tgz openclaw plugins install ./plugin.zip # 链接模式不复制适合开发迭代相当于把路径加入 plugins.load.paths openclaw plugins install -l ./my-plugin # 从 npm 安装官方插件 openclaw plugins install openclaw/voice-call选项说明-l, --link链接本地目录而不是复制仅对本地目录路径有效会合并写入plugins.load.paths与--marketplace、--pin互斥--pin将 npm 安装记录为精确解析的nameversion固定版本--marketplace source安装 Claude marketplace 插件安装到单文件时插件 id 取文件基本名voice-call.ts→voice-call目录安装则依据清单 id /package.json的openclaw.extensions决定多个扩展时 id 变为name/fileBase。安全提示原文档明确强调将插件安装视为运行代码。插件与 Gateway 同一进程运行请只安装你信任的插件优先使用固定版本如--pin或显式nameversion优先使用plugins.allow允许列表收窄可加载范围更改后重启 Gateway 网关。另外注意安装要求package.json包含openclaw.extensions如[./dist/index.js]缺失会报missing_openclaw_extensions错误若当前配置无效安装前会提示先运行openclaw doctor --fix。更新插件update id/--all/--dry-runopenclaw plugins update id openclaw plugins update --all openclaw plugins update id --dry-run更新仅适用于从 npm 安装的插件在plugins.installs中跟踪的安装记录本地路径/归档安装的插件不在更新范围内。update同时也会更新被跟踪的 hook pack见 cli/plugins-update-command.ts。--all更新所有被跟踪的插件与 hook pack未指定 id 且未用--all时报错提示--dry-run只显示将要发生的变化不写入任何配置若检测到 npm 包的完整性漂移integrity drift即解析出的包哈希与安装记录中的不一致非 dry-run 模式会提示确认后继续dry-run 模式则仅告警更新完成后同样提示Restart the gateway to load plugins and hooks。诊断与卸载doctor/uninstallopenclaw plugins doctor插件加载问题的体检中心。它汇总三类信息并分组输出Plugin errors状态为error的插件逐条列出id: 错误信息 (来源路径)Diagnostics级别为error的诊断消息如plugin path not found、missing config schema、invalid config: ...Compatibility兼容性提示如legacy before_agent_start旧钩子用法警告、hook-only未迁移到显式能力注册的提示。全部干净时输出No plugin issues detected.。开启OPENCLAW_PLUGIN_LOADER_DEBUG_STACKS1环境变量可以让加载错误附带完整堆栈便于定位插件模块自身的异常。openclaw plugins uninstall id完整的反安装命令源码位于 cli/plugins-cli.ts可选--keep-files保留磁盘上的安装文件只移除配置与安装记录--keep-config是其已废弃别名--force跳过确认提示--dry-run只预览将移除的内容。执行前会先打印将要移除的清单config entry、install record、allowlist entry、load path、memory slot、channel config、directory 等。默认会删除安装目录卸载后需重启 Gateway 生效。插件发现与加载的源码级原理理解plugins list为什么显示某个插件、为什么某些插件看不见关键在插件发现顺序plugins/discovery.ts 的discoverOpenClawPlugins。OpenClaw 按以下顺序扫描如果多个插件解析到相同的 id顺序中第一个匹配项获胜较低优先级的副本被忽略显示为disabled并注明overridden by ... plugin配置路径plugins.load.paths文件或目录origin 为config优先级最高工作区扩展workspace/.openclaw/extensions/*.ts与*/index.tsorigin 为workspace全局扩展~/.openclaw/extensions/*.ts与*/index.tsorigin 为global捆绑扩展openclaw/extensions/*origin 为bundled随 OpenClaw 发布、默认禁用。其余加载要点插件通过jiti在运行时加载为TypeScript 模块配置验证不执行插件代码只读清单和 Schema插件 id 默认规则包集合用package.json的name作用域包规范化为无作用域 id如openclaw/voice-call→voice-call独立文件用文件基本名若导出id则以其为准但与配置 id 不一致时发出警告发现阶段有安全校验源文件逃逸插件根目录、路径全局可写world-writable、所有者可疑uid 不匹配的候选会被阻止并记录诊断blocked plugin candidate: ...加载过程包含plugin id mismatch、missing register/activate export、plugin failed during register等错误路径均会以error状态呈现在plugins list/doctor中。相关配置与安全建议插件相关配置位于plugins.*类型定义见 config/types.plugins.ts{ plugins: { enabled: true, // 主开关默认 true allow: [voice-call], // 允许列表可选 deny: [untrusted-plugin], // 拒绝列表可选deny 优先 load: { paths: [~/Projects/oss/voice-call-extension] }, // 额外插件文件/目录 entries: { voice-call: { enabled: true, config: { provider: twilio } }, }, slots: { memory: memory-core }, // 独占类别槽位none 禁用 memory 插件 installs: {}, // 安装记录npm/clawhub/marketplace 等来源的跟踪 }, }独占类别如 memory通过plugins.slots选择唯一活跃插件多个kind: memory插件同时声明时只有被选中的加载。配置变更均需重启 Gateway 网关。安全底线总结插件与 Gateway 同进程运行视为受信任代码仅安装可信来源插件优先使用plugins.allow允许列表deny优先于allow用--pin/ 显式版本固定 npm 安装更新时留意integrity drift告警安装后可用openclaw plugins doctor复核加载状态用openclaw security audit --deep做深度代码安全检查。延伸阅读插件系统完整指南插件 API、渠道插件编写、提供商认证插件、钩子、命名约定与 npm 分发契约插件清单要求openclaw.plugin.json必填字段、JSON Schema 规则与验证行为Gateway 安全网关安全加固源码参考cli/plugins-cli.tsCLI 注册、cli/plugins-install-command.ts安装流程、plugins/loader.ts加载器、plugins/status.ts状态与体检报告、plugins/install.ts安装实现、plugins/manifest.ts清单解析。赞分享人工智能大模型LLM 网关AI Agent即时通讯【免费下载链接】openclaw-zero-tokenOpenClaw: Use All Major AI Models NO API Token! Claude/ChatGPT/Gemini/DeepSeek/Doubao/Grok/Qwen/Manus/Kimi项目地址https://gitcode.com/gh_mirrors/op/openclaw-zero-token点击查看免费下载相关推荐OpenClaw 插件管理实战指南深入解析 openclaw plugins 命令的安装、启用、更新与卸载OpenClaw 插件管理实战指南深入解析 openclaw plugins 命令的安装、启用、更新与卸载 本篇指南以 OpenClaw 官方 CLI 参考文人工智能大模型LLM 网关AI Agent即时通讯OpenClaw 插件管理指南openclaw-cn plugins 命令的完整使用与实现原理OpenClaw 插件管理指南openclaw cn plugins 命令的完整使用与实现原理 导读 本文围绕中文社区版 OpenClaw 的 opencla人工智能AI Agent即时通讯后端本地部署语音OpenClaw 诊断指标接入 Prometheusdiagnostics-prometheus 插件安装、指标与抓取实战指南OpenClaw 诊断指标接入 Prometheusdiagnostics prometheus 插件安装、指标与抓取实战指南 导读 diagnosticsAI 应用AI Agent交互助手后端即时通讯网关上一篇Mainsail社区贡献指南如何为开源3D打印机项目贡献力量下一篇PHPExcel图表标题与标签设置终极指南打造专业级数据可视化报表创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考