whiteguo233/OpenBiliClaw

OpenBiliClaw – 개인 AI 추천 에이전트

무엇인가요

• Bilibili, Xiaohongshu, TikTok, YouTube, X/Twitter, Zhihu, Reddit, Linux.do, Bangumi, V2EX, Weibo, GitHub 및 오픈 웹 등 다양한 콘텐츠 플랫폼에서의 상호작용을 기반으로 심리적 프로필을 생성하는 오픈소스이며 로컬에서 실행되는 AI 에이전트입니다.
• 이 프로필을 바탕으로, 당신이 본 적 없는 콘텐츠조차도 적극적으로 검색하여 당신이 좋아할 만한 항목을 찾아냅니다.
• 모든 데이터(행동 로그, 프로필, 추천, 채팅 기록)는 SQLite 데이터베이스에 당신의 기기 내부에만 저장되며, 클라우드 서비스가 당신의 선호를 수집하지 않습니다.

주요 구성 요소

구성 요소	역할
브라우저 확장 프로그램	지원되는 사이트에 사이드바를 삽입하고, 브라우징/세션 쿠키를 읽어내며, 피드백(좋아요/싫어요, 나중에 보기, 채팅)을 수집하여 백엔드로 전달합니다. Chrome 기반 브라우저, Edge, Brave, Vivaldi, Opera 및 Safari(서명된 DMG를 통해)에서 작동합니다.
백엔드 서버	Go/Python으로 작성되었으며 http://127.0.0.1:8420에서 실행됩니다. 데이터를 저장하고, LLM 기반 추론을 수행하며, 임베딩을 생성(기본값 bge-m3)하고 웹 UI를 제공합니다. 두 가지 설치 옵션: 첫 실행 시 임베딩 모델을 다운로드하는 경량 패키지 또는 완전 오프라인 사용을 위한 모델을 포함한 "-with-embedding" 번들(~1GB).
웹 UI(데스크톱 및 모바일)	/web(대화면용) 또는 /m/(모바일 최적화)에서 접근 가능합니다. 추천 카드를 표시하고, 각 항목이 왜 추천되었는지 설명하며, 당신의 "영혼 초상"(MBTI, 핵심 특성, 깊은 욕구)을 시각화하고, 에이전트와 대화하여 이해를 더욱 정교하게 조정할 수 있습니다.
Flutter 모바일 클라이언트 (별도 리포지토리)	동일한 로컬 백엔드에 연결하는 네이티브 Android/iOS/Web/Desktop 앱으로, 브라우저 없이도 동일한 UI를 제공합니다.
DeepSeek Harness(DSH) 플러그인	선택적 통합으로, OpenBiliClaw를 DeepSeek Harness UI 내부에 통합하여 22개의 "에이전트 브리지" 도구를 노출시켜 크로스플랫폼 콘텐츠 탐색을 가능하게 합니다.

작동 방식(개요)

1. 신호 수집 – 확장 프로그램이 선택한 플랫폼에서의 활동을 모니터링하고, 명시적 피드백(좋아요, 관심 없음, 채팅 메시지)을 기록합니다.
2. 프로필 구축 – LLM 프롬프트 체인을 통해 원시 신호를 5단계의 "심리적 초상"(사건 → 선호 → 인식 → 통찰 → 영혼)으로 변환합니다. 또한 MBTI, 인지 스타일, 깊은 동기까지 추정합니다.
3. 크로스플랫폼 검색 – 초상 정보를 기반으로 지원되는 플랫폼의 API(또는 공개 페이지 스크래핑)를 쿼리하여, 다른 사용자가 밟지 않은 경로라도 추정된 관심사와 일치하는 콘텐츠를 찾습니다.
4. 추천 및 설명 – 결과를 순위 매기고 bge-m3로 임베딩한 후, 자연어 설명과 함께 제시합니다("당신이 실습적인 기계 설계를 좋아하므로, 이 시계 제작 영상이 마음에 들 수 있습니다").
5. 지속적 학습 – 모든 상호작용이 초상 정보를 업데이트하므로, 시스템은 점차 더 개인화됩니다.

왜 중요한가

• 개인정보 최우선: 서버에 당신의 데이터가 저장되지 않으며, LLM API 키(OpenAI, Claude 등)는 당신이 직접 관리할 수 있습니다. 또는 로컬 LLM을 실행할 수도 있습니다.
• 필터 버블 깨기: 플랫폼 중심의 협업 필터링에 의존하지 않고, 당신에 대한 더 깊은 모델을 기반으로 새로운 제안을 생성합니다.
• 크로스플랫폼 통합: 관심사가 각 서비스에 고립되지 않습니다. 에이전트가 수십 개의 사이트에서 신호를 통합합니다.

시작하기(빠른 시작)

1. Chrome 웹 스토어에서 브라우저 확장 프로그램을 설치하거나(또는 최신 GitHub 릴리스의 zip 파일을 다운로드).
2. 동일한 릴리스 페이지에서 적절한 데스크톱 설치 프로그램(.dmg for macOS, .exe for Windows)을 다운로드합니다. 완전 오프라인 사용을 원한다면 "-with-embedding" 번들을 선택하세요.
3. 확장 프로그램을 통해 적어도 하나의 지원되는 플랫폼(Bilibili가 기본값)에 로그인합니다.
4. http://127.0.0.1:8420/web을 열거나(또는 모바일 보기용 QR 코드를 스캔) 추천 목록, 프로필, 채팅 상자를 확인합니다.

고급 옵션

• Tailnet(Tailscale) 원격 접근 – 내장 도우미를 활성화하여 개인 Tailnet에 참여하면, 시스템 전체 Tailscale 설치 없이도 스마트폰 앱이 인터넷을 통해 백엔드에 접근할 수 있습니다.
• Docker / HTTPS 배포 – Caddy를 포함한 docker-compose.https.yml 템플릿을 사용해 사용자 정의 도메인 뒤에서 API를 안전하게 노출할 수 있습니다.
• 사용자 정의 LLM / 임베딩 – config.toml을 편집하여 기본 LLM을 교체할 수 있으며, bge-m3 임베딩 모델도 교체 가능합니다.
• DSH 통합 – dsh-openbiliclaw 플러그인을 설치하여 에이전트를 DeepSeek Harness 내부에 통합하고, 다른 에이전트가 도구를 사용할 수 있도록 노출합니다.

커뮤니티 및 지원

• 사용자 도움과 기능 논의를 위한 QQ 그룹 및 Discord 서버 링크 제공.
• 프로젝트는 CI 빌드를 유지하고 GitHub, Gitee 미러, 123 Pan의 중국어 중심 다운로드 미러에서 릴리스합니다.

---

결론: OpenBiliClaw는 당신의 기기에서 완전히 실행되며, 개인정보를 보호하고 중국어 및 국제 플랫폼에서 다양한 콘텐츠를 가져오는 진정한 AI 기반 추천 시스템입니다. 세밀한 개인 모델을 구축하며, 개인 AI 에이전트와 크로스플랫폼 추천 기술의 최전선에 위치하고 있습니다.