插件系统
OpenClaw 插件是 TypeScript 模块，通过 RPC、工具、CLI 命令和渠道扩展核心功能。插件在进程内运行，需要确保来源可信。
核心概念
插件使用 openclaw.plugin.json 清单文件（manifest）进行配置验证（基于 JSON Schema），验证过程无需执行代码。运行时通过 jiti 加载插件。
插件能力
| 能力 | 说明 |
|---|---|
| Gateway 扩展 | 注册 HTTP 路由（api.registerHttpRoute）、RPC 方法和后台服务 |
| Agent 集成 | 添加 Agent 工具、自动回复命令（无需 AI 执行）和生命周期钩子（before_prompt_build） |
| 渠道与认证 | 实现消息渠道（WhatsApp、Teams 等）或 Provider 认证流程（OAuth） |
| 运行时辅助 | 通过 api.runtime 访问核心 TTS/STT 能力 |
插件发现顺序
插件按以下优先顺序加载：
- 配置路径（
plugins.load.paths） - 工作空间扩展目录（
/.openclaw/extensions/） - 全局扩展目录（
~/.openclaw/extensions/） - 内置扩展（随 OpenClaw 一起发布）
插件文档
Agent 工具
| 文档 | 说明 |
|---|---|
| 插件 Agent 工具 | 开发自定义 Agent 工具，扩展 AI 助手的能力 |
社区与生态
| 文档 | 说明 |
|---|---|
| 社区插件 | 社区贡献的第三方插件列表与使用说明 |
插件开发
| 文档 | 说明 |
|---|---|
| 插件清单（Manifest） | openclaw.plugin.json 清单文件格式与配置规范 |
| 技能开发指南 | 中文技能（Skill）开发指南 |
官方渠道插件
| 文档 | 说明 |
|---|---|
| 语音通话插件 | @openclaw/voice-call — 语音通话渠道插件 |
| Zalo 个人版插件 | @openclaw/zalouser — Zalo 个人版消息渠道插件 |
官方插件列表
内存插件
| 插件 | 说明 |
|---|---|
memory-core | 核心内存插件（内置默认） |
memory-lancedb | 长期内存存储（基于 LanceDB） |
通信渠道插件
| 插件 | 说明 |
|---|---|
@openclaw/voice-call | 语音通话 |
@openclaw/zalouser | Zalo 个人版 |
@openclaw/matrix | Matrix 协议 |
@openclaw/nostr | Nostr 协议 |
@openclaw/zalo | Zalo 官方 |
@openclaw/msteams | Microsoft Teams |
Provider 认证插件
| 插件 | 说明 |
|---|---|
google-antigravity-auth | Google Antigravity 认证 |
google-gemini-cli-auth | Google Gemini CLI 认证 |
qwen-portal-auth | 通义千问 Portal 认证 |
copilot-proxy | Copilot 代理 |
默认启用的内置插件
| 插件 | 说明 |
|---|---|
device-pair | 设备配对 |
phone-control | 手机控制 |
talk-voice | 语音对话 |
插件管理
CLI 命令
bash
# 安装插件
openclaw plugins install @openclaw/voice-call
# 列出已安装插件
openclaw plugins list
# 启用插件
openclaw plugins enable <plugin-name>
# 禁用插件
openclaw plugins disable <plugin-name>重启生效
插件配置变更后需要重启 Gateway 才能生效。
安全特性
- 路径遍历检查 — 防止插件访问不安全路径
- 可选白名单 — 通过
plugins.allow列表限制可加载的插件
🇨🇳 中国用户须知
部分插件可能需要配置代理才能正常安装和运行。如遇到网络问题，请参考 国内网络配置 进行设置。