📁
Filesystem
파일 관리 개발 도구설치 명령어
npx clawhub@latest install filesystem
설치 안내
1
환경 확인
Node.js 22 이상과 OpenClaw가 설치되어 있는지 확인하세요. 터미널에서 openclaw --version을 실행하여 확인할 수 있습니다.
2
설치 실행
위의 설치 명령어를 터미널에서 실행하세요. ClawHub가 자동으로 Filesystem을(를) ~/.openclaw/skills/ 디렉토리에 다운로드하고 설치합니다.
3
설치 확인
openclaw skills list를 실행하여 설치된 스킬 목록을 확인하고, Filesystem이(가) 목록에 표시되는지 확인하세요.
4
매개변수 설정 (선택사항)
아래 소개의 설정 안내에 따라 ~/.config/openclaw/openclaw.json5에 스킬 설정 항목을 추가하세요.
수동 설치 방법: Skill 폴더를
~/.openclaw/skills/ 또는 프로젝트의 skills/ 디렉토리에 복사하세요. 폴더에 SKILL.md 파일이 포함되어 있어야 합니다.
파일 및 디렉터리 CRUD 작업
설정 가능한 경로 접근 화이트리스트
안전한 샌드박스 파일 접근
상세 소개
Filesystem MCP Server는 Anthropic이 공식 제공하는 파일 시스템 조작 서버로, AI가 안전한 샌드박스 환경에서 파일 작업을 수행할 수 있게 해줍니다.
핵심 기능
- 파일 작업: 파일 읽기, 쓰기, 생성, 삭제 및 이동을 지원하며, 텍스트 및 바이너리 파일 모두 처리 가능
- 디렉터리 관리: 디렉터리 생성, 디렉터리 내용 목록 조회, 파일 재귀 검색
- 접근 제어: 화이트리스트 메커니즘으로 AI가 접근 가능한 디렉터리 경로를 제한하여 무단 접근 방지
설정 방법
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
// 아래는 접근 허용 디렉터리 경로
"/Users/username/projects",
"/Users/username/documents"
]
}
}
}
사용 시나리오
- AI가 안전하게 프로젝트 파일을 읽어 코드 분석 수행
- 프로젝트 파일 구조 자동 생성 및 정리
- 파일 일괄 이름 변경 또는 이동
- 제한된 디렉터리 범위 내에서 파일 검색 및 내용 교체