🛠️ Tool Enhancement#

为 OpenClaw 打造的 55+ 增强工具集

参考 Claude Code 架构设计 | 支持自然语言调用

---

✨ 特性#

特性说明🔰 55+ 工具覆盖文件/Shell/Git/网页/记忆/UI 场景🧠 自然语言智能理解用户意图，自动调用工具📦 统一注册全局 ToolRegistry，工具即插即用🔒 权限控制FS_READ / EXECUTE / NETWORK 等权限体系⚡ 异步执行所有工具原生 async/await 支持🎨 终端UI表格/进度条/菜单/树形等丰富组件

---

🚀 快速开始#

安装#

bash

# 通过 ClawHub 安装（推荐）
clawhub install tool-enhancement

# 或手动克隆
git clone https://github.com/ntaffffff/openclaw-tool-enhancement.git

基本用法#

bash

# 方式1: 自然语言（推荐）
python3 ~/.openclaw/workspace/skills/tool-enhancement/tools/run_nlp.py "读取 /etc/hostname"

# 方式2: 直接调用工具
python3 ~/.openclaw/workspace/skills/tool-enhancement/tools/run_tool.py file_read path="/etc/hostname"

---

📖 使用教程#

在 OpenClaw 对话中直接使用#

当用户说以下内容时，AI 会自动调用对应工具：

用户说调用的工具示例"读取 /etc/hostname"file_read📄 查看文件内容"执行 ls -la"shell_exec💻 运行命令"查看系统信息"system_info💻 系统概况"天气怎么样"http_request🌤️ 查询天气"搜索 Python 教程"web_search🔍 网络搜索"记住今天开会"memory_remember🧠 存储记忆"git status"git_status📦 Git 状态"推送代码"git_push📤 代码推送

代码中调用#

python

import sys
sys.path.insert(0, "~/.openclaw/workspace/skills/tool-enhancement/tools")

from __init__ import load_all_tools, get_registry
import asyncio

async def main():
    # 加载所有工具
    load_all_tools()

    # 获取注册表
    registry = get_registry()

    # 执行工具
    result = await registry.execute("file_read", path="/etc/hostname")
    print(result.data)  # 输出: dxx

asyncio.run(main())

---

🛠️ 工具总览#

📁 文件操作 (9个)#

工具功能示例file_read读取文件path="/etc/hostname"``file_write写入文件path="/tmp/test.txt", content="hello"``file_edit编辑文件path="/tmp/test.txt", old="a", new="b"``file_delete删除文件path="/tmp/test.txt"``file_glob搜索文件pattern="*.py"``file_copy复制文件src="/a.txt", dst="/b.txt"``file_move移动文件src="/a.txt", dst="/b.txt"``file_info文件信息path="/tmp"``file_list列出目录path="/tmp"

💻 执行工具 (7个)#

工具功能示例shell_exec执行Shell命令command="ls -la"``shell_background后台执行command="python server.py", detached=True``process_list列出进程-process_kill终止进程pid=1234``shell_sudo提权执行command="apt update"``script_run运行脚本path="/tmp/script.sh"``system_info系统信息-

📦 Git 工具 (8个)#

工具功能示例git_status查看状态path="."``git_log查看日志path=".", max_count=10``git_diff查看差异path="."``git_commit提交代码path=".", message="fix: bug"``git_push推送到远程path="."``git_pull拉取更新path="."``git_branch分支操作path="."``git_remote远程操作path="."

🌐 网页工具 (5个)#

工具功能示例http_requestHTTP请求url="http://wttr.in/Shanghai"``web_fetch网页抓取url="https://example.com"``web_search网络搜索query="Python 教程"``api_requestAPI调用url="https://api.github.com"``url_parseURL解析url="https://a.com/b?c=1"

🧠 记忆工具 (6个)#

工具功能示例memory_remember存储记忆content="重要事项", importance=5``memory_recall检索记忆query="项目", limit=5``memory_summarize总结记忆query="上周"``memory_dream记忆整合dry_run=false``memory_context上下文记忆query="当前任务"``memory_stats记忆统计-

🤖 Agent 工具 (6个)#

工具功能示例agent_spawn启动子Agentname="coder", prompt="分析代码"``agent_delegate委托任务agent_id="xxx", task="..."``agent_result获取结果task_id="xxx"``agent_list列出Agent-agent_cancel取消Agenttask_id="xxx"``coordinator多Agent协调task="...", phases=[...]

🎨 UI 工具 (8个)#

工具功能ui_spinner加载动画ui_progress进度条ui_table表格显示ui_tree树形结构ui_markdownMarkdown渲染ui_status状态显示ui_confirm确认对话框ui_menu菜单选择

🔌 MCP 工具 (6个)#

工具功能mcp_list列出MCP服务器mcp_discover发现MCP服务mcp_call调用MCP工具mcp_resource访问MCP资源mcp_prompt使用MCP提示词mcp_statusMCP状态

---

📁 文件结构#

text

tool-enhancement/
├── SKILL.md                    # 本文档
├── tools/
│   ├── __init__.py             # 统一加载器
│   ├── schema.py               # 基础类定义
│   ├── run_tool.py             # 命令行工具调用器
│   ├── run_nlp.py              # 自然语言理解器
│   ├── file_tools.py           # 文件操作 (9)
│   ├── exec_tools.py           # 执行工具 (7)
│   ├── git_tools.py            # Git 工具 (8)
│   ├── web_tools.py            # 网页工具 (5)
│   ├── mcp_tools.py            # MCP 工具 (6)
│   ├── agent_tools.py          # Agent 工具 (6)
│   ├── memory_tools.py         # 记忆工具 (6)
│   └── ui_tools.py             # UI 工具 (8)
└── README.md

---

🤝 贡献#

欢迎提交 Issue 和 PR！

---

📄 许可证#

MIT License

---

🌟 喜欢这个工具？请给个 Star！