← Back to Skills Marketplace
asclaude-grep
by
Sherman Schulist
· GitHub ↗
· v1.0.0
· MIT-0
79
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install asclaude-grep
Description
asclaude-grep enables fast, case-insensitive, regex-supported content and filename search across multiple file types within local workspaces without external...
README (SKILL.md)
asclaude-grep: 工作区全维智能搜索引擎 🔍📂
在海量代码与文档中，实现毫秒级的精准定位。
🌟 核心亮点
asclaude-grep 是专为开发者和工作区管理设计的智能检索工具。它打破了传统文件查找的局限，将 内容级检索 (Grep) 与 文件名查找 (Glob) 完美融合，让您在复杂的 OpenClaw 工作区中如虎添翼。
🚀 功能详解
- 深度内容扫描 (Deep Content Scan):
- 支持跨文件类型搜索（
.py,.md,.ts,.js,.json等）。 - 默认开启忽略大小写模式，配合正则表达式支持，即使是模糊记忆也能精准命中。
- 支持跨文件类型搜索（
- 极速文件名定位 (Glob Finder):
- 利用系统原生的
find命令索引，在毫秒间锁定目标文件路径。 - 支持通配符模式，快速理清项目目录结构。
- 利用系统原生的
- 智能格式化输出:
- 自动截断过长的搜索结果，优先显示最相关的 20 条匹配项。
- 清晰的行号定位，让您直接跳转到代码关键行。
- 本地化执行:
- 无需配置复杂的索引服务器，无需上传数据，所有搜索在本地沙箱中安全完成。
🛠️ 使用指南
- 搜索关键词:
python scripts/workspace_search.py grep "关键词" - 查找文件名:
python scripts/workspace_search.py find "*.txt"
由 黑米 (HeiMi) 为您打造的“第二大脑”检索外挂，让每一次寻找都变得简单高效。 🌾
Usage Guidance
This skill is small and its code is readable, but note two practical issues before installing: (1) the script calls the system 'grep' and 'find' binaries — ensure your environment provides them (it will not work on plain Windows without a Unix-like shell), and the package metadata should declare these as required; (2) it searches and prints content from ~/.openclaw/workspace — verify that this path points to the data you expect (watch for symlinks or sensitive files). If you accept those constraints, the tool appears to do what it claims. If you require stronger guarantees, request the author to add explicit required-binaries and OS metadata and/or allow configuring the workspace path rather than using a hardcoded location.
Capability Analysis
Type: OpenClaw Skill
Name: asclaude-grep
Version: 1.0.0
The skill provides workspace search functionality via `scripts/workspace_search.py`, but it contains a vulnerability due to a lack of input sanitization. The script passes user-supplied patterns directly to `grep` and `find` commands without using the `--` separator, which allows for potential argument injection (e.g., using `-f` to read patterns from arbitrary files). While the behavior is aligned with the stated purpose in `SKILL.md` and lacks clear malicious intent, the presence of this command-line vulnerability warrants a suspicious classification.
Capability Assessment
Purpose & Capability
The skill's name and description match the included Python tool which uses grep and find to search ~/.openclaw/workspace. However the registry metadata claims no required binaries and no OS restriction while the code depends on Unix utilities (grep, find). That mismatch (missing required-binaries and missing OS restriction) is incoherent.
Instruction Scope
SKILL.md instructs running the included script to search the OpenClaw workspace and the script confines activity to the expanded path (~/.openclaw/workspace). The runtime instructions do not request unrelated files, external endpoints, or extra credentials.
Install Mechanism
There is no install spec (instruction-only plus a small script). No remote downloads or archive extraction are involved, so installation risk is low.
Credentials
The skill does not request environment variables or credentials. The script only reads a hardcoded workspace path and does not access secrets or config files.
Persistence & Privilege
always:false and normal invocation model. The skill does not modify other skills or system configuration and does not request persistent privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install asclaude-grep - After installation, invoke the skill by name or use
/asclaude-grep - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
**文件名**: `file-search-tools-1.0.0.tar.gz` (6.4KB)
**简介**:
智能文件搜索工具，提供 GrepTool（内容搜索）和 GlobTool（路径匹配）两大功能。支持正则表达式、上下文行、通配符匹配、JSON 输出，速度快、零成本、精准搜索。
**核心功能**:
**GrepTool** - 文件内容搜索:
- ✅ 支持正则表达式
- ✅ 显示上下文行（前后 N 行）
- ✅ 多文件并行搜索
- ✅ JSON 格式输出
- ✅ 最大结果数限制
**GlobTool** - 文件路径匹配:
- ✅ 支持通配符 `*`, `**`, `?`
- ✅ 按文件类型过滤（file/dir/all）
- ✅ 显示文件大小统计
- ✅ 递归搜索支持
- ✅ JSON 格式输出
**适用场景**:
- 代码审查：查找特定函数、变量
- 错误排查：搜索错误信息、日志
- 重构辅助：查找所有使用某函数的地方
- 文件定位：快速找到特定类型文件
- 项目分析：统计文件类型、大小
**安装方式**:
```bash
openclaw skills install file-search-tools
```
**文件结构**:
```
file-search-tools-1.0.0/
├── SKILL.md # 主文档（详细使用说明）
├── README.md # 快速入门
├── scripts/
│ ├── grep-tool.py # GrepTool 核心脚本
│ └── glob-tool.py # GlobTool 核心脚本
└── docs/ # 高级用法文档（可选）
```
**性能对比**:
| 工具 | 速度 | 成本 | 灵活性 | 易用性 |
|------|------|------|--------|--------|
| GrepTool | ⚡⚡⚡ | $0 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| GlobTool | ⚡⚡⚡ | $0 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| LLM 搜索 | ⚡ | $0.5-2 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
---
Metadata
Frequently Asked Questions
What is asclaude-grep?
asclaude-grep enables fast, case-insensitive, regex-supported content and filename search across multiple file types within local workspaces without external... It is an AI Agent Skill for Claude Code / OpenClaw, with 79 downloads so far.
How do I install asclaude-grep?
Run "/install asclaude-grep" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is asclaude-grep free?
Yes, asclaude-grep is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does asclaude-grep support?
asclaude-grep is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created asclaude-grep?
It is built and maintained by Sherman Schulist (@miaoxingjun); the current version is v1.0.0.
More Skills