插件安装与管理教程

beginner
## 插件与技能的区别 在 OpenClaw 中,技能和插件是两种不同的扩展方式,理解它们的区别很重要: **技能(Skill)** 是一个 SKILL.md 文本文件,教智能体如何做事。它改变的是智能体的行为——比如教它如何搜索网页、如何写代码。安装命令是 `clawhub install`。 **插件(Plugin)** 是一个代码包,扩展的是 Gateway 网关的底层能力。它增加的是系统功能——比如添加语音通话支持、接入新的聊天渠道。安装命令是 `openclaw plugins install`。 简单来说:技能让智能体"学会新技巧",插件让系统"获得新能力"。 | 对比项 | 技能 | 插件 | |--------|------|------| | 本质 | SKILL.md 文本文件 | 代码包 | | 作用层级 | 智能体行为 | Gateway 系统能力 | | 安装命令 | `clawhub install` | `openclaw plugins install` | | 存储位置 | `~/.openclaw/skills/` | Gateway 插件目录 | | 生效方式 | 即时生效 | 需要重启 Gateway | ## 安装插件 使用 `openclaw plugins install` 命令安装插件: ```bash openclaw plugins install <插件名称> ``` 例如,安装语音通话插件: ```bash openclaw plugins install @openclaw/voice-call ``` 安装完成后,需要重启 Gateway 才能让插件生效: ```bash openclaw gateway restart ``` > **注意**:与技能不同,插件安装后不会立即生效,必须重启 Gateway。这是因为插件运行在 Gateway 进程中,需要重新加载才能识别新插件。 ## 查看已安装插件 查看当前已安装的所有插件: ```bash openclaw plugins list ``` 该命令会列出每个插件的名称、版本和启用状态。 ## 插件配置 大多数插件安装后需要进行配置才能正常工作。插件配置在 OpenClaw 的主配置文件 `~/.openclaw/openclaw.json` 中完成: ```json { "plugins": { "entries": { "voice-call": { "enabled": true, "config": { "provider": "twilio" } } } } } ``` 配置说明: - `enabled`:是否启用该插件,设为 `false` 可以临时禁用而不卸载 - `config`:插件的具体配置项,每个插件的配置内容不同,请参考插件文档 修改配置后同样需要重启 Gateway: ```bash openclaw gateway restart ``` ## 卸载插件 不再需要的插件可以卸载: ```bash openclaw plugins uninstall <插件名称> ``` 卸载后记得重启 Gateway 使变更生效。 ## 常用插件介绍 以下是一些常用的 OpenClaw 插件: ### Voice Call — 语音通话 让智能体具备语音通话能力,支持接听和拨打电话。需要配置语音服务提供商(如 Twilio)。 ```bash openclaw plugins install @openclaw/voice-call ``` ### 渠道插件 OpenClaw 通过渠道插件接入各种聊天平台。部分渠道已内置支持,部分需要额外安装插件: - **微信**:通过 iLink Bot 插件接入微信 - **飞书**:通过 WebSocket 方式连接飞书机器人 - **企业微信**:通过专用插件接入企业微信 具体的渠道连接方法请参考《聊天渠道连接教程》。 ## 在龙虾技能库浏览插件 龙虾技能库不仅收录技能,也收录了 OpenClaw 插件。你可以在插件专区浏览所有可用插件,查看中文介绍、安全扫描结果和使用说明。 每个插件页面都会展示: - **安全扫描等级**:帮你评估插件的安全性 - **安装量和收藏量**:了解插件的受欢迎程度 - **中文文档**:翻译后的使用说明和配置指南 ## 安全提示 插件比技能拥有更高的系统权限,因为它们直接运行在 Gateway 进程中。安装插件前请注意: - **确认来源可靠**:优先选择官方或已验证的插件 - **查看安全扫描**:在龙虾技能库查看插件的安全扫描报告 - **了解权限范围**:阅读插件文档,了解它需要哪些系统权限 - **及时更新**:保持插件版本最新,获取安全修复 - **谨慎配置**:API Key 等敏感信息建议使用环境变量,不要硬编码在配置文件中 #OpenClaw插件安装 #openclaw插件命令 #AI插件 #插件管理 #龙虾技能库