本地文件管理器技能

此技能提供在会话 cwd（当前工作目录）内的安全文件 I/O 操作。适用于需要将输出本地保存（不进行云端同步）的角色。

功能

• 读取文件：获取文本文件的内容
• 写入文件：创建或覆盖文件
• 追加内容：向已有文件添加内容
• 列出文件：支持过滤的目录列表
• 删除文件：移除文件（带安全检查）
• 复制/移动：简单的文件操作

使用场景

角色需要：

• 将生成的代码或分析结果保存到磁盘
• 读取输入文档（如 PDF、文本等）
• 追加日志或结果
• 以 Markdown/JSON/CSV 格式创建输出文件

使用方法

# 读取文件
file-manager --action read --path output.md

# 写入内容（从标准输入或使用 --content 参数）
file-manager --action write --path result.json --content '{"status":"done"}'

# 向文件追加内容
file-manager --action append --path log.txt --content "Job completed at $(date)"

# 列出目录中的文件
file-manager --action list --dir . --pattern "*.md"

# 创建目录
file-manager --action mkdir --dir reports

# 删除文件（需确认）
file-manager --action delete --path old_file.txt

安全机制

• 沙箱限制于 cwd：无法访问会话工作目录以外的文件
• 受保护文件：无法删除以 . 开头的文件，或位于 ../ 路径下的文件
• 大小限制：单个文件最大 10MB（可配置）
• 预演模式支持：使用 --dry-run 可查看操作将产生什么效果

与角色集成

在角色配置中启用此技能：

plugins:
  allow:
    - local-file-manager
    - doc-parser

然后在角色的系统提示中引导使用方式：

完成分析后，请将结果写入文件：
  file-manager --action write --path summary.md --content "$YOUR_MARKDOWN"

示例

研究人员保存分析结果：

file-manager --action write --path analysis_$(date +%Y%m%d).md \
  --content "# Analysis\n\n## Summary\n..."

开发者保存代码：

file-manager --action write --path src/main.py --content "$CODE"

自动化任务追加日志：

file-manager --action append --path /var/log/automation.log \
  --content "[$(date)] Task completed\n"

错误处理

• 若读取文件时文件不存在：返回错误码 1
• 若路径超出 cwd 范围：拒绝访问
• 若写入失败（权限不足）：返回错误
• 所有错误均记录至 ~/.openclaw/logs/file-manager.log

配置项

环境变量：

• FILE_MANAGER_MAX_SIZE：最大文件大小（字节），默认值为 10485760
• FILE_MANAGER_LOG：操作日志路径，默认值为 ~/.openclaw/logs/file-manager.log
• FILE_MANAGER_DRY_RUN：设为 "1" 时仅模拟操作，不实际执行