Repolode
tashfeenahmed

tashfeenahmed/scallopbot

시간이 지나며 생체에서 영감을 받은 기억을 통합하고 연결하며 잊어가는 셀프 호스팅 개인용 AI 비서로, MCP를 통해 기능을 제공하고 OpenClaw 스킬과 호환됩니다.

스타
50
포크
8
열린 이슈
0
마지막 커밋
6일 전

어떤 프로젝트인가요?

ScallopBot은 개인 서버에서 실행되는 AI 에이전트로, Telegram, 웹 대시보드, CLI 또는 Discord, Slack, WhatsApp, Signal, Matrix 같은 채널을 통해 대화할 수 있습니다. 기억은 하나의 SQLite 파일에 저장되며, BM25 키워드 검색과 임베딩, 선택적 LLM 재순위화를 함께 사용합니다. 기억은 카테고리별로 약해지고 요약으로 통합되며, 활용도가 낮은 항목은 정리 전에 소프트 아카이빙됩니다.

백그라운드 프로세스가 주기적으로 기억의 약화와 감사를 수행하고, 매일 밤 기억을 통합하고 자기 성찰을 진행하며 미완료 작업이나 다가오는 마감일을 살핍니다. 모델 호출 비용은 토큰 단위로 책정되고, 빠른·표준·고성능 티어로 라우팅됩니다. 7개 LLM 제공업체 간 장애 조치와 일일·월간 예산 한도도 지원합니다.

에이전트는 모든 MCP 서버를 사용할 수 있으며, 자체 기억도 MCP 서버로 제공해 Claude Code나 Codex 같은 클라이언트가 동일한 저장소를 읽고 쓸 수 있습니다. 스킬은 OpenClaw의 SKILL.md 형식을 사용하며, 프로젝트 README에는 다른 에이전트와의 벤치마크가 공개되어 있습니다.

핵심 기능

  • 01시간이 지나며 약해지고 통합·아카이빙되는 기억 기능으로, 기억을 불러올 때 BM25와 임베딩을 함께 사용합니다.
  • 027개 LLM 제공업체를 대상으로 비용을 고려해 라우팅하며 장애 조치와 일일·월간 예산 한도를 지원합니다.
  • 03양방향 MCP 지원: MCP 서버를 사용하고 다른 클라이언트에 기억 도구를 제공합니다.
  • 04백그라운드에서 매일 밤 기억을 통합하고 자기 성찰을 수행하며, 선제적으로 누락된 부분을 살핍니다.
  • 05OpenClaw 및 agentskills.io 스타일 스킬과 호환되며, 스킬 34개가 기본 제공됩니다.
  • 06로컬 음성 전사 및 합성 옵션을 제공하며, 앱으로 설치할 수 있는 웹 대시보드도 지원합니다.

활용 사례

  • 집의 서버나 Raspberry Pi에서 비공개 상시 실행 비서를 운영하고 Telegram으로 이용하기.
  • MCP를 통해 채팅 비서와 Claude Code 같은 코딩 도구가 하나의 지속성 있는 기억을 공유하도록 하기.
  • 예산 한도와 저렴한 모델·고성능 모델 간 라우팅으로 LLM 비용을 예측 가능하게 관리하기.
  • 단순한 메모 저장을 넘어서는 에이전트 기억 설계를 실험하기.

빠른 시작

  1. 1

    저장소를 클론합니다

    git clone https://github.com/tashfeenahmed/scallopbot.git
  2. 2

    폴더로 이동해 종속성을 설치합니다

    cd scallopbot && npm install
  3. 3

    .env.example을 .env로 복사하고 LLM 제공업체 API 키를 하나 이상 추가한 다음 빌드합니다

    npm run build
  4. 4

    봇을 시작합니다. 대시보드는 http://localhost:3000에서 실행됩니다

    node dist/cli.js start

사용 전 알아둘 점

  • Node.js 24 이상이 필요합니다.
  • 실행하려면 유료 LLM 제공업체 API 키가 하나 이상 필요합니다.
  • 아직 npm 레지스트리에 게시되지 않았으므로 클론한 저장소에서 빌드해야 합니다.

토픽

자주 묻는 질문

scallopbot은(는) 무엇인가요?
시간이 지나며 생체에서 영감을 받은 기억을 통합하고 연결하며 잊어가는 셀프 호스팅 개인용 AI 비서로, MCP를 통해 기능을 제공하고 OpenClaw 스킬과 호환됩니다. ScallopBot은 개인 서버에서 실행되는 AI 에이전트로, Telegram, 웹 대시보드, CLI 또는 Discord, Slack, WhatsApp, Signal, Matrix 같은 채널을 통해 대화할 수 있습니다. 기억은 하나의 SQLite 파일에 저장되며, BM25 키워드 검색과 임베딩, 선택적 LLM 재순위화를 함께 사용합니다. 기억은 카테고리별로 약해지고 요약으로 통합되며, 활용도가 낮은 항목은 정리 전에 소프트 아카이빙됩니다.
scallopbot은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
scallopbot은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
scallopbot은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. scallopbot의 마지막 커밋은 2026년 10월 16일입니다.
scallopbot은(는) 어디에 사용할 수 있나요?
집의 서버나 Raspberry Pi에서 비공개 상시 실행 비서를 운영하고 Telegram으로 이용하기. MCP를 통해 채팅 비서와 Claude Code 같은 코딩 도구가 하나의 지속성 있는 기억을 공유하도록 하기. 예산 한도와 저렴한 모델·고성능 모델 간 라우팅으로 LLM 비용을 예측 가능하게 관리하기. 단순한 메모 저장을 넘어서는 에이전트 기억 설계를 실험하기.
scallopbot는 어떻게 설치하나요?
저장소를 클론합니다: git clone https://github.com/tashfeenahmed/scallopbot.git 폴더로 이동해 종속성을 설치합니다: cd scallopbot && npm install .env.example을 .env로 복사하고 LLM 제공업체 API 키를 하나 이상 추가한 다음 빌드합니다: npm run build 봇을 시작합니다. 대시보드는 http://localhost:3000에서 실행됩니다: node dist/cli.js start
scallopbot은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/tashfeenahmed/scallopbot

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트