openclaw支持四类插件扩展:一、javascript官方插件(v2026.3.8+,需node.js 22+及cli);二、声明式skills技能(markdown编写,自动加载至提示词);三、nanobot python插件(ai自然语言触发,热加载);四、sdk原生c++插件(国产硬件适配,动态库热加载)。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望为OpenClaw添加特定业务逻辑、对接内部系统或实现模型专属工具调用,则需通过其插件系统扩展功能。以下是开发自定义功能扩展的多种可行路径:
一、基于JavaScript的官方插件开发(适用于v2026.3.8+)
该方式使用OpenClaw CLI构建标准插件包,支持HTTP路由、CLI命令、生命周期钩子等完整扩展能力,是生产环境推荐方案。
1、确保本地已安装Node.js 22+及最新版OpenClaw CLI:npm install -g openclaw@latest
2、创建全局插件目录:mkdir -p ~/.openclaw/extensions/my-tool
3、在该目录下新建openclaw.plugin.json,填写必需字段如id、version、main和configSchema
4、编写入口文件index.js,导出register(api)函数,在其中调用api.registerTool()或api.registerHttpRoute()
5、执行openclaw plugins install ./my-tool完成安装,并运行openclaw plugins enable my-tool启用
二、自定义Skills技能开发(无需编程基础)
Skills是声明式功能单元,以Markdown文档为核心,由OpenClaw自动加载至AI提示词中,适合非开发者快速封装工具调用逻辑。
1、进入工作区技能目录:cd ~/.openclaw/workspace/skills/
2、新建技能文件夹并创建SKILL.md,文件头必须包含YAML格式元数据(name、description必填)
3、在正文部分按规范撰写“功能描述”“使用场景”“使用方法”及“输出格式”,其中“使用方法”需明确列出AI调用时应执行的步骤序列
4、若技能依赖外部工具(如Python脚本),将可执行文件放入scripts/子目录,并在SKILL.md的“依赖”段落中声明版本与路径
5、重启Gateway使新技能生效:openclaw gateway restart
三、nanobot轻量级Python插件开发(面向AI应用层)
适用于已部署nanobot子系统的用户,通过Python模块直接注入工具函数,由AI自然语言触发调用,适合快速原型验证。
1、确认nanobot服务正常运行,检查日志中是否存在模型加载成功标识
2、在插件目录/root/.nanobot/plugins/下新建模块文件夹,包含__init__.py、tools.py和config.json
3、于tools.py中定义带文档字符串的函数,参数类型需明确标注(如city: str),返回值为字符串或字典
4、在config.json中声明工具名称、描述及是否启用缓存等行为配置
5、执行nanobot plugin reload命令热加载插件,无需重启服务
四、SDK驱动的原生插件热加载(工业级产线场景)
针对飞腾D2000等国产硬件平台或高可靠性产线系统,利用OpenClaw SDK直接编译动态链接库,实现零停机功能升级。
1、获取OpenClaw SDK源码包,确认其与目标平台ABI兼容性(如aarch64-linux-gnu)
2、编写C++插件主体,继承IPluginInterface并实现Initialize()与Execute()虚函数
3、使用SDK提供的claw_plugin_build.sh脚本交叉编译生成.so文件
4、将编译产物复制至/opt/openclaw/plugins/,并在plugins.load.paths中显式追加该路径
5、调用openclaw plugin hotload my-industrial-plugin触发运行时注入










