Tool Enhancement

🚀 55+ 增强工具集 - 为 OpenClaw 赋能。文件操作、Shell执行、Git工作流、网页请求、子Agent调度、分层记忆、终端UI，一应俱全。

Security Scan

该技能的声明、所包含的代码和运行说明在功能上相互一致——它确实提供文件操作、Shell 执行、Git、网络请求、子 Agent 调度等高权限工具；不过这些能力本身很强，请在受限环境中审慎使用并审核权限。

Purpose & Capability

技能名/描述声明提供“文件操作、Shell执行、Git、网页请求、子Agent、记忆、UI”等功能，包内的模块（file_tools, exec_tools, git_tools, web_tools, agent_tools, memory_tools 等）确实实现了这些能力。要求的二进制（python3, git, curl）与功能相符。没有发现请求与其声明不一致的额外凭据或外部依赖。

Instruction Scope

SKILL.md 的示例和运行方式直接调用本地脚本（run_nlp.py / run_tool.py）并演示读取 /etc/hostname、执行 shell 命令、git 操作、网络请求等。指令范围与技能目的匹配，但技能赋予代理运行任意 shell 命令、读写/删除任意文件、杀进程、以 sudo 执行命令、以及发起网络请求等高权限能力——这是预期功能，但会扩大权限边界，用户需意识到这些能力的风险。

Install Mechanism

没有外部下载或不明 install spec ——技能包含所有源码文件（instruction-only + bundled code），不依赖于可疑 URL 或第三方安装脚本。publish.sh 会调用 clawhub 和 git 推送，但这是发布脚本（并非自动执行于安装时）。总体安装机制没有发现高风险远程下载操作。

Credentials

技能未声明需任何环境变量或秘密（primary credential none）。代码中有 HTTP/API 工具可以使用外部 API（可能需要 tokens 在实际使用时传入），但未自动请求或读取额外凭据。所需环境（python3, git, curl）与实现功能一致，未见不相干的凭据请求。

Persistence & Privilege

flags 中没有设置 always:true；默认允许模型自主调用（平台默认且被允许）。技能不会显式修改其他技能或系统级配置文件（在可审阅的片段中未见修改其他技能配置的行为）。

Assessment

这个技能本身在声明与实现上是一致的：它确实提供大量高权限工具（任意 Shell 执行、读写/删除文件、进程管理、sudo、网络请求、spawn 子 Agent 等）。在决定安装或启用前请考虑： - 仅在受信任或隔离的环境（容器、沙箱或非生产机器）中运行，避免在含有敏感数据或以 root 身份的主机上直接启用。 - 如果你要允许模型/代理自动调用技能，明确限制其权限（例如禁止 FS_WRITE/FS_DELETE、禁止 shell_sudo、禁止 process_kill），或只在交互式/人工批准场景下允许敏感操作。 - 审阅关键模块源码（exec_tools.py、file_tools.py、agent_tools.py、git_tools.py、web_tools.py），确认没有对未审计外部脚本的自动导入或执行（示例中 agent_tools 有指向 ~/.openclaw/... 的 AGENT_TEAMS_PATH，建议确认该路径不会被自动导入不可信代码）。 - 若需要网络/API 访问，避免在全局环境中放置长期凭据；在运行时按需提供短期 token 并监控外发流量。 - 在首次启用前，可在干净的测试环境中运行技能自带的 test/sample 脚本以观察行为。 总体建议：技能“内部一致但权限很大”，可用但需通过隔离、最小权限和人工审计降低风险。

<div align="center">

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

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

</div>

---

✨ 特性

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

---

🚀 快速开始

安装

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

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

基本用法

# 方式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	📤 代码推送

代码中调用

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_request	HTTP请求	url="http://wttr.in/Shanghai"
web_fetch	网页抓取	url="https://example.com"
web_search	网络搜索	query="Python 教程"
api_request	API调用	url="https://api.github.com"
url_parse	URL解析	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	启动子Agent	name="coder", prompt="分析代码"
agent_delegate	委托任务	agent_id="xxx", task="..."
agent_result	获取结果	task_id="xxx"
agent_list	列出Agent	-
agent_cancel	取消Agent	task_id="xxx"
coordinator	多Agent协调	task="...", phases=[...]

🎨 UI 工具 (8个)

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

🔌 MCP 工具 (6个)

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

---

📁 文件结构

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

---

<div align="center">

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

</div>