https://github.com/wentorai/Research-Claw
Research-Claw 사용자 가이드
Research-Claw는 로컬 실행을 통해 연구 과정을 지원하는 인공지능 도구입니다. 문헌 관리, 학술 논문 작성, 실험 재현, 연구 추적 등 전반적인 연구 프로세스를 커버하며, 모든 데이터가 로컬에 저장됩니다. 이 가이드에서는 설치, 구성, 핵심 기능, 문제 해결과 관련된 내용을 단계별로 설명합니다.
1. 핵심 전제조건 이해
- 실행 방식: 모든 데이터가 로컬에 저장되며 클라우드로 데이터가 전송되지 않습니다.
- 외부 의존성: LLM API 키가 필요합니다 (추천은 Anthropic Claude 또는 OpenAI, 중국 중계 API도 지원).
- 플랫폼 지원: macOS, Linux, Windows (Docker 설치를 추천합니다).
- 라이센스:개인용/학술적 연구는 무료이며, 상업적 사용은 별도의허가 필요. 2030년 3월 12일 이후에는 Apache 2.0 라이센스로 오픈 소스로 전환됩니다.
2. 시스템 요구사항
| 운영 체제 | 설치 방법 추천 | 필수 의존성 | 선택적 의존성 |
|---|---|---|---|
| macOS/Linux | 단일 스크립트 설치 | Git, Node.js | 없음 |
| Windows | Docker 단일 설치 | Docker Desktop | 없음 |
| 중국 내륙 사용자 | 로컬에서 Docker 설치 | Docker Desktop | 프록시 |
주의사항: 모든 플랫폼에서 LLM API 키가 필요합니다.
3. 설치 단계
방법 1: macOS/Linux 사용자용 "단일 스크립트 설치" (가장 추천)
- 터미널을 열어 아래 명령을 붙여넣기:
curl -fsSL https://wentor.ai/install.sh | bash
- 스크립트가 자동으로 완료됩니다.
방법 2: Docker를 통한 설치 (Windows 권장)
단계 1: Docker Desktop 설치
- 공식 웹사이트에서 다운로드: https://www.docker.com/products/docker-desktop/
단계 2: Docker 설치 명령 실행
- Windows:
irm https://wentor.ai/docker-install.ps1 | iex
- macOS/Linux:
curl -fsSL https://wentor.ai/docker-install.sh | bash
방법 3: 중국 내륙 사용자용 "로컬构建 Docker"
- 아래 명령을 차례대로 실행:
git clone https://github.com/wentorai/Research-Claw.git
cd Research-Claw
docker compose up -d --build
4. 최초 구성
설치完成后 브라우저에 자동으로 연결됩니다. URL은 http://127.0.0.1:28789입니다. Setup Wizard에서만 LLM API 키를 입력하면 됩니다.
5. 핵심 기능 사용
기능 1: 문헌 관리
Zotero와의 연동을 통해 문헌 분류, 초록 작성, BibTeX导出가 자동화됩니다. 아래 명령을 사용하세요:
示例:
- 분류:
Zotero「미분류」폴더의 문헌을 주제로 분류하고 각각에 한 문장의 초록을 작성해라 - 세부 분류:
Zotero「미분류」의 문헌을 주제로 분류, 10개 이상의 동일 주제가 있는 경우 하위 그룹으로 분리
기능 2: 연구 보고서 자동 작성
예:
매주 금요일 오전 8시에 나의 주간 연구 진척을 자동으로 요약하고, 휴대폰으로 문자 보내기
기능 3: 논문 작성 지원
예:
- 초록 작성:
논문 "Multi-Agent Debate for Factual Reasoning"의 초록을 작성하라 - 특정 부분 수정:
Method론의 2.3절을 "Multi-Agent Collaboration & Consensus"로 수정하라
기능 4: 연구 추적
예:
"LLM Agent"와 "RAG" 주제의 최신 논문을 추적하고 결과를 메신저로 보내라
기능 5: 실험 재현
예:
arXiv ID인 2406.12345의 논문을 실행하고 결과를 results 폴더에 저장하라
6. 대시보드 패널 설명
| 패널 이름 | 기능 설명 |
|---|---|
| Chat | 명령 입력 및 대화가 이뤄지는 공간 |
| 도서관 | 모든 논문 관리 |
| 작업 | 연구タスク 관리 |
| 작업 공간 | 연구 파일 관리 |
| 모니터 | 연구 추적 및 타이머 설정 |
| 설정 | API 키 변경 등 설정 변경 |
7. 사용자 정의 명령
7.1 macOS/Linux용 명령
pnpm serve # 시작
pnpm health # 상태 확인
pnpm backup # 백업
pnpm test # 테스트
7.2 Docker용 명령
docker restart research-claw # 재시작
docker stop research-claw # 중지
docker ps # 상태 확인
curl http://127.0.0.1:28789/healthz # 연결 확인
8. 문제 해결
문제 1: Docker 설치 후 접속 실패
- Docker가 실행 중인지 확인
- 포트 상태 확인
- 컨테이너 재시작
문제 2: API 키 에러
- 키를 정확히 입력했는지 확인
- 대리伺服 설정 확인
9.アンinstall
방법 1: macOS/Linux용アンinstall
pkill -f "openclaw.*gateway"
rm -rf ~/research-claw
rm -rf ~/.research-claw
rm -f ~/.local/bin/openclaw
방법 2: Docker용アンinstall
docker stop research-claw && docker rm research-claw
docker rmi ghcr.io/wentorai/research-claw:latest
10. 주의사항
- 데이터 백업은定期적으로 실행
- GPU 사용을 위해 CUDA 설치를 확인
- IM 서비스 연동 설정은 대시보드에서 완료
- 사용 중 질문은 GitHub 이슈로 제출