b3os 시작 가이드 — 여러 AI를 한 팀으로

따라만 하면 됩니다

설치 → 팀원 만들기 → 채널 연결 → 첫 지시 → 팀방

b3os는 여러 AI를 한 팀으로 운영하는 도구입니다. 아래 순서대로 따라오세요.

⭐ Claude Code를 동반자로 두고 b3os 스킬을 실행하세요. 팀원 만들기, 팀 OP 및 팀방 설정까지 Claude와 같이 실행해보세요.

1설치 — 받아서, 깔고, 켜기

여러분의 Claude Code에게 이렇게 말하면 끝입니다:

이 저장소의 b3os 스킬을 설치하고 실행해줘: github.com/b3rys/b3rys-team-os

그러면 Claude가 clone → 설치 → 대시보드 기동 → 첫 팀원 영입까지 알아서 진행합니다. 현재 기본 설치 흐름은 Claude Code 기준입니다.

curl 설치 — 스킬부터 깔려면

curl -fsSL https://raw.githubusercontent.com/b3rys/b3rys-team-os/main/install-skill.sh | bash

설치 직후 Claude Code에서 /reload-skills를 한 번 실행한 뒤, 위 설치·실행 요청을 다시 말하면 됩니다.

터미널 설치 — 직접 하려면

git clone <repo-url>
cd b3rys-team-os
bash install.sh      # bun·의존성·대시보드·.env 자동 준비
bun run start        # 서버 실행

브라우저에서 http://localhost:7878/team 를 열면 대시보드가 뜹니다.

↑ 대시보드 첫 화면 — 팀원·런타임·채널 연결을 한눈에.

설치 스크립트가 설정 파일까지 만들어줘서, 기본값만으로 대시보드는 바로 동작합니다.

💻 맥앱 b3os.app — 맥앱으로도 사용 가능합니다.

브라우저 대신 네이티브 맥앱으로도 쓸 수 있어요. 대시보드 상단 다운로드 버튼에서 받아 설치하면 같은 대시보드가 앱으로 열립니다.

⚠ 안전한 본인 맥에서만 구동하세요. b3os는 봇 토큰·팀 데이터·에이전트 자격이 로컬에 저장되므로, 신뢰할 수 있는 본인 기기에서만 실행하고 공용·미신뢰 환경에는 두지 마세요.

2팀원 만들기 — 이름·역할·런타임만

처음엔 빈 팀입니다. 첫 팀원 만들기(또는 상단 Settings) → 팀 이름·미션을 적고 + 영입:

팀원의 이름 · 역할을 적습니다 (예: "데미스 · AI 리서치").
런타임을 고릅니다 — 기본은 Claude입니다. OpenClaw·Hermes는 본인 계정/프로필 연결(BYO), Codex는 지원 예정입니다.
팀원 페르소나 설정을 통해 성격과 구체적인 역할을 부여하세요.
저장 → 대시보드에 팀원이 나타납니다.

💡 이름·역할만 정해도 팀원이 생깁니다. 실제 봇 연결은 나중에 해도 돼요.

3채널 연결 — 말 걸듯 일 맡기기

텔레그램이나 슬랙 중 하나만 연결해도 됩니다. 봇을 팀 대화방에 초대하거나 팀원과 1:1 DM으로 연결하면 됩니다.

연결하면, 사람에게 하듯 채팅으로 일을 맡깁니다. 이렇게요 👇

데미스 1:1 (DM)

GD이 로그 좀 분석해줘

데미스네, 확인할게요 — 에러 원인 정리해서 올릴게요.

1:1 DM = @멘션 없이 바로 업무 지시

b3rys 팀방

빌배포 준비됐습니다.

GD↳ 빌: 배포 준비됐습니다좋아, 그럼 올려줘.

빌네, 올리고 결과 보고할게요.

답장 = 원문 작성자(owner)가 승계, 모호하면 라우터가 배정

빌 1:1 (DM)

GD이 기능 BWF로 진행해줘. 프론트는 스티브에게 넘기고, 검증까지 챙겨.

빌PM으로 붙겠습니다 — 범위 정의 → 카드 생성 → 스티브 핸드오프 → 검증 결과까지 보고하겠습니다.

1:1 DM = 위임·핸드오프 지시도 바로 전달

b3rys 팀방

GD@스티브 @데미스 @데본 이 문서 세 파트로 나눠서 다듬어줘

스티브네, 저는 본문 흐름을 다듬을게요.

데미스저는 그림과 설명 정확도를 볼게요.

데본저는 캡처와 HTML 반영을 맡겠습니다.

여러 명 멘션 → 멘션된 전원이 각자 자기 몫 응답

b3rys 팀방

GD@데미스 이 로그 좀 분석해줘

데미스네, 확인할게요 — 에러 원인 정리해서 올릴게요.

@멘션 = 그 팀원만 깨움

데미스 1:1 (DM)

GD이 프로젝트 매일 새벽에 진행해서 나한테 알려줄래?

데미스W0~W5를 매일 새벽 2시에 진행하고 결과 보고하겠습니다.

1:1 DM = 스케줄 지시 → 매일 자동 실행 + 보고 (워크루프)

빌 1:1 (DM)

GD스티브·데미스·데본한테 각각 조사시키고, 각자 나한테 보고하라고 해줘

빌개별 보고로 뿌리겠습니다 — 세 명이 각자 팀장님께 직접 보고합니다.

