OpenClaw怎么接入本地工具?

雨杰大大_7261

雨杰大大_7261

2026-08-01

795人浏览

原创

OpenClaw接入本地工具需启用--enable-local-execution参数,挂载宿主机二进制文件(如/usr/bin、/usr/local/bin或单个可执行文件),配置沙盒PATH环境变量,并通过host.docker.internal或端口映射访问本地HTTP服务,最后在tools.yaml中注册脚本并重启服务。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

openclaw怎么接入本地工具?

OpenClaw接入本地工具需要让AI代理能直接调用你本机安装的命令行程序、脚本或服务,比如git、curl、python脚本、本地API服务等。这一步不做,OpenClaw就只能在沙盒里空转,无法真正修改你的代码库、提交变更或触发CI流程。

确认OpenClaw运行模式支持本地工具调用

OpenClaw默认使用Docker沙盒隔离执行环境,【沙盒内默认无法访问宿主机上的可执行文件】。必须显式启用“本地工具桥接”能力,否则所有本地命令都会报错“command not found”或权限拒绝。

检查你启动OpenClaw时是否已传入 --enable-local-execution 参数。若未启用,后续挂载和配置全部无效。

将宿主机二进制文件挂载进沙盒

方法一:按路径批量挂载常用工具

在启动OpenClaw容器时,用 -v 将宿主机工具目录映射到沙盒内固定路径:

docker run -v /usr/bin:/usr/local/bin:ro -v /usr/local/bin:/usr/local/bin:ro ... openclaw/app:latest

注意:【/usr/bin 和 /usr/local/bin 必须都挂载,否则像 git、curl、jq 等常见工具可能缺失】。只挂一个目录会导致部分命令找不到。

方法二:精确挂载单个可执行文件(推荐用于安全敏感场景)

例如只允许调用 git 和自定义脚本 /opt/mytools/deploy.sh:

docker run -v /usr/bin/git:/usr/bin/git:ro -v /opt/mytools/deploy.sh:/usr/local/bin/deploy:ro ...

挂载后需在沙盒内赋予执行权限:chmod +x /usr/local/bin/deploy,否则OpenClaw调用会失败。

配置沙盒内PATH环境变量

步骤一:确认沙盒默认PATH不包含你挂载的路径

进入正在运行的OpenClaw容器:docker exec -it openclaw-app sh,执行 echo $PATH。通常输出为 /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin。

步骤二:扩展PATH使挂载工具生效

启动容器时通过 -e PATH="/usr/local/bin:/usr/bin:/bin" 覆盖默认值;若已运行,需修改OpenClaw配置文件中的 sandbox_env.PATH 字段,指向含挂载路径的完整列表。

步骤三:验证工具可用性

在OpenClaw Web UI中新建会话,输入指令 which git && git --version。成功返回版本号即表示挂载与PATH配置均生效。

OpenClaw Logfire
OpenClaw Logfire

Pydantic Logfire 可观测性 — OTEL 生成式 AI 追踪、工具调用 span、Token 指标、分布式追踪

下载

让OpenClaw调用本地HTTP服务(如Ollama、FastAPI)

方法一:通过 host.docker.internal 访问宿主机服务

启动容器时必须添加 --add-host host.docker.internal:host-gateway。否则沙盒内无法解析该域名,所有 http://host.docker.internal:11434 请求都会超时。

方法二:绑定宿主机端口并直连 localhost

仅适用于Linux/macOS;Windows WSL2下需额外配置iptables规则。启动命令中加 -p 11434:11434 并确保宿主机服务监听 0.0.0.0:11434 而非 127.0.0.1:11434,否则沙盒无法连接。

方法三:挂载宿主机网络命名空间(高风险,仅调试用)

--network host 可让沙盒直接复用宿主机网络栈,但会绕过Docker网络隔离,【生产环境严禁使用】。

授权OpenClaw执行特定脚本或命令

第一步:准备脚本并设为可执行

