개요

OpenBot은 copilotkit이 2026-08-17 공개한 MIT 오픈소스 자체 호스팅 AI 어시스턴트 플랫폼이다. “ChatGPT·Claude·Grok과 같은 모양이지만 내 인프라에서 돌고 무엇이든 바꿀 수 있는” 것이 포지셔닝이며, 어떤 AG-UI 에이전트든 코워커로 들어온다. 2026-10-04 기준 별 5,989개·포크 803개, 알파 단계의 템플릿(호스팅판 없음, 패키지로 배포하지 않음)이다. 공개 초기의 소개글 반응은 2026-09-10-threads-openbot-copilotkit에 있고, 이 노트는 저장소 README 자체를 정리한다.

핵심 구조

  • 봇마다 컴퓨터 한 대: 감독기(supervisor)가 봇별 컨테이너·/workspace 볼륨·브라우저 프로필을 만든다. 셸도 같은 게이트를 거친다. COMPUTER_RUNTIME=runsc로 gVisor 사용 가능. 컴퓨터는 루프백+컨테이너별 토큰으로만 접근한다.
  • 게이트웨이가 유일한 길: 대상 해석(서버가 가진 스냅샷) → 정책 평가 → 감사 행 기록 → 그 후에야 컴퓨터 호출. 기록 없이 실행되는 경로가 없다.
  • CEL 정책, fail closed: tool.name·page.host·command·file.*·mcp.*·initiator.* 등을 검사한다. deny 우선, 정책이 없으면 아무것도 허용하지 않고, 깨진 규칙은 열지 않고 거부한다. 예약 루틴에는 사람보다 엄격한 규칙을 줄 수 있다.
  • 사람 인계: 로그인·2FA 벽에서 봇이 도움을 요청하면 같은 패널에서 사람이 조종하고(control_taken/released 기록), 그동안 봇 동작은 큐잉이 아니라 거부된다. 비밀값은 “요청했다는 사실과 길이”만 기록한다.
  • Components: 응답을 산문 대신 React 컴포넌트로 렌더링하고, 샌드박스 컴포넌트는 /admin/playground에서 배포 없이 게시한다. 봇별 사용 권한은 서버가 호출마다 검사한다.
  • 거버넌스 MCP: Google Drive·Notion·Parallel Search가 카탈로그에 있고 Composio가 수백 개 앱을 사용자 권한으로 중개한다. 스킬은 “지시이지 권한이 아니다”.
  • Routines: 15분 하한, 활성 20개 상한, 연속 10회 실패 시 자동 중지로 비용 폭주를 막는다.
  • 로그인: Google·Microsoft·Okta 또는 도메인별 SAML/OIDC. 로컬은 OPENBOT_SINGLE_USER=true(전원 관리자)가 기본이라 타인에게 열기 전 반드시 끈다.

구성과 배포

app(3010)·server(3001, Hono+CopilotKit 런타임)·agent-computer·supervisor·worker·PostgreSQL(pgvector)·Intelligence(외부, 스레드·메모리). 샘플 코워커 13종은 코드가 아니라 설정(YAML)이며 examples/fintech가 테넌트 패키지 예시다. 요건은 Docker·Bun 1.3+·Intelligence 프로젝트(무료 플랜 또는 자체 호스팅, macOS는 로컬 평가판 30일 갱신)·모델 키. 단일 이미지 ghcr.io/copilotkit/openbot(앱+API+브라우저+선택형 내장 PostgreSQL)로 쿠버네티스 없이 배포한다. 모델은 번들되지 않는다.

확인 범위와 한계

  • README 기준 정리이며 설치·실행·정책 우회 시험은 하지 않았다.
  • “게이트웨이가 유일한 길”은 저자 설명이며, 컴퓨터 서비스가 노출하는 하위 엔드포인트를 게이트웨이 우회에 쓰지 말라는 경고가 문서에 있다.
  • CopilotKit이 “회사 안에 구축해 주는” 상담 영업을 병행한다. 템플릿 자체는 MIT지만 Intelligence는 별도 서비스·요금제다.

같은 계열 템플릿

  • OpenDots: OpenBot의 컨테이너 감독기·컴퓨터 서비스를 그대로 재사용하고 그 위에 문서·통화·Slack을 얹었다.
  • OpenMuse: 1인용 모바일 개인 에이전트. OpenBot과는 독립이며, 비활성 OpenBot 어댑터만 계약 테스트로 고정해 두었다.
  • OpenTag: OpenBot보다 먼저(2026-06) 나온 Slack·Teams용 Channels SDK 스타터다.
  • 개인용 Electron 채팅앱과의 비교는 2026-08-24-openmausbot-vs-openbot에 있다.

관련 위키