实战 · 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后面继续追加绝对路径即可,但建议越少越好,只放真正需要它碰的目录。