github : https://github.com/moltbot/moltbot?tab=readme-ov-file

정말 핫한 오픈소스입니다. 컴퓨터를 개인 비서로 만들 수 있는데요. 개발자가 말한것처럼 아직 시작 단계라 보안과 관련된 부분이 아직 미흡합니다. 그러니, 사용중인 컴퓨터에 설치했다간 여러분의 컴퓨터의 모든 정보를 해커가 가져갈 수 있습니다.

그러니 사용하려면 꼭 새로운 컴퓨터에서 사용해야합니다. 몰트봇에 대한 다양한 사용방법이 유튜브를 아주 그냥 뜨겁게 달구고 있습니다.

몰트봇에 대해 알아보겠습니다!!

🦞 Moltbot — 개인용 AI 비서

탈피! 탈피! (EXFOLIATE! EXFOLIATE!)

Moltbot은 사용자의 기기에서 직접 구동하는 개인용 AI 비서입니다.
이미 사용 중인 다양한 채널(WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, Microsoft Teams, WebChat)은 물론 BlueBubbles, Matrix, Zalo, Zalo Personal 같은 확장 채널을 통해 답변을 제공합니다. macOS, iOS, Android 기기에서 음성으로 대화할 수 있으며, 사용자가 제어하는 라이브 캔버스(Canvas)를 렌더링할 수도 있습니다. 게이트웨이(Gateway)는 컨트롤 플레인(제어부) 역할을 할 뿐, 제품의 본질은 바로 여러분의 비서입니다.

로컬에서 구동되어 빠르고, 항상 켜져 있으며, 나만을 위해 존재하는 비서를 원하신다면 바로 이 프로젝트가 정답입니다.

웹사이트 · 문서 · 시작하기 · 업데이트 · 쇼케이스 · FAQ · 위저드(설치 마법사) · Nix · Docker · Discord

권장 설정: 온보딩 위저드(moltbot onboard)를 실행하세요. 게이트웨이, 워크스페이스, 채널 및 스킬 설정을 차근차근 안내합니다. CLI 위저드는 가장 권장되는 설치 경로이며 **macOS, Linux, Windows(WSL2 경유; 강력 권장)**에서 작동합니다. npm, pnpm, bun 모두 지원합니다.
처음 설치하시나요? 여기서 시작하세요: 시작하기

지원 서비스 (OAuth):

Anthropic (Claude Pro/Max)
OpenAI (ChatGPT/Codex)

모델 관련 참고: 모든 모델을 지원하지만, 긴 문맥 처리 능력과 강력한 프롬프트 인젝션 방어력을 갖춘 Anthropic Pro/Max (100/200) + Opus 4.5 조합을 강력히 권장합니다. 자세한 내용은 온보딩 문서를 참고하세요.

모델 (선택 및 인증)

모델 설정 및 CLI: 모델 가이드
인증 프로필 교체(OAuth vs API 키) 및 장애 조치(Fallback): 모델 페일오버

설치 (권장 방식)

실행 환경: Node ≥22.

npm install -g moltbot@latest
# 또는: pnpm add -g moltbot@latest

moltbot onboard --install-daemon

설치 마법사가 게이트웨이 데몬(launchd/systemd 사용자 서비스)을 설치하여 프로그램이 항상 백그라운드에서 실행되도록 유지합니다.
참고: 하위 호환성을 위해 clawdbot 명령어 상용구도 계속 사용할 수 있습니다.

빠른 시작 (요약)

실행 환경: Node ≥22.

초보자를 위한 전체 가이드(인증, 페어링, 채널): 시작하기

# 데몬 설치 및 온보딩 실행
moltbot onboard --install-daemon

# 게이트웨이 실행
moltbot gateway --port 18789 --verbose

# 메시지 보내기
moltbot message send --to +1234567890 --message "Moltbot에서 보낸 메시지입니다."

# 에이전트와 대화하기 (연결된 모든 채널로 답변 전달 가능)
moltbot agent --message "배송 체크리스트 보여줘" --thinking high

업그레이드 방법: 업데이트 가이드를 확인하고 moltbot doctor를 실행하세요.

개발 채널

stable: 태그된 정식 릴리스 (vYYYY.M.D), npm 배포 태그 latest.
beta: 사전 출시 태그 (vYYYY.M.D-beta.N), npm 배포 태그 beta. (macOS 앱이 누락될 수 있음)
dev: main 브랜치의 최신 상태, npm 배포 태그 dev.

채널 전환 (git + npm): moltbot update --channel stable|beta|dev.
상세 내용: 개발 채널 가이드.

