Files
bot/docs/zh-CN/cli/plugins.md
zooqueen 071e3f1082 rebrand: openclaw -> hanzo bot across entire codebase
Automated rebrand of all openclaw references to hanzo bot:
- Package: openclaw -> @hanzo/bot
- Binary: openclaw -> hanzo-bot
- Config: ~/.openclaw -> ~/.hanzo/bot
- Docker: ghcr.io/hanzoai/bot
- Env vars: OPENCLAW_* -> BOT_*
- Bundle IDs: ai.hanzo.bot.*
- Product name: Hanzo Bot
2026-03-19 13:52:32 -07:00

1.7 KiB
Raw Permalink Blame History

read_when, summary, title, x-i18n
read_when summary title x-i18n
你想安装或管理进程内 Gateway 网关插件
你想调试插件加载失败问题
`hanzo-bot plugins` 的 CLI 参考(列出、安装、启用/禁用、诊断) plugins
generated_at model provider source_hash source_path workflow
2026-02-03T07:45:08Z claude-opus-4-5 pi c6bf76b1e766b912ec30a0101d455151c88f1a778bffa121cdd1d0b4fbe73e1c cli/plugins.md 15

hanzo-bot plugins

管理 Gateway 网关插件/扩展(进程内加载)。

相关内容:

命令

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

内置插件随 Hanzo Bot 一起发布,但默认禁用。使用 plugins enable 来激活它们。

所有插件必须提供 openclaw.plugin.json 文件,其中包含内联 JSON Schema(configSchema,即使为空)。缺少或无效的清单或模式会阻止插件加载并导致配置验证失败。

安装

openclaw plugins install <path-or-spec>

安全提示:将插件安装视为运行代码。优先使用固定版本。

支持的归档格式:.zip、.tgz、.tar.gz、.tar。

使用 --link 避免复制本地目录(添加到 plugins.load.paths):

openclaw plugins install -l ./my-plugin

更新

openclaw plugins update <id>
openclaw plugins update --all
openclaw plugins update <id> --dry-run

更新仅适用于从 npm 安装的插件(在 plugins.installs 中跟踪)。