이름이 같은 다른 프로젝트
이 노트는
nightly-labs/openbot(openbot.run, Synthetify Labs)이다. 게이트웨이·CEL 정책을 앞세운 CopilotKit의 OpenBot(2026-10-04-github-copilotkit-openbot)과는 이름만 같은 별개 저장소다. 성격은 오히려 로컬 Electron 앱에 CLI 에이전트를 붙이는 2026-08-23-github-milind-soni-openmausbot에 가깝다.
개요
OpenBot은 “상주하는 AI 동료(persistent AI teammates)“를 위한 로컬 우선 데스크톱 워크스페이스다. 로컬 Codex App Server와 Claude Code(Agent SDK)를 직접 붙이고, Grok CLI·opencode·Gemini(Antigravity)·Cursor CLI·Cline CLI는 ACP로 붙인다. 에이전트마다 작업 공간과 대화를 따로 두고, 메시지 큐·파일 전달·내장 브라우저·에이전트 간 메시징을 한 앱에서 제공한다.
- 저장소 생성 2026-08-12, 2026-10-27 기준 스타 1,928·포크 219, 커밋 약 2,200개.
- 0.1.0(2026-08-13)부터 0.51.1(2026-10-26)까지 약 2.5개월 동안 릴리스가 100번쯤 나왔다. 주 기여자는 3명이다.
- 스택은 Electron + SolidJS + Bun + SQLite이고, 계정 API는 Cloudflare Workers·D1(TanStack Start)이다.
- macOS 13+, Windows 10+ x64, Linux AppImage(x64·arm64)를 지원한다. Docker 이미지, 헤드리스 Linux 서버 설치, Nix flake, iPhone 앱도 있다.
먼저 알아둘 위험 두 가지
1. 에이전트가 무제한 권한으로 돈다. README가 맨 위에 경고하듯 현재 에이전트는 danger-full-access + approvalPolicy: never로 실행된다. 첫 실행 때 한 번 동의하면 그 뒤로는 파일 수정·명령 실행·네트워크·브라우저 조작을 행동마다 묻지 않는다. 작업 공간은 ~/OpenBot/Agents/<agent-id>와 ~/OpenBot/Shared지만, 프로바이더와 OS가 허용하면 그 밖의 호스트 접근도 막지 않는다. 프로젝트는 이를 “보안 경계가 아니라 의도된 제품 결정”이라고 밝힌다.
2. Claude 구독 로그인은 약관상 회색지대다. OpenBot 자체 문서(docs/provider-terms.md)가 이를 정리해 두었다. OpenBot은 Agent SDK 제품이다. 그런데 OpenBot 문서가 2026-10-06에 인용한 Anthropic 문구는 “Agent SDK로 제품을 만드는 개발자는 API 키를 써야 하고, 사용자를 대신해 Free·Pro·Max 자격증명으로 요청을 보내면 안 된다”고 한다. 프로젝트가 스스로 매긴 위험도는 아래와 같다.
| 사용 형태 | 위험(프로젝트 자체 평가) |
|---|---|
| 내 컴퓨터에서 내 작업 | 불명확 — 로그인은 Anthropic 공식 흐름이지만 무인 에이전트는 “일반적 개인 사용”을 넘을 수 있음 |
| 다른 컴퓨터에서 호스트로 코드 로그인 | 더 높음 — OpenBot이 로그인 코드를 호스트로 전달 |
| 팀원이 내 호스트의 Claude 에이전트 사용 | 높음 — 여러 사람 요청이 한 사람 플랜을 씀 |
Anthropic이 이 방식을 허용한다고 OpenBot에 확인해 준 적은 없다. 권장 경로는 ANTHROPIC_API_KEY나 Bedrock 같은 클라우드 프로바이더다. 위 Anthropic 문구는 OpenBot 문서에 인용된 것을 옮겼을 뿐이고 원문은 직접 확인하지 않았다.
무엇을 하나
- 상주 에이전트: 프롬프트로 에이전트를 만들고 고친다(지시문·아바타·섹션 검토). 에이전트를 Codex↔Claude↔Grok으로 바꿔도 로컬 대화는 하나로 이어지고, 프로바이더 세션 ID는 재개용으로만 쓴다. 컨텍스트 창이 차기 전에 자동 압축한다.
- 큐와 협업: FIFO 메시지 큐(일시정지·재개·취소, 크래시에도 유지)가 있다. 에이전트끼리 메시지·답장·리액션·이미지·파일을 주고받는다. 공유 채널에서는 작업 소유자 한 명을 두고 명시적으로 위임하며 Stop·Resume·Reassign 같은 제어를 쓴다.
- 브라우저와 컴퓨터 사용: 에이전트가 열고 조작하는 내장 브라우저는 샌드박스된 별도 Electron 세션이다. 선택 기능인 Computer Use는 릴리스에 번들된 cua의
cua-driver를 자식 프로세스로 띄워 모든 프로바이더에 준다(macOS만 화면 기록·손쉬운 사용 권한 필요). - 프로바이더 확장: OpenAI 호환 엔드포인트와 커스텀 ACP 에이전트를 붙일 수 있고, Ollama·LM Studio를 감지한다. 0.51.0에서 DeepSeek·OpenRouter가 추가됐는데, 둘 다 OpenBot이 내려받는 Pi CLI 안에서 돈다.
- CLI 관리: 프로바이더 CLI를 직접 내려받아 고정한다(Claude는 npm 무결성 해시 확인, 자체 업데이터는 끔). 업데이트는 시작 시와 매시간 확인한다. 자격증명은 복사하지 않고 각 CLI의 기존 로그인을 쓴다.
- 스킬: 에이전트가 작업 흐름을
SKILL.md폴더로 만들어 로컬 라이브러리에 등록한다(버전 유지). 0.51.0부터~/.agents/skills를 모든 프로바이더에 주고, 메시지 창에서$로 스킬을 태그한다. 마켓플레이스도 있다. - Grok Bot 이전: Grok Bot에 “OpenBot export agent”를 추가해 zip으로 내보내면 이름·지시문·스킬·루틴·메모리를 가져온다. 대화 기록은 가져오지 않는다. Grok Bot 쪽 사용 사례는 2026-09-10-threads-grokbot-team-stack 참고.
”로컬 우선”의 범위
README 스스로 “local-first, not offline-only”라고 밝힌다. 각 CLI는 자기 프로바이더 서버로 통신한다. 그 밖에 서버 쪽 구성 요소가 꽤 있다.
- 계정: 선택 사항이다. 이메일 일회용 코드로 로그인하며, 계정·설정·멤버십은 Cloudflare D1, 아바타는 R2에 저장된다.
- 팀·원격 접속: 호스트의 Team API는 loopback에만 열린다. 초대받은 데스크톱·모바일 클라이언트는 WebRTC로 붙고, 직접 연결이 안 되면 coturn으로 중계한다. Signal 서버는 연결 설정만 나르며, 채팅·파일·명령은 Cloudflare를 거치지 않는다고 한다.
- 호스팅 서버(유료): boat 샌드박스에 Linux 빌드를 올린 계정당 서버다. Stripe 플랜(Starter·Standard·Pro)으로 판매한다. 15분간 쓰지 않으면 데이터를 둔 채 멈추고, 클라이언트 접속·루틴 일정·Slack/Discord/Telegram 메시지가 오면 깨어난다.
- 셀프 호스팅: Signal·TURN을 직접 띄울 수도 있다.
라이선스
0.1.11까지는 Apache-2.0이었고, 지금은 PolyForm Noncommercial 1.0.0이다. 비상업 목적이면 사용·수정·배포가 자유롭고, 상업적 사용은 별도 라이선스가 필요하다. README는 스스로를 “source-available”로 표기하고, 0.51.0에서 웹사이트 FAQ·출시 소식 글의 표현도 그에 맞췄다. 외부 기여자는 저작권을 Synthetify Labs에 양도하는 CLA에 서명해야 한다.
한계
- README·
docs/provider-terms.md·docs/hosted-servers.md·CHANGELOG만 읽었고, 설치·실행은 검증하지 않았다. - 무제한 권한, Claude 구독 약관, 비상업 라이선스 세 가지가 실사용의 전제 조건이다. 개인 실험이라면 API 키를 쓰고 백업을 해 두는 편이 안전하다.
관련 노트
- 2026-08-23-github-milind-soni-openmausbot — 같은 시기(2026-08-11) 나온 비슷한 구조의 Electron 채팅앱형 러너
- 2026-10-04-github-copilotkit-openbot — 이름이 같은 CopilotKit의 게이트웨이형 플랫폼
- 2026-08-24-openmausbot-vs-openbot — OpenMausBot과 CopilotKit OpenBot 비교
- cua — Computer Use 백엔드로 번들된 cua-driver
- codex · opencode — 지원 프로바이더