必须完成权限激活、工具注册与语义绑定三步闭环:执行openclaw config set tools.profile full并重启网关;通过Plugin热加载或CLI手动注入注册工具;指令含动词、上下文有实体、技能已启用方可触发调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在OpenClaw中让AI真正执行你写的内部API、本地脚本或私有服务,必须绕过默认禁用状态,完成权限激活、工具注册与语义绑定三步闭环,缺一不可。
启用full权限模式
新版OpenClaw(v2026.3.2起)默认关闭所有外部工具执行能力,即使工具代码已部署,也会返回“我没有权限执行此操作”。
执行命令:openclaw config set tools.profile full
【必须重启网关才能生效】,仅修改配置不重启,工具调用始终被拦截。
重启命令:openclaw gateway restart
注册自定义工具
工具注册方式取决于部署形态,选一种即可:
方法一:通过Plugin机制热加载(推荐)
1. 将工具实现为符合OpenClaw Plugin规范的模块,导出twilio_call、internal_approval等具名函数;
2. 放入plugins/目录下对应子文件夹(如plugins/internal_api/);
3. 运行openclaw plugin load internal_api,控制台输出✅ Loaded 2 tools from internal_api即成功。
方法二:手动注入CLI工具
编辑config/tools.json,在"cli_tools"数组中添加对象:{"name": "jq_parser", "path": "/usr/local/bin/jq", "args_schema": {"input": "string"}}。
注意:路径必须真实存在且具有可执行权限,否则权限校验层直接拒绝。
触发工具调用
工具不会自动运行,必须满足三重信号同时成立:
第一步:指令中含明确动作动词——例如说“调用审批接口”比“审批接口怎么用”更易触发;
第二步:上下文存在可绑定实体——比如前一句刚上传了leave_request.json,后句说“用审批工具处理它”,系统就能把文件路径绑定到工具参数;
第三步:已安装且启用对应技能——若工具名为internal_approval,但openclaw skill list未显示该条目,则调用失败。
验证是否就绪:直接输入“测试 internal_approval 工具”,若返回结构化结果而非报错,说明链路已通。


















