OpenBot, 이미 쓰는 코딩 에이전트를 한 로컬 팀으로 돌립니다

openbot.run의 OpenBot은 새 모델을 팔지 않는다. 이미 로그인된 Codex, Claude Code, Grok CLI, OpenCode를 내 컴퓨터의 프로세스로 띄우고, 에이전트마다 폴더와 스레드와 이름을 붙인다.
채팅창은 다음날 아침이면 그 폴더가 어디였는지부터 잊어버린다. 에이전트를 여럿 쓰면 그 망각이 사람 수만큼 늘고, 파일을 주고받는 자리도 채팅 로그 밖으로 샌다.
모델만 바꿔도 폴더와 대화 기록과 이름은 그 컴퓨터에 남습니다.
없을 때와 있을 때
OpenBot이 없다면 터미널마다 Codex와 Claude를 따로 켜고, 끝난 일은 각자 세션 파일에 남긴다. 다음 에이전트는 그 파일을 스스로 찾지 못한다. 사람이 경로를 다시 붙여 넣어야 하고, 재시작 뒤에는 이름도 역할도 사라진다. 남는 것은 프로바이더가 가진 이어하기 상태뿐이다.
OpenBot이 있다면 에이전트마다 ~/OpenBot/Agents/<agent-id> 폴더가 생기고, 서로 파일을 넘기는 자리는 ~/OpenBot/Shared다. 시킨 일과 한 일은 스레드에 남는다. Codex에서 Claude로 옮겨도 워크스페이스와 스레드와 이름은 그대로다. 기록의 원본은 앱 데이터 폴더의 SQLite 파일 openbot.db다.
어떤 판단을 내리나
프롬프트는 앱 안에 심은 모델로 나가지 않는다. 고른 명령줄 도구를 그 컴퓨터에서 실행하고, 그 도구가 이미 가진 로그인으로 바깥 서비스에 붙는다. 자격 증명을 복사해 오지 않는다. 터미널에서 그 도구가 되면 여기서도 된다. 로컬 우선은 오프라인이 아니다. 시킨 문장은 각 서비스로 나가고, 임베디드 브라우저의 페이지도 네트워크를 쓴다. 플러그인이 자기 서버를 부를 수도 있다. 나가지 않는 것은 폴더와 스레드와 첨부다. 재시작해도, 모델을 바꿔도, 그 셋은 남는다. 바뀌는 것은 생각하는 쪽뿐이다. 대기열은 먼저 넣은 일부터 처리하고, 멈추고, 다시 잇고, 취소할 수 있다. 크래시 뒤에도 큐는 남는다. 스레드가 길어져 모델 창이 차기 전에, 에이전트별 모니터가 대화를 압축한다. 한 에이전트가 다른 에이전트에게 일을 넘기면, 넘긴 내용은 받는 쪽 스레드에 남는다. 파일도 관리된 전송으로 넘어간다. 같은 말을 세 명에게 동시에 시키면 같은 문단이 세 번 돌아온다. 역할을 나눠야 손이 갈린다.

