OpenMausBot: 로컬 에이전트를 채팅처럼 관리하는 작업 공간
Claude·Codex 등 로컬 에이전트를 채팅 연락처처럼 관리하고 컴퓨터·외부 앱·예약 작업을 연결하는 데스크톱 및 웹 작업 공간이에요.
주요 기능
- 봇별 모델·성격·작업 폴더와 채널을 나누고 스트리밍 작업 및 승인 카드를 표시해요.
- Boat 클라우드 컴퓨터, 로컬 VM, 지원 플랫폼의 호스트 제어와 Composio 앱 연결을 제공해요.
- 팀 템플릿, 일정·웹훅, 음성, 외부 MCP 제어와 헤드리스 CLI를 문서화해요.
구조
React·Vite 화면과 127.0.0.1:8799의 TypeScript harness 서버가 HTTP·SSE로 통신해요. 서버가 로컬 CLI 프로세스와 권한 중재를 담당하며 Electron이 데스크톱을 포장해요. 대화·설정은 ~/.openmausbot에 보관하되 모델·선택 통합 서비스는 외부와 통신해요.
누구에게 쓸모 있나요
여러 AI 계정을 이미 사용하는 개발자와 개인 업무 자동화 사용자. 컴퓨터 접근과 외부 앱 권한을 직접 관리할 수 있는 사람에게 적합해요.
설치 전 준비
- 소스 manifest: Node >=24, pnpm@10.33.0. 실제 패키지 버전은 0.1.139예요.
- 기본 README 경로는 Claude·Codex·Grok 중 하나의 CLI 설치·로그인을 요구해요. 선택적 호환 모델 엔진 설정도 있어요.
- 클라우드 컴퓨터·앱 연결·외부 음성은 각 서비스 계정·키와 권한이 필요해요.
- macOS Apple silicon·Intel, Windows x64, Ubuntu 24.04 x64 배포 경로
- Ubuntu는 베타이며 README상 Xorg 호스트 제어는 명시적 동의가 필요하고 Wayland 제어는 비활성
- Node 서버 및 선택적 모바일·원격 연결
설치 방법
공식 배포판
공식 Releases에서 OS에 맞는 설치 파일을 선택해요. README는 Windows 설치 파일이 미서명이라고 설명하므로 배포 출처와 파일을 검토하고 OS 경고를 무작정 해제하지 않습니다.
소스 개발
문서에 나온 개발 경로예요. 서버·웹 화면·데스크톱 명령은 각각 실행하는 방식이며 이 조사에서는 실행하지 않았어요.
git clone https://github.com/milind-soni/OpenMausBot
cd OpenMausBot
pnpm install
pnpm dev:server
# 별도 터미널: pnpm dev
# 별도 터미널: pnpm dev:desktop사용 방법
- 로그인한 에이전트를 확인하고 봇을 만든 뒤 모델을 선택해요.
- 먼저 일반 채팅을 시험하고 필요한 연결만 설정 화면에서 추가해요.
- 컴퓨터 제어·예약·웹훅은 작업 범위와 승인 정책을 정한 뒤 활성화해요. 웹훅 수신에는 앱 실행 유지가 필요해요.
비용과 API 키
OSS 자체는 무료이지만 모델 사용량·구독, Boat 체험 이후 사용, 음성·연결 서비스·서버 비용은 별도예요. enterprise 기능의 운영 사용에는 별도 라이선스가 필요해요.
라이선스
기본 코드 Apache-2.0. enterprise/는 별도 source-available 라이선스로 운영 사용 키 및 재배포·호스팅 제한이 있어요. 상표와 제3자 구성 요소의 조건도 별개예요.
주의사항과 알려진 이슈
- local-first가 모델 요청까지 오프라인이라는 뜻은 아니에요. 연결 앱·클라우드로 보내는 데이터와 범위를 확인해야 해요.
- CLI 온보딩 문서는 API 키를 로컬 config.json에 평문으로 저장한다고 명시해요. 파일 권한·백업·원격 접근을 별도 관리해야 해요.
- 호스트 제어는 실제 파일과 계정에 영향을 줄 수 있으며 플랫폼별 기능 차이가 커요.
- README의 Wayland 설명이 참조하는 #345는 실제로 Ubuntu 업그레이드 이슈이며 현재 닫혀 있어요. 문서 연결을 현재 미해결 증거로 해석하면 안 돼요.
#345 Ubuntu 업그레이드 경로 이슈(종료)
실제 DEB 업그레이드의 권한 보존·시작 지연 등을 기록했으며 2026-08-30 완료 종료 상태를 확인했어요. 현재 버전 재현 시험은 하지 않았어요.
확인 범위
확인 날짜: 2026-11-02
확인 커밋: a046dc5df29fd29ac48160d67b485b0437d3d4d1
확인한 범위: 공식 GitHub main 커밋을 조회하고 해당 커밋에 고정된 README.md, package.json, LICENSE, LICENSING.md, enterprise/LICENSE를 정적으로 확인했어요. 표시한 공개 이슈의 상태도 확인했어요.
확인 한계: 저장소 코드·의존성을 설치하거나 실행하지 않았어요. 계정 연결·모델 호출·과금·빌드·기기별 동작·성능·전체 보안 감사는 미검증이며 안내는 공식 문서 기준이에요.