소스 코드 설치 (개발용)

소스 빌드 시 pnpm 사용을 권장합니다. TypeScript를 직접 실행하려면 Bun을 선택적으로 사용할 수 있습니다.

git clone https://github.com/moltbot/moltbot.git
cd moltbot

pnpm install
pnpm ui:build # 첫 실행 시 UI 의존성 자동 설치
pnpm build

pnpm moltbot onboard --install-daemon

# 개발 루프 (TS 변경 시 자동 재시작)
pnpm gateway:watch

참고: pnpm moltbot ...은 tsx를 통해 TypeScript를 직접 실행합니다. pnpm build는 Node나 패키징된 바이너리로 실행하기 위한 dist/ 결과물을 생성합니다.

보안 기본 설정 (DM 접근)

Moltbot은 실제 메시징 플랫폼에 연결됩니다. 외부에서 오는 DM은 **"신뢰할 수 없는 입력"**으로 간주하십시오.

전체 보안 가이드: 보안 정책

주요 채널(Telegram/WhatsApp/Signal 등)의 기본 동작:

DM 페어링 (dmPolicy="pairing"): 알 수 없는 발신자에게는 짧은 페어링 코드를 보내며, 코드가 확인되기 전까지는 메시지를 처리하지 않습니다.
승인 방법: moltbot pairing approve <channel> <code>를 실행하면 해당 발신자가 로컬 허용 목록(Allowlist)에 추가됩니다.
공개 DM 허용: 모든 DM을 처리하려면 dmPolicy="open"으로 설정하고 채널 허용 목록에 "*"를 포함해야 합니다.

moltbot doctor를 실행하여 위험하거나 잘못 설정된 DM 정책이 있는지 확인하세요.

주요 특징

로컬 우선 게이트웨이 — 세션, 채널, 도구 및 이벤트를 위한 단일 제어 지점.
멀티 채널 인박스 — 주요 메시징 앱 및 macOS/iOS/Android 지원.
멀티 에이전트 라우팅 — 수신 채널/계정을 개별 에이전트(워크스페이스 + 세션별 분리)로 전달.
**음성 호출(Voice Wake) + 대화 모드(Talk Mode)** — ElevenLabs를 사용한 상시 음성 대화 지원.
라이브 캔버스(Live Canvas) — A2UI를 활용한 에이전트 주도 시각적 작업 공간.
강력한 기본 도구 — 브라우저 제어, 캔버스, 노드 제어, 크론(Cron) 작업 등.
컴패니언 앱 — macOS 메뉴바 앱 및 모바일용 노드 앱.
**온보딩 위저드 + 스킬 시스템** — 마법사를 통한 간편한 설정 및 관리형 스킬 확장.

스타 히스토리 (Star History)

현재까지 구현된 기능들

핵심 플랫폼

세션, 상태 관리, 크론, 웹훅, 제어 UI, 캔버스 호스트를 포함한 게이트웨이 WS 컨트롤 플레인.
게이트웨이 관리, 에이전트 대화, 메시지 전송, 진단(Doctor) 기능의 CLI 인터페이스.
도구 스트리밍 및 블록 스트리밍을 지원하는 RPC 모드의 Pi 에이전트 런타임.
직접 채팅, 그룹 격리, 활성화 모드 등을 포함한 세션 모델.
이미지/오디오/비디오 처리, 텍스트 변환 훅, 파일 생명주기 관리를 포함한 미디어 파이프라인.

지원 채널

다양한 채널 지원: WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, BlueBubbles, Microsoft Teams, Matrix, Zalo, Zalo Personal, WebChat.
그룹 라우팅: 멘션 필터링, 답장 태그, 채널별 메시지 분할 전송.

앱 및 노드 (Nodes)

macOS 앱: 게이트웨이 제어, 음성 호출/PTT, 대화 모드 오버레이, 디버그 도구.
iOS 노드: 캔버스 시각화, 음성 호출, 카메라/화면 녹화 연동.
Android 노드: 캔버스, 대화 모드, 카메라, SMS 연동(선택 사항).
macOS 노드 모드: 시스템 명령어 실행(system.run), 알림 전송, 캔버스 노출.

도구 및 자동화

브라우저 제어: 전용 크롬/크로뮴 제어, 스냅샷, 프로필 관리.
캔버스: A2UI 기반 시각적 작업 공간 푸시 및 리셋.
노드 제어: 카메라 샷, 화면 녹화, 위치 정보 조회, 알림.
자동화: 크론 작업, 웹훅, Gmail Pub/Sub 알림.
스킬 플랫폼: 내장/관리형 스킬 및 설치 UI.