갈래는 둘이다. 한쪽은 앱이 내려받아 고정하는 CLI다. 온보딩이나 설정, 모델 선택에서 Download를 누르면 Codex, Claude Code, Grok CLI, OpenCode의 관리 사본을 깔고 버전을 고정한다. 이미 깔린 도구만 있고 관리 사본이 없으면 그것을 쓴다.
다른 쪽은 ACP다. Hermes를 미리 깔아 두었다면 OpenBot은 hermes acp를 띄운다. 그 쪽 memories, skills, 로그인, SOUL.md가 여기 에이전트에도 적용된다. OpenBot이 Hermes를 대신 업데이트하지는 않는다. Cursor, Cline, GitHub Copilot, Kimi, Devin, Mistral Vibe, Antigravity CLI의 Gemini도 같은 방식으로 붙일 수 있다. OpenAI 호환 엔드포인트와 Ollama, LM Studio는 베이스 URL로 연결한다.
채널은 여러 에이전트가 한 스레드를 읽고 쓰는 자리다. 한 번에 한 에이전트가 일을 맡고, 넘길 때는 명시적으로 넘긴다. Stop, Resume, Reassign, Archive, Restore는 사람 쪽에 남는다. 입문 가이드의 그림은 출시 노트를 Launch에게 맡기고, Research가 확인할 수 있는 수치만 보고한 뒤, 초안 파일이 스레드에 링크로 붙는 흐름이다.
루틴은 지시 하나와 시각이다. 결과는 그 에이전트 스레드에 쌓이고, 실행 기록도 옆에 남는다. 보고할 것이 없다는 답이 정상이어야 한다. 매번 무언가를 찾게 시키면, 없는 이슈를 만들어 낸다.
임베디드 브라우저는 에이전트가 페이지를 열고 클릭하는 자리다. Computer Use는 선택이다. 릴리스에 들어 있는 cua-driver를 OpenBot이 자식 프로세스로 띄워, macOS·Windows·Linux에서 화면 조작을 넘긴다. 따로 받을 드라이버는 없다. 워크플로에는 승인 단계를 넣을 수 있다. 승인이 필요한 단계는 사람이 통과시키기 전에는 다음으로 가지 않는다.
첫 일은 작고 확인 가능해야 한다. 입문 가이드는 프로젝트를 개선하라는 문장이 에세이를 돌려주고, 실패한 테스트를 읽고 어떤 주장을 반증하는지 물으면 맞다 틀리다를 가릴 수 있다고 적는다. 답만 보지 말고 답 아래의 활동 기록을 본다. 연 파일과 실행한 명령이 있어야, 일을 한 것인지 설명만 한 것인지 가른다.
README는 첫 동의 뒤 에이전트가 danger-full-access와 approvalPolicy: never로 돈다고 경고한다. 파일과 명령을 매번 묻지 않고 실행하고, 네트워크와 임베디드 브라우저도 쓴다. 저장소 구조 문서는 Codex의 MCP 호출 때문에 approvalPolicy를 on-request로 둔다고 적고, 에이전트별로 워크스페이스만·매번 묻기·전체 접근을 나눈다고 적는다. v0.73.0을 켠 뒤 권한 화면을 한 번 읽는 편이 맞다. 전체 접근은 보안 경계가 아니다. 시작 폴더는 에이전트 디렉터리지만, 운영체제가 허용하는 밖까지 손을 뻗을 수 있다. 믿는 일과 백업이 전제다.
설치
설치 파일은 다운로드 페이지에 있다. macOS 13 이상이면 Apple silicon과 Intel 모두 공증된 DMG로 받는다. Windows 10 또는 11의 x64 설치 파일은 서명돼 있어도 SmartScreen이 경고할 수 있으니 릴리스 체크섬을 확인한다. Linux는 x64와 arm64 AppImage다. Ubuntu 23.10 이상과 Debian 13은 AppImage 전에 AppArmor 프로필이 필요하고, 그 명령은 README에 있다.
아이폰과 안드로이드 앱도 있다. 폰은 모델을 돌리지 않는다. 컴퓨터에 떠 있는 OpenBot에 붙어 알림과 라이브 액티비티로 상태를 본다.
nightly-labs/openbot은 2026년 8월 12일에 만들어졌다. 최신 릴리스 v0.73.0은 2026년 11월 19일 01:32(한국시간)에 나왔고, 저장소는 같은 날 오전 9시 32분(한국시간)에 다시 밀렸다. 스타는 8,983, 포크는 868이다. 열린 이슈는 3,168으로, 만든 지 석 달인 저장소치고 트래커가 바쁘다. 다음으로 볼 것은 별 수가 아니라, 이 컴퓨터에서 전체 접근과 비상업 라이선스를 감당할 수 있는지다.
쓸 때
화면 없는 서버에 에이전트를 계속 켜 두고, 데스크톱이 꺼져도 폰과 브라우저에서 같은 호스트에 붙고 싶을 때 쓴다.
curl -fsSL https://raw.githubusercontent.com/nightly-labs/openbot/main/scripts/install-server.sh | sudo bash
sudo openbot login
로그인이 끝나면 헤드리스 호스트가 남는다. 데스크톱, 아이폰, openbot.run/app이 그 호스트에 붙는다. README는 Docker로 띄우는 방법도 적어 두었다.
쓸 때
이미 떠 있는 에이전트에게 터미널에서 일을 넘기고, 턴이 끝날 때까지 답을 기다리고 싶을 때 쓴다. 아래는 저장소 자동화 문서의 호출이다. Ada는 문서가 쓴 예시 이름이다.
openbot-cli run "Ada" "Run the tests and tell me what failed" --wait
Local scripts를 켠 에이전트만 이 호출을 받는다. --wait는 턴이 끝날 때 답을 출력한다. 기본 대기는 30분이고, 시간이 끊겨도 일은 계속 돈다. macOS에서는 앱 안의 openbot-cli.mjs를 node로 별칭해 쓴다.
많이 묻는 질문
채팅과 파일은 클라우드로 올라가나요?
계정, 아바타, 호스트 설정, 멤버십, 초대, 논리 세션은 Cloudflare에 있다. 채팅과 파일과 명령은 그쪽으로 가지 않는다. Team API는 루프백만 열고, 초대된 클라이언트는 WebRTC로 붙는다. Signal은 연결 설정만 나른다. 사람을 초대해도 두 번째 인스턴스가 뜨지는 않는다.
워크스페이스 밖 파일도 건드리나요?
시작 폴더는 에이전트 디렉터리다. README가 경고하는 전체 접근은 그 폴더에 가두지 않는다. 운영체제가 허용하면 밖을 읽고, 고치고, 명령을 실행하고, 네트워크와 임베디드 브라우저를 쓴다. 첫 동의 뒤에는 매번 묻지 않는다. 믿는 일과 백업이 전제다.
회사 업무에 그냥 써도 되나요?
개인 사용은 PolyForm Noncommercial 1.0.0으로 무료다. 상업 이용은 저작권자의 별도 라이선스가 필요하다. 설정의 Billing에서 Starter는 1명, Team은 2명에서 10명이고, 그 밖은 licenses@openbot.run으로 묻는다. 0.1.11 이하만 Apache-2.0으로 남는다. 지금 받는 빌드는 0.73.0이니 그 예외에 들어가지 않는다.
'AI 스킬' 카테고리의 다른 글
| 1 — Install, Headroom, 모델 호출 전에 에이전트 컨텍스트를 압축합니다 (0) | 2026.11.19 |
|---|---|
| OpenMontage, 간단한 요청 한 줄로 완성 영상을 만든다 (0) | 2026.11.18 |
| career-ops, 이력서로 공고를 채점하고 제출할 지원서 초안을 씁니다 (0) | 2026.11.18 |

