Select a result to preview

AI4PKM 온보딩 시나리오

AI4PKM 온보딩 시나리오

이 문서는 2025년 12월 29일 월간 옵시디안 세션에서 공유 예정인 내용입니다.

🔔 더 많은 AI4PKM 소식을 받고 싶으시면 메일링 리스트에 가입해주세요!

Goals

옵시디언 클로드 코드를 포함한 AI4PKM 환경을 고비 데스크탑을 사용해서 설치하고 몇 가지 시나리오를 테스트

Pre-Onboarding Checklist

Obsidian 설치

  1. Obsidian을 다운로드하여 설치
  2. 앱 실행 후 언어 설정 (한국어/English)

Obsidian Web Clipper 설치

  1. Obsidian Web Clipper 다운로드
  2. 브라우저 확장 프로그램으로 설치 (Chrome, Firefox, Safari, Edge 지원)
  3. 확장 프로그램 설정에서 Obsidian Vault 연결
    • Vault 선택
    • 저장 폴더 설정 (예: Ingest/Clippings)
    • 템플릿 설정 (선택사항)

Claude Pro/Max 계정 만들기

AI4PKM은 CLI 에이전트를 필요로 합니다. 이 중 에이전트 스킬이나 Voice Mode 사용을 위해서 클로드 코드를 (Pro 이상) 권합니다. 클로드 홈페이지에서 계정을 만드실 수 있습니다.

Onboarding Process

Gobi Desktop 설치

Gobi Desktop은 AI4PKM의 GUI 클라이언트입니다. 터미널 없이 모든 설정과 관리를 시각적으로 수행할 수 있습니다.

→ 상세 기능: (2) Gobi Desktop 가이드

다운로드 (Dev Version 2.1.5 기준):
https://drive.google.com/drive/folders/1QiymsmeSS2dxR4qwI2sm5KXoltBeWlU5

설치 후 앱을 실행하면 좌측에 Vault 목록이 표시됩니다.

새 Vault 생성

Gobi Desktop 화면 왼쪽에 플러스 버튼을 누르시면 새 볼트를 생성하실 수 있습니다. AI4PKM 템플릿을 선택하면 다음이 포함된 Vault가 생성됩니다:

onboarding-01-create-vault.png|600

옵시디언에서 볼트 확인

이제 Obsidian에서 Open Folder as Vault 메뉴를 사용해서 방금 생성한 볼트를 열어봅시다.

템플릿에서 생성된 폴더 구조를 Obsidian에서 확인할 수 있습니다.
onboarding-02-obsidian-vault.png|600

클로드 코드 로긴

Orchestrator를 사용하기 위해 클로드 코드 로그인이 필요합니다. Orchestrator에서는 클로드 코드 이외의 다른 에이전트도 사용하실 수 있습니다.

VAULT > claude setup-token

onboarding-03-claude-login.png|600

클로드 코드 실행 & 스킬 설치

Terminal> claude
Claude> Install skills from https://github.com/jykim/claude-obsidian-skills

스킬은 Claude Code의 기능을 확장하는 모듈입니다. AI4PKM 스킬을 설치하면 온보딩 도우미, 태스크 관리 등의 기능을 사용할 수 있습니다.

→ 스킬 상세: (3) Agent Skill 가이드

onboarding-04-skill-install.png|600

오케스트레이터 설정 확인

이제 Orchestrator의 설정 파일(orchestrator.yaml)을 확인해 봅시다.

설정에서 EIC (Enrich Ingested Content) 프롬프트가 클리핑을 처리하도록 설정된 것을 보실 수 있습니다. 이 Agent는 Ingest/Clippings 폴더에 새 파일이 추가되면 자동으로 요약을 생성합니다.

→ 설정 상세: (4) Orchestrator 설정

onboarding-05-orchestrator-1.png|600
onboarding-05-orchestrator-2.png|600

Web Clipping 및 처리 확인

이제 Obsidian Web Clipper를 사용해서 클리핑을 수행합니다.
onboarding-06-web-clipper-usage.png|600

자동 처리 흐름:

  1. Web Clipper로 웹 페이지 클리핑 → Ingest/Clippings/에 저장
  2. Orchestrator가 새 파일 감지 → EIC Agent 자동 실행
  3. AI가 요약 생성 → AI/Articles/에 결과 저장

아래와 같이 방금 클리핑에 대한 서머리가 생성된 것을 확인할 수 있습니다.
onboarding-06-web-clipping-1.png|600

onboarding-06-web-clipping-2.png|600

onboarding-06-web-clipping-result.png|600

Daily Roundup 추가

이제 Claude를 통해 GDR (Generate Daily Roundup) 프롬프트를 Orchestrator에 추가해 보겠습니다.

Claude> Run GDR prompt at 3am every day (using ai4pkm)

GDR 프롬프트는 매일 아침 전날의 활동을 요약한 Daily Roundup 리포트를 자동으로 생성합니다. 새로 추가된 클리핑, 작성한 저널, 캘린더 일정 등을 종합하여 하루를 시작할 때 유용한 브리핑을 제공합니다.

GDR Worker가 추가된 결과:
onboarding-07-daily-roundup-1.png|600

onboarding-07-daily-roundup-2.png|600

Voice Mode

Gobi Desktop의 음성 모드를 사용하면 타이핑 없이 AI와 대화할 수 있습니다. 질문하기, 작업 요청하기, 저널 작성하기 등을 음성으로 수행할 수 있습니다.

onboarding-08-voice-mode.png|500

Chat Config (Chat History 제목 옆):
onboarding-08-voice-chat-config.png|400

Global Config (Gobi Desktop 설정에서 한국어 음성 사용):
onboarding-08-voice-global-config.png|400

Voice Mode 실행 화면:
voicde-mode.png|600

활용 팁:

다음 단계

온보딩 과정을 완료했습니다! 🎉 이제 다음 단계로 나아가보세요:

즉시 활용

심화 학습

트러블슈팅

일반적인 문제

문제 해결 방법
클로드 코드 로그인 실패 claude setup-token 재실행, API 키 확인
스킬 설치 안 됨 인터넷 연결 확인, GitHub 접근 가능 여부 확인
Orchestrator 미작동 Gobi Desktop → Logs 탭에서 에러 확인
클리핑 자동 처리 안 됨 Web Clipper 저장 경로가 Ingest/Clippings/인지 확인

추가 도움