작동 원리 (요약)

다양한 메시징 채널 (WhatsApp, Telegram, Slack 등)
               │
               ▼
┌───────────────────────────────┐
│           게이트웨이           │
│       (컨트롤 플레인)         │
│     ws://127.0.0.1:18789      │
└──────────────┬────────────────┘
               │
               ├─ Pi 에이전트 (RPC)
               ├─ CLI (moltbot …)
               ├─ WebChat UI (웹 채팅)
               ├─ macOS 앱
               └─ iOS / Android 노드

주요 하위 시스템

게이트웨이 WebSocket 네트워크 — 클라이언트, 도구, 이벤트를 연결하는 단일 WS 제어부.
Tailscale 연동 — 게이트웨이 대시보드 및 WS에 대한 원격 접근 지원.
브라우저 제어 — CDP 제어를 통한 전용 브라우저 자동화.
음성 호출 및 대화 모드 — 상시 대기 중인 음성 인식 및 연속 대화 기능.

Tailscale 접근 (게이트웨이 대시보드)

Moltbot은 게이트웨이가 루프백에 바인딩된 상태에서 Tailscale Serve(비공개) 또는 Funnel(공개)을 자동 설정할 수 있습니다. gateway.tailscale.mode 설정값:

off: 자동화 비활성화 (기본값).
serve: Tailscale 네트워크 내에서만 HTTPS 접근 허용.
funnel: 외부 인터넷에서 HTTPS 접근 허용 (비밀번호 인증 필수).

원격 게이트웨이 (Linux 활용)

게이트웨이를 사양이 낮은 Linux 인스턴스에서 실행해도 전혀 문제없습니다. macOS 앱, CLI, WebChat 클라이언트는 Tailscale이나 SSH 터널을 통해 연결할 수 있으며, 기기 노드(macOS/iOS/Android)를 페어링하여 필요한 경우 로컬 액션을 실행할 수 있습니다.

게이트웨이 호스트: 기본적으로 실행 도구 및 채널 연결을 담당합니다.
기기 노드: system.run, 카메라, 화면 녹화 등 기기 고유의 액션을 node.invoke를 통해 실행합니다.

채팅 명령어

WhatsApp, Telegram, Slack 등의 채널에서 다음 명령어를 사용할 수 있습니다 (그룹 명령어는 소유자 전용):

/status — 세션 상태 요약 (모델, 토큰 사용량, 비용 등)
/new 또는 /reset — 세션 초기화
/compact — 세션 문맥 압축 (요약)
/think <level> — 사고 수준 설정 (off | minimal | low | medium | high | xhigh)
/verbose on|off — 상세 로그 출력 설정
/usage off|tokens|full — 응답별 사용량 표시 설정
/restart — 게이트웨이 재시작 (그룹 내 소유자 전용)
/activation mention|always — 그룹 내 활성화 모드 전환

설정 예시

최소한의 ~/.clawdbot/moltbot.json 설정 (모델 및 기본값):

{
  "agent": {
    "model": "anthropic/claude-opus-4-5"
  }
}

전체 설정 참조 가이드 (모든 키 및 예시)

보안 모델 (중요)

기본값: main 세션의 도구는 호스트에서 실행되므로 에이전트가 모든 권한을 가집니다.
채널/그룹 안전: agents.defaults.sandbox.mode: "non-main"으로 설정하면 메인 세션이 아닌 대화(그룹 등)를 개별 Docker 샌드박스 내부에서 실행합니다.
샌드박스 설정: bash, read, write 등은 허용하고 browser, gateway 등 민감한 도구는 거부 목록에 추가할 수 있습니다.

상세 내용: 보안 가이드

스킬 레지스트리 (ClawdHub)

ClawdHub는 최소화된 스킬 레지스트리입니다. ClawdHub를 활성화하면 에이전트가 자동으로 스킬을 검색하고 필요한 경우 새로운 스킬을 가져올 수 있습니다.

ClawdHub 바로가기

개발 참여 및 커뮤니티

프로젝트 가이드라인 및 PR 제출 방법은 CONTRIBUTING.md를 확인하세요. 🤖

특별히 도움을 주신 Mario Zechner와 pi-mono 프로젝트에 감사의 인사를 전합니다.

Moltbot은 Peter Steinberger와 커뮤니티가 함께 만든 우주 바닷가재(Space Lobster) AI 비서 Molty를 위해 탄생했습니다. 🦞

몰트봇(moltbot)이란?