openclaw支持四种自动加载模块/插件/技能的方式:一、配置插件自动加载路径;二、启用workspace扩展目录自动发现;三、通过cli批量预注册插件清单;四、修改启动脚本注入自动import逻辑。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望 OpenClaw 在启动或运行时自动加载指定模块、插件或技能,避免每次手动执行 openclaw plugins install 或 import 操作,则需配置其自动导入机制。OpenClaw 支持通过多种方式实现模块/插件/技能的自动发现与注册,以下为具体方法:
一、启用插件自动加载路径
OpenClaw 会按固定优先级顺序扫描多个目录以发现插件,将插件包放置于任一已注册路径下即可实现启动时自动加载,无需手动 install 命令。
1、确认当前插件加载路径配置:
2、若需新增自动扫描目录,编辑 ~/.openclaw/openclaw.json,在 plugins.load.paths 数组中添加绝对路径:
3、将目标插件(如 @openclaw/file-tools)解压或软链接至该路径下(注意:不得使用符号链接逃逸出插件根目录):
4、重启 Gateway 使变更生效:
二、配置 workspace 扩展目录自动发现
OpenClaw 默认扫描当前工作区下的 .openclaw/extensions/ 目录,所有符合插件规范的子目录将被自动识别并加载。
1、进入您的 OpenClaw 工作区根目录(例如 D:\OpenClaw_Agent):
2、创建扩展目录:
3、将插件源码或已打包插件(含 openclaw.plugin.json)复制进该目录:
4、确保插件 ID 不与内置插件冲突(否则高优先级路径将覆盖低优先级):
OpenClaw 跨平台配置备份与网关监控。自动备份 openclaw.json,每分钟检测 gateway 状态,宕机时自动恢复。支持 Linux/macOS/Windows。触发:配置备份、gateway 监控、自动恢复、看门狗、watchdog。
三、使用 CLI 批量预注册插件清单
通过 openclaw plugins enable 配合配置文件可实现“声明式预启用”,Gateway 启动时将自动加载并激活所列插件,跳过交互式安装步骤。
1、创建插件启用清单文件 plugins.enabled.json,内容格式为 JSON 数组:
2、在 openclaw.json 中引用该清单(支持相对或绝对路径):
3、执行初始化命令触发批量加载:
4、验证是否全部启用:
四、修改启动脚本注入自动 import 行为
对于需动态导入 Python 技能模块(如自定义 skills/ 下的 .py 文件),可通过修改启动流程,在 Gateway 初始化阶段自动执行 import 操作。
1、定位 Python 技能加载入口文件(通常为 src/skills/__init__.py):
2、在该文件末尾添加自动遍历逻辑(示例):
3、确保 skills/ 目录位于 Python 路径中,并在 .env 中启用对应开关:
4、重启服务后,所有符合命名规范的技能模块将被自动 import 并注册为可用工具:









