← 返回 Skills 市场

system-file-handler

Name: system-file-handler
Author: lgwventrue

作者 laiguangwei · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

总下载

当前安装

版本数

在 OpenClaw 中安装

/install system-file-handler

功能描述

通过 MCP stdio 提供文件系统操作（列出目录、读写文件、创建目录、删除与移动），由独立 go-fs-mcp-server 执行实际 IO。

使用说明 (SKILL.md)

\r \r

文件系统 MCP 技能（Go 版）\r

\r 当用户需要列出目录、读取/写入文件、创建文件夹、删除或移动文件时使用本 Skill。\r \r 本 Skill 不直接操作文件，仅做参数校验与 MCP 转发；实际 IO 由 go-fs-mcp-server 完成。\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

安全使用建议

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.

能力评估

ℹ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install system-file-handler
安装完成后，直接呼叫该 Skill 的名称或使用 /system-file-handler 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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.

元数据

Slug system-file-handler

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题