nj070574-gif/openclaw-obsidian-vault-skill

openclaw-obsidian-vault-skill은(는) 무엇을 하나요?

💎 OpenClaw 스킬 — Local REST API 플러그인을 통해 Obsidian 저장소를 완전히 제어합니다. 모든 AI 에이전트가 노트를 읽고, 쓰고, 검색하고, 추가하고, 관리할 수 있습니다. macOS 전용 CLI가 필요하지 않습니다.

기능

• 노트 읽기: 저장소의 특정 파일 내용을 가져옵니다.
• 노트 쓰기/추가: 기존 노트에 내용을 추가하거나 새 노트를 만듭니다.
• 폴더 및 파일 나열: 저장소 내의 폴더 구조와 파일을 탐색합니다.
• 검색: 제목, 태그 또는 콘텐츠 기반으로 노트를 검색합니다.
• 파일 삭제: 저장소에서 파일을 제거합니다.
• 노트 전면 교체: 기존 노트의 전체 내용을 교체합니다.
• 점수 기반 검색: 유사성 또는 관련성에 따라 노트에 점수를 매기고 검색합니다.
• 마크다운 변환: 콘텐츠를 마크다운 형식으로 변환합니다.

요구 사항

• Obsidian (최신 권장 버전)
• Obsidian Local REST API 커뮤니티 플러그인이 설치 및 활성화되어 있어야 합니다.
• Local REST API 플러그인의 API 키가 설정되어 있어야 합니다.
• 네트워크를 통한 http://localhost:27123 (기본 주소) 통신이 허용되어야 합니다.

설정

1. Obsidian에서 설정 → 커뮤니티 플러그인 → 찾아보기로 이동합니다.

2. "Local REST API"를 검색하여 설치하고 활성화합니다.

3. 플러그인 설정에서 API 키를 생성하고 복사합니다.

4. 이 스킬을 사용하는 AI 에이전트 환경에 OBSIDIAN_API_KEY 환경 변수로 해당 키를 설정합니다.

   export OBSIDIAN_API_KEY=your_generated_api_key_here
   

사용법

노트에 내용 추가하기

@openclaw append_to_note note_path="daily/2025-04-05.md" content="- [ ] 새 작업 항목"

노트 검색하기

@openclaw search query="machine learning"

파일 삭제하기

@openclaw delete_note note_path="old/temporary-note.md"

지원 플랫폼

이 스킬은 다음을 포함한 모든 AI 에이전트와 호환됩니다:

• Claude Code
• Cursor
• Codex CLI
• GitHub Copilot Chat
• 기타 Local REST API 엔드포인트에 HTTP 요청을 할 수 있는 모든 에이전트

참고 사항

• 모든 API 요청은 http://localhost:27123 (기본값)로 전송됩니다. Obsidian이 실행 중이고 Local REST API 플러그인이 올바르게 구성되어 있는지 확인하세요.
• 노트 경로는 저장소 루트를 기준으로 합니다 (예: daily/2025-04-05.md).
• 보안을 위해 API 키를 소스 코드나 설정 파일에 직접 하드코딩하지 마세요.
• 이 스킬은 macOS에서만 작동하는 다른 솔루션과 달리 크로스 플랫폼입니다.

라이선스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.