一、先分清：插件 vs 技能
二者是完全不同的扩展形态，核心区别一目了然：
表格
| 对比项 | 技能（Skill） | 插件（Plugin） |
|---|---|---|
| 本质 | SKILL.md 纯文本规则文件 | 可执行代码包 |
| 作用层级 | 控制智能体行为（学会新操作） | 扩展网关底层能力（新增系统功能） |
| 安装命令 | clawhub install | openclaw plugins install |
| 存放目录 | ~/.openclaw/skills/ | 网关专属插件目录 |
| 生效规则 | 安装即生效，无需重启 | 安装 / 改配置后必须重启网关 |
一句话总结：技能教 AI 做事，插件给系统加新功能。
二、插件基础操作命令
1. 安装插件
bash
运行
openclaw plugins install 插件名
示例：安装官方语音通话插件
bash
运行
openclaw plugins install @openclaw/voice-call
✅ 关键步骤：安装完成一定要重启网关才能加载插件
bash
运行
openclaw gateway restart
2. 查看已安装插件
列出所有插件、版本、启用状态：
bash
运行
openclaw plugins list
3. 临时禁用插件（不卸载）
在主配置文件 ~/.openclaw/openclaw.json 中设置 enabled: false：
json
{
"plugins": {
"entries": {
"voice-call": {
"enabled": false
}
}
}
}
修改后重启网关生效。
4. 卸载插件
bash
运行
openclaw plugins uninstall 插件名
卸载后同样执行重启：
bash
运行
openclaw gateway restart
三、插件配置方法
插件大多需要单独参数配置，统一写在 ~/.openclaw/openclaw.json 的 plugins.entries 节点下。
标准配置模板
json
{
"plugins": {
"entries": {
"插件标识": {
"enabled": true,
"config": {
// 这里填写该插件专属参数
"key1": "value1",
"key2": "value2"
}
}
}
}
}
示例（语音通话插件基础配置）：
json
{
"plugins": {
"entries": {
"voice-call": {
"enabled": true,
"config": {
"provider": "twilio"
}
}
}
}
}
注意：每一次修改配置，都需要重启网关：
openclaw gateway restart
四、常用插件介绍
- @openclaw/voice-call 语音通话 实现接听 / 拨打电话能力，搭配语音服务商使用。 bash运行
openclaw plugins install @openclaw/voice-call - 各类聊天渠道插件 用于对接第三方社交平台，拓展对话入口：
- 微信、企业微信、飞书 等均为独立渠道插件
- 安装 + 配置后，即可在对应平台使用智能体
五、插件查找与参考
可在龙虾技能库插件专区浏览：
- 查看中文介绍、使用文档
- 查看安全扫描等级、权限说明
- 参考热门度、用户评价选择插件
六、安全使用规范（重点）
插件运行在网关进程内，系统权限远高于普通技能，风险也更大：
- 优先官方 / 已验证插件，谨慎使用匿名第三方插件
- 安装前查看安全报告、了解插件所需权限
- 敏感密钥（API Key、令牌）优先用环境变量，不要硬编码到配置文件
- 定期更新插件，修复安全漏洞与 Bug
- 不用的插件及时禁用或卸载，减少攻击面
七、命令速查表
表格
| 功能 | 执行命令 |
|---|---|
| 安装插件 | openclaw plugins install 插件名 |
| 查看已装插件 | openclaw plugins list |
| 卸载插件 | openclaw plugins uninstall 插件名 |
| 重启网关（必做） | openclaw gateway restart |