← Back to Skills Marketplace
system-file-handler
by
laiguangwei
· GitHub ↗
· v1.0.0
· MIT-0
36
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install system-file-handler
Description
通过 MCP stdio 提供文件系统操作（列出目录、读写文件、创建目录、删除与移动），由独立 go-fs-mcp-server 执行实际 IO。
README (SKILL.md)
\r \r
文件系统 MCP 技能（Go 版）\r
\r
当用户需要列出目录、读取/写入文件、创建文件夹、删除或移动文件时使用本 Skill。\r
\r
本 Skill 不直接操作文件，仅做参数校验与 MCP 转发；实际 IO 由 go-fs-mcp-server 完成。\r
\r
架构\r
\r
OpenClaw 对话\r
→ go-fs-mcp-skill（参数校验 + JSON 封装）\r
→ go-fs-mcp-server（MCP stdio，6 个文件 Tool）\r
→ 文件系统\r
```\r
\r
## 触发词\r
\r
- 列出目录\r
- 读取文件\r
- 写入文件\r
- 创建文件夹\r
- 删除文件\r
- 移动文件\r
\r
在对话中使用自然语言并带上路径即可，例如：\r
\r
```\r
列出 /mnt/e/github/go-fs-mcp 目录内容\r
```\r
\r
```\r
读取 /mnt/e/github/go-fs-mcp/README.md\r
```\r
\r
## MCP 工具映射\r
\r
| toolName | 必填 params | 说明 |\r
|----------|-------------|------|\r
| `list_directory` | `path` | 列出目录 |\r
| `read_file` | `path` | 读取 UTF-8 文本 |\r
| `write_file` | `path`, `content` | 写入/覆盖文件 |\r
| `create_directory` | `path` | 创建多级目录 |\r
| `delete_file` | `path` | 删除文件或目录 |\r
| `move_file` | `source`, `destination` | 移动/重命名 |\r
\r
## 安装依赖（二进制）\r
\r
从 [go-fs-mcp](https://github.com/go-fs-mcp/go-fs-mcp) 源码构建两个二进制，并放入本 Skill 目录或加入 PATH：\r
\r
```bash\r
git clone https://github.com/go-fs-mcp/go-fs-mcp.git\r
cd go-fs-mcp\r
go build -o go-fs-mcp-server/go-fs-mcp-server ./go-fs-mcp-server/cmd/server\r
go build -o go-fs-mcp-skill/go-fs-mcp-skill ./go-fs-mcp-skill/cmd/skill\r
```\r
\r
也可使用本目录下的 `scripts/build.sh` 或 `scripts/build.ps1`（需已 clone 完整仓库）。\r
\r
详细步骤见 [INSTALL.md](INSTALL.md)。\r
\r
## 配置 skill.json\r
\r
安装后编辑本目录下的 `skill.json`，将 `config.mcp_command` 改为 **go-fs-mcp-server 的绝对路径**：\r
\r
**WSL 示例：**\r
\r
```json\r
"config": {\r
"mcp_command": "/home/user/.openclaw/skills/go-fs-mcp-skill/go-fs-mcp-server",\r
"mcp_args": [],\r
"timeout": 10\r
}\r
```\r
\r
**Windows 示例：**\r
\r
```json\r
"config": {\r
"mcp_command": "e:\\github\\go-fs-mcp\\go-fs-mcp-server\\go-fs-mcp-server.exe",\r
"mcp_args": [],\r
"timeout": 10\r
}\r
```\r
\r
也可复制环境模板：`skill.wsl.json` 或 `skill.windows.json`。\r
\r
## CLI 调用格式\r
\r
```bash\r
go-fs-mcp-skill '{"toolName":"list_directory","params":{"path":"/path/to/dir"}}'\r
```\r
\r
成功返回：\r
\r
```json\r
{"success":true,"message":"MCP 工具 list_directory 执行成功","data":{"toolName":"list_directory","result":"..."}}\r
```\r
\r
## OpenClaw 启用\r
\r
在 `~/.openclaw/openclaw.json` 顶层添加：\r
\r
```json\r
{\r
"skills": {\r
"entries": {\r
"go-fs-mcp-skill": { "enabled": true }\r
}\r
}\r
}\r
```\r
\r
安装后执行 `openclaw gateway restart`。\r
\r
完整操作流程见仓库 [docs/OPERATIONS.md](https://github.com/go-fs-mcp/go-fs-mcp/blob/main/docs/OPERATIONS.md)。\r
Usage Guidance
Install only if you trust the publisher and will use it in a constrained workspace. Treat delete, move, and write requests as capable of changing or removing real local files; prefer a sandboxed directory, backups, and explicit confirmation before destructive actions.
Capability Assessment
Purpose & Capability
The advertised capabilities fit a filesystem skill: reading, writing, moving, deleting, and creating directories are purpose-aligned rather than inherently malicious.
Instruction Scope
The supplied scan context indicates the skill documentation and manifests expose destructive filesystem operations without clear user confirmation guidance, path limits, or rollback expectations.
Install Mechanism
No malicious installer behavior, obfuscation, package-install abuse, or deceptive install flow was provided in the available evidence.
Credentials
Full filesystem mutation authority is high impact; without documented allowed roots or exclusions for sensitive paths, the authority is broader than users can easily reason about.
Persistence & Privilege
No persistence, privilege escalation, credential capture, or background execution was evidenced, but the external MCP-backed filesystem access could still affect local data if invoked.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install system-file-handler - After installation, invoke the skill by name or use
/system-file-handler - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the skill for MCP-based file system operations via stdio.
- Supports listing directories, reading/writing files, creating directories, deleting, and moving files using natural language commands.
- Skill performs parameter validation and JSON packaging; all actual file IO is executed by go-fs-mcp-server.
- Provides command line usage and configuration examples for both WSL and Windows environments.
- Installation instructions for required binaries and setup guidance included.
Metadata
Frequently Asked Questions
What is system-file-handler?
通过 MCP stdio 提供文件系统操作（列出目录、读写文件、创建目录、删除与移动），由独立 go-fs-mcp-server 执行实际 IO。 It is an AI Agent Skill for Claude Code / OpenClaw, with 36 downloads so far.
How do I install system-file-handler?
Run "/install system-file-handler" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is system-file-handler free?
Yes, system-file-handler is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does system-file-handler support?
system-file-handler is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created system-file-handler?
It is built and maintained by laiguangwei (@lgwventrue); the current version is v1.0.0.
More Skills