🦞 龙虾AI · OpenClaw 智能体生态导航 龙虾AI(OpenClaw)中文资料与下载导航
📁

实战 · MCP

实战:给龙虾接文件系统 MCP Server

刚装好的龙虾,会想、会规划,却连你电脑里的一个文件都打不开——就像一颗装在玻璃罩里的大脑。给它配上文件系统 MCP Server,等于第一次递给它一双手,它才能真正去读写本地文件。这篇从零配一遍,附完整配置代码和几条必看的权限提醒,最后用一次实操让你看清它到底能做到哪一步。不懂 MCP 是什么先看这篇

这个 Server 能干嘛

文件系统 MCP Server 给龙虾开了一组“手”:列目录、读文件、写文件、移动/重命名、新建文件夹。接上它之后,“把这堆图按日期归类”“读完这 10 个 txt 总结一下”这类活,龙虾才真正动得了。

第一步:准备一个专用目录

别上来就把整个家目录交给它。先建一个专门给龙虾折腾的工作区,所有授权只放到这一个目录里。这是后面安全的地基。

# macOS / Linux
mkdir -p ~/lobster-workspace

# Windows(PowerShell)
mkdir $HOME\lobster-workspace

第二步:在配置里登记这个 Server

打开 OpenClaw 的 MCP 配置文件,加一段文件系统 Server 的声明。下面是常见写法(用 Node 生态的官方 filesystem server 举例,具体命令以你装的版本为准,别照抄版本号):

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/你的用户名/lobster-workspace"
      ]
    }
  }
}

关键就一句:args 最后那个路径,就是你允许龙虾碰的目录边界。它读不到、也写不到这个目录之外。要授权多个目录,就在后面再追加路径即可。

路径一律写绝对路径,别写 ~ 或相对路径——很多“配完没反应”的坑就出在这。Windows 下注意反斜杠要转义,或直接用正斜杠。

第三步:重启并验证

存盘后重启一次 OpenClaw,让它重新加载 Server。验证最简单的办法是直接发一句:

列一下你能访问的目录里有哪些文件

如果它能报出 lobster-workspace 里的内容,就说明接通了。报“没有可用工具”或路径报错,回去查配置文件的 JSON 格式(多半是漏逗号或多逗号)和路径是否真实存在。

权限安全,这几条别省

  • 最小授权:只放专用工作区,绝不把家目录、系统盘、云盘同步目录直接给它。
  • 关键操作留人工确认:让它批量删除/覆盖前,养成先让它列出计划、你点头再执行的习惯。智能体的判断有概率出错。
  • 重要数据先备份:第一次让它动真实文件前,先拿副本练手。
  • 别把敏感文件丢进工作区:密码、密钥、私密文档不要放在授权目录里。
🦞 上手提示 配好后可以拿一批混在一起的文件(pdf、jpg、zip、md)丢进 lobster-workspace 试一句简单指令,比如「按扩展名分到 docs / images / archives 三个子目录,目录不存在就建」。这类规整的归类任务龙虾通常做得很稳,会一步步建目录、扫描、归类、复核。值得放心的是:只授权了这一个目录的话,它读写都出不了这个边界,碰不到授权目录之外的文件——边界是真生效的。

下一步

文件系统接通后,下一个最值得加的通常是浏览器或搜索类 Server,让龙虾既能动文件又能上网。哪些 Server 值得装,看常用 MCP Server 清单;想给它装一项现成技能,看Skills 入门。整套 MCP 生态在MCP 页

常见问题

文件系统 MCP Server 会让龙虾乱删我的文件吗?
只要授权目录限定在一个专用文件夹,它就只能在那个范围读写,碰不到外面。风险来自把整盘直接放开,所以务必最小授权。
配完龙虾调不到工具怎么办?
九成是配置 JSON 格式问题或路径写错。先确认配置能正常解析,再查授权目录是否存在、是否写成绝对路径,最后重启一次。
能授权多个目录吗?
能,在 args 后面继续追加绝对路径即可,但建议越少越好,只放真正需要它碰的目录。