将你要调用的Shell脚本(如 /home/user/scripts/push-to-github.sh)设置权限:chmod 755 /home/user/scripts/push-to-github.sh。

第二步:挂载脚本并注册为工具

在OpenClaw的 tools.yaml 配置中添加:

- name: push_to_github

description: Push current branch to origin main

command: /usr/local/bin/push-to-github.sh

第三步:重启OpenClaw服务使配置生效

修改配置后必须重启容器,热重载不支持工具注册变更。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
OpenClaw如何卸载
OpenClaw如何卸载

《OpenClaw如何卸载?OpenClawAI小龙虾安全卸载最新指南》为您提供详尽、安全的卸载步骤,帮助用户彻底移除OpenClaw及其相关组件。本指南针对Windows与macOS系统分别说明操作流程,涵盖停止后台进程、清除配置文件、删除残留数据等关键环节,确保无痕卸载,避免系统冲突或隐私泄露。无论您是因更换工具、解决兼容问题,还是出于安全考虑,本文都将助您高效、安心地完成卸载操作。请务必按照最新版本指引执行,以保障设备稳定与数据安

2026.03.19

160

11

OpenClaw安装部署教程
OpenClaw安装部署教程

本合集涵盖2026最新版OpenClaw(小龙虾)本地部署全流程,适用于Windows系统,包含环境配置、模型接入、Web界面启动及飞书/Telegram/QQ等多平台对接。无论你是小白还是开发者,10分钟内即可完成安装,快速体验AI智能体“长手干活”的强大能力!

2026.03.19

241

11

OpenClaw初学者教程:如何使用和设置
OpenClaw初学者教程:如何使用和设置

《OpenClawAI初学者教程:如何使用和设置》是一套面向新手的入门指南,涵盖环境搭建、基础配置、模型加载及简单推理操作。通过本教程,你将快速掌握OpenClawAI的核心功能,轻松开启AI开发之旅。

2026.03.19

261

13

OpenClawAI技能系统基础介绍:OpenClawAISkills是什么
OpenClawAI技能系统基础介绍:OpenClawAISkills是什么

OpenClawAI Skills 是 OpenClaw 智能体的核心功能模块,用于定义和管理 AI 可执行的具体能力,如查询天气、发送消息、操作文件等。通过技能系统,用户可灵活扩展智能体功能,实现高度定制化的自动化任务。

2026.03.20

1398

20

龙虾OpenClaw安全使用指南
龙虾OpenClaw安全使用指南

围绕龙虾OpenClawAI使用中的安全风险,本合集系统梳理常见漏洞与隐患,提供实用防护方法与最新安全指南,帮助用户在稳定运行的同时规避风险,提升整体使用安全性与体验。

2026.03.20

169

11

openclaw养虾硬件指南最新版
openclaw养虾硬件指南最新版

《OpenClawAI硬件指南最新版》合集聚焦AI硬件入门与进阶,从核心组件解析到实战搭建,系统讲解算力配置、设备选型与优化方案。内容通俗易懂,适合开发者与科技爱好者快速掌握AI硬件要点,构建高效稳定的智能计算环境。

2026.03.20

588

28

OpenClaw从新手到中级完整教程
OpenClaw从新手到中级完整教程

本专题专为零基础用户设计,带你从环境搭建到实战应用,系统掌握开源AI Agent OpenClaw。内容涵盖Node.js/Docker安装、API配置、Skills技能扩展及多平台集成,通过整理文件、自动化办公等真实案例,助你快速上手。无论你是想提升效率的职场人还是技术爱好者,都能在此找到从入门到精通的完整路径,打造专属的本地化AI助手。

2026.05.06

1622

32

OpenClaw免费大模型调用指南
OpenClaw免费大模型调用指南

PHP中文网特设OpenClaw免费大模型专区,提供详尽调用指南。涵盖免费API申请、模型配置及本地部署教程,助您零成本畅享AI智能体验。无论是新手入门还是进阶应用,这里都有实用干货,轻松跨越创作门槛,开启高效智能办公新方式。

2026.06.29

159

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程