스티브제 몫 조사 끝났습니다. 결과 보고드립니다.

각자 보고 = 위임받은 사람은 종합하지 않음, 팀원이 각자 직접 보고

빌 1:1 (DM)

GD셋한테 의견 받아서 하나로 정리해 보고해줘

빌세 명에게 요청하고, 답이 다 오면 하나로 정리해 보고하겠습니다.

빌종합했습니다 — 공통 결론 1개, 갈린 지점 1개입니다.

정리 보고 = 한 명이 모아서 종합 1건. 전원 응답 전에는 보고하지 않음

데미스 1:1 (DM)

GD이번 주 결과 보고서로 만들어줘

데미스정리해서 팀 포털에 올리고 링크 드리겠습니다.

데미스완료했습니다 — 포털에 게시했고 링크 보냅니다.

보고서 = 문서로 정리 → 팀 포털 게시 → 링크로 공유

4첫 지시 — 그냥 말 걸어보기

준비 끝. 1:1 DM에서는 바로 말하고, 팀방에서는 @팀원 이름으로 일을 맡겨보세요. 그 팀원이 받아서 처리하고, 진행 상황은 대시보드 Tasks에서 보입니다.

긴 일은 자동으로 카드가 되고(owner·완료기준), 끝날 때까지 추적됩니다. 작은 일은 채팅에서 바로 끝.

5팀방 만들기 — 팀 협업

간단히 team op를 셋업하고 팀방을 만들어보세요. 팀방에선 team op가 팀원들의 말을 전달하고 시스템 메시지를 전달합니다.

팀 라우터(team-op) 봇을 그룹에 두면 그룹에 올라온 메시지를 받아 담당자에게 배정합니다. Settings ▸ 시스템 OP에서 라우터를 ON 하면 활성화됩니다.

기능 소개

리서치와 보고서를 팀 작업으로

팀원과 함께 리서치와 관련 보고서를 만들어 언제든 열람할 수 있습니다.

데본 1:1 (DM)

GDAI 에이전트 시장 리서치 보고서 만들어줘

데본👀 자료 조사해서 보고서로 올릴게요.

채팅으로 리서치 지시 → 보고서 생성·공유

어떻게 돌아가나

AI 팀원들이 한 팀으로 일을 수행하는 것

b3os의 가치는 에이전트 수가 아니라, 여러 AI가 한 팀으로 과제배정 → 실행 → 검증 → 보고 → 종료까지 수행해내는 데 있습니다.

끝나지 않은 일은 워크룹이 정해진 시각에 다시 깨워, 조용히 사라지지 않게 합니다.

담당자(owner) 판정 — @멘션 > 답장 > 직전 담당자, 모호하면 라우터가 역할·맥락으로 배정.
Tasks / BWF — 작은 일은 바로, 10분↑·인계·배포가 걸리면 카드(owner·상태·완료기준)로.
워크룹 — 반복·미결 작업을 정해진 시각에 깨워 완료/보류/컨펌대기로 닫음.
종료(closure) — 사용자에게 보이는 최종 보고까지 끝나야 완료.

런타임

두뇌를 어디에 연결할지 — 런타임 중립

b3os는 특정 AI에 묶이지 않는 방향으로 설계되어 있습니다. 지금 기본으로 바로 쓰는 런타임은 Claude이고, 다른 런타임은 연결 방식에 따라 상태가 다릅니다.

Claude 기본·권장

Claude Code를 tmux 세션으로 연결. 현재 유일한 기본 활성 런타임입니다.

OpenClaw BYO

본인 OpenClaw 계정/프로필을 연결해 gateway/session으로 사용합니다.

Hermes BYO

본인 Hermes 계정/프로필을 연결해 Hermes 계열 agent로 사용합니다.

Codex 지원 예정

OpenAI Codex 기반 에이전트 연결은 coming soon 상태입니다.

+ b3os_native(개발 중) — 외부 앱 없이 b3os 안에서 직접 구동(로컬 Gemma 등 두뇌 교체).

기능

한 대시보드에서 보는 팀 도구

기능	무엇
Tasks / 칸반	팀 작업을 owner·상태·완료기준으로 관리.
Team / Settings	팀 이름·미션·팀원·역할·runtime 관리. 영입도 여기서.
Inbox / Threads / Audit	외부 채널 메시지·라우팅 결과·응답 내역. "왜 이 팀원이 호출됐나" 추적.
Docs / Reports	운영 문서·결과물 모아보기.
Topology	팀원·runtime·채널·라우터 연결 상태 한눈에.
Proposals	팀 규칙·기능 변경을 draft → review → decision으로.
Search	메시지·문서·task·리포트 통합 검색.

안전장치

무인 운영을 안전하게 묶는 규칙

owner 규칙

메시지마다 담당자 1명을 정해 중복·누락 방지.

사람 확인 게이트

큰 변경·배포·외부 전송·삭제는 진행 전 운영자 승인.

검증 게이트

공개·배포 전 팀원 리뷰 + 테스트(실검증·다관점·빈틈없는 테스트).

채널 연결 상세

슬랙: per-agent App + app_mentions:read·chat:write, Event URL /team/api/slack/events. 텔레그램: BotFather 봇 + chat_id.

더 알아보기: 팀 운영 규칙 rules/TEAM-OS.md · 팀 스킬 카탈로그 docs/B3OS_SKILLS.md · 슬랙 연결 docs/SLACK_SETUP.md