AI 업무 자동화

2026.09.25Hermes · DeskRPG · 호스팅어

이 글에는 쿠팡 파트너스 링크가 있으며, 구매 시 일정액의 수수료를 받습니다.

DeskRPG 설치 방법, Hermes AI 직원으로 회의·칸반 돌리기

Q: DeskRPG는 무료로 쓸 수 있나요?

DeskRPG와 Hermes는 오픈소스라 무료다. 다만 24시간 돌리려면 VPS 요금이 들고, AI 모델은 프로바이더 구독이나 종량제로 따로 낸다. VPS 요금은 바뀌므로 호스팅어 공식 안내를 확인해야 한다.

Q: DeskRPG를 쓰려면 Hermes를 따로 설치해야 하나요?

호스팅어 Docker 매니저로 배포하면 DeskRPG 컨테이너와 함께 Hermes 컨테이너가 같이 설치된다. DeskRPG에는 자체 AI 기능이 없어서 Hermes 게이트웨이가 반드시 필요하다. 이미 Hermes를 쓰고 있다면 게이트웨이 주소만 넣으면 기존 프로필이 그대로 직원으로 뜬다.

Q: DeskRPG 게이트웨이 연결 테스트가 실패하면 어떻게 하나요?

주소가 http://{Hermes 컨테이너명}:8642 형식인지부터 본다. https로 넣었거나 컨테이너 이름·포트가 틀린 경우가 많다. 인증키는 openssl rand -hex 32로 만들어 환경 변수에 넣은 값과 똑같아야 한다.

DeskRPG 설치부터 Hermes 프로필을 3D 사무실의 AI 직원으로 앉히고, 회의를 돌려 나온 후속 업무를 칸반 카드로 실행시키기까지의 전 과정을 순서대로 옮겼다. 내 컴퓨터에 명령어 두 줄로 까는 방법과 호스팅어 VPS에 Docker로 올려 24시간 돌리는 방법을 모두 다루고, 화면 하나하나를 번호 목록으로 풀었다.

DeskRPG 설치 방법, Hermes AI 직원으로 회의·칸반 돌리기 삽화 — 삽화 · 쓸모연구소

이 영상은 호스팅어(Hostinger) 후원으로 제작됐다. VPS 플랜 추천과 쿠폰 안내는 광고 맥락에서 나온 이야기이니 감안하고 읽는 편이 낫다.

DeskRPG와 Hermes, 무엇을 만드는 도구인가

영상이 보여 준 전체 흐름

Dante's Datalab의 64분짜리 영상은 설치에서 업무 실행까지를 한 번도 끊지 않고 보여 준다. 동작 단위로 쪼개면 195단계다. Hermes에 만들어 둔 프로필이 3D 사무실 안의 직원이 되고, 그 직원들이 회의를 하고, 회의에서 나온 후속 업무가 칸반 카드(할 일을 카드 한 장씩으로 만들어 열 사이를 옮기며 관리하는 보드)로 떨어져 실제로 실행된다.

DeskRPG는 화자가 직접 개발 중인 오픈소스다. 과거 2D 픽셀아트 버전을 Three.js(웹 브라우저에서 3D 그래픽을 그리는 자바스크립트 라이브러리) 기반의 3D 미니어처 사무실로 전면 재작성했다. 이번 버전에서 가장 신경 쓴 부분은 Hermes의 칸반과 크론(정해진 시각에 작업을 자동 실행하는 예약 기능)을 사무실 안에 그대로 구현한 것이라고 한다.

Hermes가 엔진, DeskRPG가 화면

구조는 단순하다. Hermes가 엔진이고, DeskRPG는 그 엔진을 보여 주고 만지는 인터페이스다. Hermes(Hermes Agent)는 Nous Research가 공개한 오픈소스 AI 에이전트로, 화자의 한 줄 정의로는 "내 서버에 직접 설치해서 사용하는 퍼스널 설치형 오픈소스 AI 에이전트"다. 기억도 칸반 카드도 일정도 전부 Hermes에 저장되므로 DeskRPG를 다시 설치해도 기록은 남는다.

설치 경로는 두 가지

로컬 설치는 명령어 두 줄이면 끝난다. 다만 노트북을 덮으면 크론이 그냥 지나가기 때문에, 화자는 월 몇 천 원에서 만 원대 VPS(가상 서버를 빌려 쓰는 호스팅 상품)를 권한다. 영상 후반은 호스팅어 VPS에 Docker로 올리고, 캐릭터·연결·직원·오피스 네 단계를 세팅하고, 회의를 돌린 뒤 그 결과를 카드로 자동 배분해 실행시키는 전 과정 실연이다.

소프트웨어 비용은 없다

DeskRPG와 Hermes 자체는 무료다. 둘 다 오픈소스이기 때문이다. 돈이 드는 곳은 서버와 AI 모델 사용료 두 군데이고, 아래 준비물 구획에서 따로 정리했다.

왜 지금 AI 팀메이트 플랫폼인가 (화자의 시장 분석)

설치 절차에 앞서 영상 앞부분은 시장 흐름을 짚는다. 아래 숫자는 전부 화자가 영상에서 말한 것이고, 원자료 링크는 영상에 제시되지 않았다.

같은 방향으로 움직인 제품들

올해 흐름은 이렇게 정리된다. 2월 Anthropic 에이전트 팀즈, 3월 Asana AI 팀메이츠, 7월 Block의 버즈, 8월 xAI 그록봇과 Hermes 본(Bond)모드가 거의 동시에 나왔다. 잭 도시가 "앞으로 모든 회사에는 사람과 에이전트가 같이 일할 공간이 필요해질 것"이라고 예측했다는 인용도 붙는다.

코딩 도구들도 같은 쪽으로 움직였다. Codex는 1월에 서브에이전트, Claude Code는 2월에 에이전트 팀즈, Copilot은 4월에 "플릿(fleet)"을 붙였다.

코딩 에이전트와 팀메이트 플랫폼의 차이

화자의 한 줄 정의는 이렇다. 코딩 에이전트는 "이 일 좀 해 줘"라고 요청받는 존재고, 팀메이트 플랫폼은 "이 일이 내 담당이야"라고 말하는 존재다.

차이는 하나뿐이다. 맥락을 세션(한 번의 대화 창)에 붙이느냐, 이름과 역할을 가진 프로필에 붙이느냐.

위임 비율과 작업 길이 수치

화자가 인용한 수치를 그대로 옮긴다.

일반 챗에서 일을 통째로 위임하는 비율은 작년 8월 49%에서 11월 45%로 내려갔다.
반대로 Claude Code에서의 위임 비율은 약 79%다.
블로그 글 하나를 쓸 때 일반 챗은 대화를 약 13번 주고받지만, CLI(터미널에서 명령어로 쓰는 방식)에서는 프롬프트 한 번으로 끝내는 비중이 높다.
에이전트가 혼자 처리할 수 있는 작업 길이는 2024년 이후 석 달마다 2배가 됐다.
GitHub에서 에이전트 오케스트레이션(여러 에이전트에게 일을 나눠 주고 조율하는 것) 관련 신규 레포는 2024년 94개, 2025년 1,762개, 올해 9월까지 11,537개다.
13개월 사이 주요 에이전트 7~8개가 위임 기능을 붙였다.
구글 연구팀은 260가지 구성으로 멀티에이전트를 실험했다. 병렬 작업은 최대 81% 좋아졌고, 순차 작업은 최대 70% 나빠졌다.
Anthropic 리서치 시스템은 일반 채팅 대비 토큰(AI가 글을 처리하는 단위)을 약 15배 쓴다.

해석은 이렇다. 위임은 검증이 쉬운 일부터 늘어난다. 코드는 테스트로 바로 검증되니 과감히 맡기고, 일상 업무는 검증 수단이 없어서 사람이 남아 있다는 것이다.

멀티에이전트가 잘 되는 두 가지 구조

Devin을 만든 코그니션이 작년 6월 "멀티에이전트 만들지 말라"는 글을 썼는데, 같은 인물이 올해 4월 "잘 되는 구조도 있다"고 다시 정리했다는 이야기가 나온다. 잘 되는 구조는 두 가지다.

읽기는 여러 에이전트가 나눠서 하고, 쓰기는 하나만 한다. 동시에 같은 걸 고치면 충돌이 병목이 된다.
검토 에이전트에게는 앞선 맥락을 많이 주지 않는다. 깨끗한 컨텍스트여야 독립적으로 문제를 찾는다. 안 그러면 인지 동화(앞선 판단에 끌려가 같은 결론을 내는 현상)가 생긴다.

이 원칙이 DeskRPG 회의 기능에서는 발언 순서 지정과 반대 의견 역할 부여로 구현돼 있다.

"AI 직원"이라고 부를 때의 위험

보스턴대와 BCG가 관리자 1,000명 이상을 대상으로 실험을 했다. 같은 오류 문서를 하나는 "AI 도구가 작성", 다른 하나는 "AI 직원이 작성"이라고 소개했더니 "AI 직원" 쪽에서 오류 발견율이 17% 낮았고, 책임을 AI에 넘기는 경향이 나타났다고 화자는 전한다.

사고 사례도 나온다. Replit 에이전트가 프로덕션 DB(실제 서비스가 쓰는 데이터베이스)를 삭제한 일, Cursor 에이전트가 백업까지 포함해 수초 만에 데이터를 지운 일, 하루 만에 AWS 비용이 약 900만 원 나온 일이다.

맡기기 전에 그어야 할 선 네 가지

원인은 AI가 멍청해서가 아니라 어디까지 해도 되는지를 정하지 않고 맡겼기 때문이라는 게 화자의 진단이다. 그어야 할 선은 넷이다.

권한 범위
비용 한도
삭제·배포 같은 위험 작업에서 사람이 확인하는 시점
최종 검토 주체

그래서 프로필을 "직원"이라고 부르면서도 못을 박는다. 관리하기 위한 방식일 뿐, 사람처럼 대하라는 뜻은 아니라고.

DeskRPG가 하는 일 세 가지

Hermes에 만들어 둔 프로필 하나가 직원 한 명이다. 지금까지는 각자 다른 터미널과 화면에서 따로 움직여서, 누가 뭘 하는지 보려면 창을 하나씩 열어야 했다. 화자가 "이것만 기억하라"고 한 것은 셋이다.

Hermes 프로필이 그대로 직원이 된다

기존 Hermes 프로필을 그대로 쓴다. AI는 전부 Hermes에서 돌고 DeskRPG는 공간과 인터페이스만 맡는다. 프로필이 그대로 NPC 캐릭터(사람이 조작하지 않는 등장인물)가 되고 성격도 따라온다.

벽의 게시판이 Hermes 칸반보드다

벽에 걸린 게시판이 곧 Hermes 칸반보드다. 터미널에서 카드를 만들면 사무실 게시판에 나타나고, 사무실에서 고치면 Hermes 쪽도 같이 바뀐다.

기록은 전부 Hermes에 남는다

기억도 카드도 일정도 Hermes 저장이다. Hermes가 엔진이다.

컨테이너(프로그램 하나를 필요한 환경째 담아 따로 돌리는 상자) 환경에 올릴 거라면 주의할 게 하나 있다. 컨테이너를 지우더라도 볼륨(컨테이너 밖에 데이터를 따로 저장해 두는 공간)은 반드시 남겨야 한다.

DeskRPG 설치 준비물과 비용

준비물 목록

PC 한 대. Windows든 Mac이든 같은 방식이다.
웹 브라우저. DeskRPG는 현재 브라우저 전용이고 모바일은 지원하지 않는다.
터미널 앱. Mac은 터미널, Windows는 명령 프롬프트나 PowerShell. 난수를 만들 때 쓴다.
Node.js와 npx가 되는 환경. 로컬 설치(경로 A)를 할 때만 필요하다. 설치 방법은 아래 경로 A 첫 구획에 따로 적었다.
AI 프로바이더(모델을 제공하는 회사) 계정 하나. 데모는 OpenAI Codex를 OAuth 로그인(비밀번호를 넘기지 않고 해당 서비스 화면에서 로그인을 허락하는 방식, 구독 플랜)으로 썼다. 직원 한 명당 각각 로그인해야 한다.
VPS로 갈 거라면 호스팅어 계정과 결제 수단. 화자 기준은 KVM2 플랜이다.
VPS로 갈 거라면 이메일 주소 하나. Traefik을 배포할 때 넣는다.

비용 구조

비용은 세 갈래로 갈린다.

DeskRPG와 Hermes: 무료.
VPS: 화자 표현으로 "월 몇 천 원에서 만 원대". 정확한 금액은 영상에서 말하지 않았고, 요금은 바뀌므로 호스팅어 공식 안내를 확인해야 한다.
AI 모델 사용료: 프로바이더 구독이나 종량제.

로컬로 갈까, VPS로 갈까

경로 A는 내 컴퓨터에 바로 설치하는 방법이다. 일단 만져만 보고 싶을 때 쓴다. 경로 B는 VPS에 올리는 방법이다. 크론을 걸어 두고 24시간 돌릴 거라면 이쪽이다.

화자의 권장 순서는 분명하다. 처음에는 노트북에 설치해 이것저것 만져 보다가, 어떤 식으로 쓰는지 감이 오면 그때 서버를 하나씩 고민하라는 것이다. 미니PC나 워크스테이션은 기기값·전기·네트워크·백업을 직접 챙겨야 하니 입문 단계에는 VPS가 낫다는 말도 덧붙인다.

어느 쪽으로 가든 "DeskRPG 관리자 계정 만들기" 구획부터는 공통이다.

경로 A: 내 컴퓨터에 DeskRPG 설치하기

Node.js부터 준비하기

영상은 이 부분을 건너뛴다. npx는 Node.js를 설치하면 함께 들어오는 실행 도구라서, Node.js가 없으면 아래 명령이 동작하지 않는다.

브라우저에서 nodejs.org에 접속한다.

확인: 내려받기 버튼이 보인다.
LTS(장기 지원) 버전 설치 파일을 내려받는다.

확인: 내 운영체제용 설치 파일이 받아진다.
설치 파일을 실행해 기본값으로 설치를 마친다.

확인: 설치 완료 화면이 뜬다.
터미널을 새로 열고 아래 명령을 입력한 뒤 엔터를 누른다.

명령어

node -v
npx -v

확인: 두 줄 모두 버전 번호가 출력되면 준비가 끝난 것이다.

설치 명령 실행하기

터미널 창을 연다. Mac은 응용 프로그램 > 유틸리티 > 터미널, Windows는 시작 메뉴에서 "명령 프롬프트".

확인: 검은(또는 흰) 창에 커서가 깜빡인다.
아래 명령어를 그대로 입력하고 엔터를 누른다.

명령어

npx deskrpg init

확인: 설치가 진행되고, 마지막에 다음 작업용 명령어(deskrpg start)를 안내하는 문구가 나온다.

DeskRPG 공개 저장소가 안내하는 패키지 이름은 붙여 쓴 deskrpg다. desk-rpg처럼 하이픈을 넣으면 패키지를 찾지 못한다.

서버 시작하고 첫 화면 열기

아래 명령어를 입력하고 엔터를 누른다.

명령어

npx deskrpg start

확인: 서버가 뜨면서 출력 안에 localhost:3000 주소가 표시된다.

브라우저로 접속하기

출력된 localhost:3000 주소를 복사한다.

확인: 클립보드에 주소가 담긴다.
웹 브라우저 주소창에 붙여 넣고 엔터를 누른다. 주소는 http://localhost:3000이다.

확인: DeskRPG 화면이 뜬다. 다음은 "DeskRPG 관리자 계정 만들기" 구획으로 건너뛴다.

공개 저장소 안내에 따르면 이 방식으로 설치한 DeskRPG는 설정과 데이터를 홈 폴더의 .deskrpg 폴더에 보관한다. 지우고 다시 깔 때 이 폴더를 남겨 두면 된다.

로컬 설치의 한계

이 경로의 한계는 분명하다. 노트북을 덮거나 컴퓨터가 꺼지면 작업도 멈춘다. 프로필과 기억이 사라지지는 않지만, 크론을 아침 8시에 걸어 놨는데 그 시간에 컴퓨터가 꺼져 있으면 그냥 지나간다.

경로 B: 호스팅어 VPS 상품 고르기

여기부터는 후원사 상품을 고르는 구간이다. 플랜 추천과 쿠폰 안내는 모두 광고 맥락의 화자 주장이라는 점을 다시 적어 둔다.

호스팅어 페이지로 들어가기

브라우저에서 DeskRPG 프로젝트 홈페이지에 접속한다. 화자는 "단다 컴퍼니 / DeskRPG"라고만 말했는데, 공개 저장소에 적힌 홈페이지는 deskrpg.com이다.

확인: 3D 요소가 들어간 프로젝트 소개 페이지가 열린다.
페이지에서 "호스팅어"라고 적힌 버튼을 찾는다.

확인: 버튼이 화면에 보인다. 이 링크로 들어가야 할인 쿠폰이 적용된다고 한다(광고 주장).
그 버튼을 클릭한다.

확인: 호스팅어 안내 페이지로 이동한다.
(선택) 페이지 언어를 한국어로 바꾼다.

확인: 안내 문구가 한글로 바뀐다.

주소창에 직접 입력하는 방법도 있다. 발음은 "hostinger.com/단태시-…"처럼 들리고 화면을 읽지 못해 확정하지 못했다. 한편 DeskRPG 저장소 안내문에는 hostinger.com/DANTE-DOCKER라는 추천(레퍼럴) 링크가 적혀 있다. 이 링크로 가입하면 개발자에게 수수료가 돌아가는 구조다.

KVM2 플랜 고르기

"상품을 선택하라"는 안내의 버튼을 클릭한다.

확인: VPS 상품 목록이 쭉 나열된다.
목록에서 KVM2 플랜을 찾는다. KVM1, KVM2, KVM4 순으로 나열된다.

확인: KVM2 항목에 vCPU 2코어, RAM 8GB 표기가 보인다.
KVM2의 구매 버튼을 클릭한다.

확인: 결제 화면으로 넘어간다.

KVM2를 고른 근거는 이렇다. 호스팅어가 안내하는 Hermes 최소 사양이 2코어 8GB라 이 정도를 기준선으로 잡으면 된다는 것이다. KVM1로도 돌아가긴 하지만 동시에 여러 개를 돌리면 빠듯할 수 있고, KVM1로 시작했다가 나중에 올려도 된다. DeskRPG 저장소 안내도 "KVM 2 이상, 메모리 8GB 권장"으로 같다.

결제 기간과 쿠폰 넣기

결제 기간에서 12개월 이상을 선택한다. 12개월 미만이면 쿠폰 할인이 적용되지 않는다는 것이 화자 설명이다.

확인: 12개월 또는 24개월 옵션이 선택 표시된다.
"쿠폰 코드가 있으신가요?" 항목을 클릭한다.

확인: 쿠폰 코드 입력칸이 펼쳐진다.
쿠폰 코드를 입력한다. 자막상 "단태시랩스"로 들리지만 정확한 철자는 영상 화면이나 설명란에서 확인해야 한다.

확인: 입력칸에 코드가 들어간다.
"적용하기" 버튼을 누른다.

확인: 금액이 할인가로 바뀐다. 할인율은 영상에서 말하지 않았다.
"계속하기" 버튼을 누른다.

확인: 로그인 단계로 넘어간다.

로그인하고 결제 마치기

소셜 로그인 또는 이메일 로그인으로 계정에 로그인한다. 계정이 없으면 이 화면에서 새로 만든다.

확인: 결제 단계 화면이 열린다.
결제를 완료한다. 영상은 "저는 미리 계정을 준비했다"며 이 구간을 건너뛴다.

확인: 결제 완료 화면이 뜬다.

VPS 만들고 Docker 매니저 열기

Docker는 프로그램을 컨테이너 단위로 설치하고 돌리는 도구이고, Docker 매니저는 호스팅어가 그 Docker를 웹 화면으로 다루게 해 주는 메뉴다.

호스팅어 대시보드(hPanel)에 로그인한다.

확인: 상단에 AI 에이전트·개발자 도구 등의 메뉴가 보이는 홈 화면이 뜬다.
"개발자 도구" 안의 VPS 메뉴를 클릭한다.

확인: VPS 목록 화면이 열린다.
목록에 고래 모양 아이콘의 VPS가 있는지 확인한다. 없으면 이 화면에서 새로 만든다.

확인: 결제 후 운영체제를 기본값으로 선택해 설치했다면 VPS가 하나 만들어져 있다.
그 VPS의 "관리" 버튼을 클릭한다.

확인: 왼쪽에 사이드 패널 메뉴가 있는 관리 화면으로 들어간다.
사이드 패널에서 "Docker 매니저"를 클릭한다. 화자가 "상당히 중요한 메뉴다, 여기서 모든 일이 진행된다"고 강조한 곳이다.

확인: 텅 빈 컨테이너 목록 화면이 나온다.

DeskRPG를 Docker로 배포하기

화자의 용어 설명으로는 컨테이너를 "프로그램이 설치된 PC 한 대"라고 생각하면 된다. 영상 녹화 시점에 DeskRPG는 원클릭 배포 카탈로그에 등록돼 있지 않아서 URL 방식으로 설치한다.

docker-compose.yml Raw 링크 구하기

docker-compose.yml은 컨테이너 여러 개를 어떻게 띄울지 적어 둔 설정 파일이다. 이 파일의 원본 주소를 Docker 매니저에 넣으면 알아서 설치된다.

DeskRPG의 GitHub 저장소 홈에 접속한다. 화자는 "단다 컴퍼니 / DeskRPG 레포지토리"라고만 말했는데, 실제 저장소는 github.com/dandacompany/deskrpg다.

확인: 저장소 파일 목록이 보인다.
파일 목록에서 docker-compose.yml 파일을 찾는다.

확인: 파일명이 목록에 보인다.
그 파일명을 클릭한다.

확인: 파일 내용 화면이 열린다.
화면 우측 상단의 "Raw" 버튼을 누른다.

확인: 서식 없는 원본 텍스트 페이지로 이동하고 주소창에 공개 링크가 뜬다.
주소창의 그 링크를 복사한다.

확인: 클립보드에 Raw 링크가 담긴다.

찾기 번거로우면 영상 설명란에 남겨 둔 링크를 써도 된다. 저장소 안내문에 적힌 Raw 링크는 아래와 같다.

프롬프트

https://raw.githubusercontent.com/dandacompany/deskrpg/refs/heads/master/docker-compose.yml

URL에서 컴포즈 가져오기

Docker 매니저 화면으로 돌아간다.

확인: 빈 컨테이너 목록 화면이 다시 보인다.
"URL에서 컴포즈 가져오기" 버튼을 누른다.

확인: URL 입력칸이 나타난다.
복사한 Raw 링크를 입력칸에 붙여 넣는다.

확인: 프로젝트 이름이 "desk-rpg"로 자동 입력된다.
"배포" 버튼을 누른다.

확인: 배포가 진행되고 비어 있던 목록에 컨테이너가 나타난다.

컨테이너 두 개 확인하기

생성된 프로젝트를 열어 컨테이너 개수를 확인한다.

확인: 처음에 4개가 생성됐다가 2개가 사라지고 2개만 남아 동작 중이다.

남는 둘은 DeskRPG 컨테이너와 Hermes 에이전트 컨테이너다. Hermes가 함께 설치된다는 뜻이다. 이 시점에는 아직 접근(열기) 버튼이 없는데, 도메인이 연결되지 않았기 때문이다.

Traefik으로 도메인과 HTTPS 붙이기

Traefik은 들어오는 접속을 알맞은 컨테이너로 연결해 주고 HTTPS(암호화된 접속) 인증서까지 챙기는 도구다.

Docker 매니저의 원클릭 목록에서 Traefik을 찾는다. 목록 바로 밑쪽에 있다.

확인: Traefik 항목이 보인다.
Traefik의 "배포" 버튼을 누른다.

확인: 이메일 주소 입력칸이 있는 폼이 뜬다.
이메일 주소를 입력한다. 본인이 쓰는 이메일이면 되고, 기본값 그대로 가도 크게 무방하다는 게 화자 설명이다.

확인: 입력칸에 이메일이 들어간다.
"배포" 버튼을 누른다.

확인: Traefik 배포 완료 알림이 뜬다.
프로젝트 목록을 확인한다.

확인: 프로젝트가 2개로 늘었고(DeskRPG 컨테이너 2개 + Traefik 컨테이너 1개), DeskRPG 줄에 없던 "열기" 버튼이 생겼다.

지금 "열기"를 눌러도 아직 접속되지 않는다. 환경 변수 설정이 남았다.

환경 변수 3개 넣기

환경 변수는 프로그램이 실행될 때 읽어 가는 설정값이다. 순서가 고정된 구간이라, 난수를 먼저 만들어야 첫 번째 칸을 채울 수 있다.

난수 만들기

터미널 창을 연다.

확인: 커서가 깜빡인다.
아래 명령어를 입력하고 엔터를 누른다. Mac과 Windows 모두 동일하게 쓸 수 있다.

명령어

openssl rand -hex 32

확인: 매우 긴 16진수 문자열이 한 줄 출력된다.

Windows에서 openssl을 찾을 수 없다는 오류가 나면 Git for Windows를 설치한 뒤 함께 깔리는 Git Bash 창에서 같은 명령을 치면 된다.

난수 저장해 두기

출력된 문자열을 복사해서 메모장 등에 따로 저장한다. 터미널 창을 바로 닫지 않는다.

확인: 메모장에 난수가 붙여 넣어져 있다.

이 난수는 두 군데에 똑같이 쓴다. 바로 아래 Hermes API 키 칸, 그리고 뒤의 "게이트웨이 주소와 인증키" 구획에서 넣는 API 인증키 칸이다. 화자가 강조한 대목이다.

환경 설정 폼 열기

Docker 매니저에서 DeskRPG 줄의 "관리" 버튼을 누른다.

확인: DeskRPG 프로젝트 상세 화면이 열린다.
화면 가장 하단까지 스크롤한다.

확인: "환경" 항목이 보인다.
"환경"을 클릭한다.

확인: 환경 변수 목록과 입력 폼이 쭉 나타난다. 터미널을 열지 않고 콘솔에서 채울 수 있는 폼이다.

세 칸 채우고 다시 배포하기

Hermes API 키 칸(저장소 안내의 변수 이름은 HERMES_API_KEY)에 방금 저장한 난수를 붙여 넣는다.

확인: 칸에 긴 16진수 값이 들어간다.
화면 가장 위 내비게이션 바에 표시된 내 VPS 도메인을 복사한다. 이 도메인은 사람마다 다르다("저랑 다를 거예요"). 호스팅어 VPS라면 보통 srv 뒤에 숫자가 붙고 .hstgr.cloud로 끝나는 형태다.

확인: 클립보드에 도메인이 담긴다.
Traefik 호스트 칸(TRAEFIK_HOST)에 그 도메인을 붙여 넣는다.

확인: 칸에 도메인이 들어간다.
목록 가장 아래의 Hermes 대시보드 비밀번호 칸(HERMES_DASHBOARD_PASSWORD)에 본인이 기억할 비밀번호를 입력한다.

확인: 칸에 비밀번호가 들어간다.
"저장 후 배포" 버튼을 누른다.

확인: DeskRPG 프로젝트가 재배포되고 잠시 뒤 배포 완료 표시가 뜬다.
"열기" 버튼을 눌러 접속을 확인한다.

확인: 3D 미니어처 디자인의 DeskRPG 홈 화면이 열린다.

세 칸의 역할은 이렇다. Hermes API 키는 DeskRPG가 Hermes에 접근하기 위한 키다. 단순 에이전트 접속은 게이트웨이만으로 되지만, Hermes의 칸반·크론 같은 도구까지 쓰려면 추가 권한이 필요해서 이 키로 둘을 연결한다. 대시보드 비밀번호는 나중에 Hermes 대시보드에 직접 들어갈 때 필요하고, 화자는 뒤에서 만들 관리자 계정 비밀번호와 같은 값으로 맞췄다.

방화벽으로 포트 막기

목적은 보안 등급을 올려 아무 포트나 접근하지 못하게 막는 것이다. 포트는 서버로 들어오는 문 번호라고 생각하면 된다. 기본적으로 모든 포트가 막혀 있고, 필요한 문만 하나씩 열어 준다.

방화벽 만들기

VPS 관리 화면의 "보안" → "방화벽" 메뉴로 이동한다.

확인: 방화벽 목록 화면이 열린다.
"방화벽" 생성 버튼을 누른다.

확인: 방화벽 이름 입력창이 뜬다.
방화벽 이름을 임의로 입력한다. 영상에서는 "desk-rpg"로 지었다.

확인: 이름이 입력된다.
"만들기"를 눌러 방화벽을 생성한다.

확인: 목록에 방화벽이 한 줄 생긴다.
그 줄의 점 3개 버튼을 누른다.

확인: 메뉴가 펼쳐진다.
메뉴에서 "수정"을 클릭한다.

확인: 규칙을 추가하는 가운데 섹션이 나타난다.

22번 포트(SSH) 열기

동작(액션)은 "수락" 그대로 둔다.

확인: "수락"이 선택돼 있다.
프로토콜을 TCP로 선택한다.

확인: TCP가 선택된다.
포트에 22를 입력한다. 터미널 SSH(원격으로 서버에 접속하는 방식) 포트다.

확인: 포트 칸에 22가 들어간다.
출처(Source)를 "어디서나"로 선택한다.

확인: "어디서나"가 선택된다.
"규칙 추가"를 누른다.

확인: 규칙 목록에 22번 줄이 하나 추가된다.

80번(HTTP)과 443번(HTTPS) 열기

프로토콜을 다시 TCP로 선택한다.

확인: TCP가 선택된다.
포트에 80을 입력한다. 웹(HTTP) 포트다.

확인: 80이 입력된다.
출처를 "어디서나"로 두고 "규칙 추가"를 누른다.

확인: 규칙이 2줄이 된다.
프로토콜을 다시 TCP로 선택한다.

확인: TCP가 선택된다.
포트에 443을 입력한다. HTTPS 포트다.

확인: 443이 입력된다.
출처를 "어디서나"로 두고 "규칙 추가"를 누른다.

확인: 규칙이 총 3줄(22 / 80 / 443)이 된다.

방화벽 켜고 접속 확인하기

이전 화면으로 돌아간다.

확인: 방화벽 목록에 방금 만든 방화벽이 보인다.
그 줄의 스위치 버튼을 눌러 "사용 중"으로 바꾼다.

확인: 스위치가 켜짐 상태로 바뀐다.
다시 Docker 매니저로 돌아간다.

확인: 컨테이너 목록 화면이 보인다.
상단의 "열기" 버튼을 누른다.

확인: DeskRPG 홈페이지에 여전히 정상 접속된다. 방화벽을 켠 뒤에도 443과 80이 열려 있어 들어가진다.

스위치를 켜야 방화벽이 실제로 활성화된다. 규칙만 만들고 끝내면 적용되지 않는다.

DeskRPG 관리자 계정 만들기 (경로 A·B 공통)

처음 접속한 사람이 관리자가 된다. 서버에 올렸다면 남보다 먼저 들어가야 한다.

첫 접속 화면에서 표시 이름을 입력한다. 영상에서는 한글로 "단테"라고 적었다.

확인: 이름 칸이 채워진다.
비밀번호를 입력한다. 화자는 환경 변수에 넣은 Hermes 대시보드 비밀번호와 같은 값으로 맞췄다.

확인: 비밀번호 칸이 채워진다.
"시작하기" 버튼을 누른다.

확인: DeskRPG 홈 화면으로 들어가고 사이드 패널에 메뉴 4개가 보인다.
사이드 패널 메뉴 4개의 순서를 확인한다. 내 캐릭터 → 연결 → 직원 → 오피스다.

확인: 4개 메뉴가 모두 보인다. 이 순서대로 하나씩 만들어 나가야 한다.

내 캐릭터 만들기

사이드 패널에서 "내 캐릭터"를 클릭한다.

확인: 3D 캐릭터 선택 화면이 열린다.
마음에 드는 캐릭터 하나를 고른다. 미리 만들어진 3D 캐릭터를 의상·성별에 따라 고르면 된다. 영상에서는 "규민"을 선택했다.

확인: 선택한 캐릭터가 하이라이트된다.
캐릭터 이름을 입력한다. 영상에서는 "단테".

확인: 이름 칸이 채워진다.
내 정보(소개) 칸에 나에 대한 설명을 입력한다.

확인: 소개 칸이 채워진다.
"만들기" 버튼을 눌러 저장한다.

확인: 캐릭터가 저장되고 내 캐릭터로 등록된다.

내 소개 칸이 중요한 이유

소개 칸의 정보가 AI 컨텍스트(AI가 답할 때 함께 읽는 배경 정보)로 들어가서 직원들이 내가 어떤 사람인지 알게 된다. 나중에 캐릭터가 내 이름을 부르는 것도 이 때문이다. 영상 예시는 "단테랩스 대표 단테입니다"에 간단한 설명을 붙인 정도였고, 더 자세히 써도 된다. 아래는 따라 쓰기 쉽게 만든 예시다.

프롬프트

나는 단테랩스 대표 단테다.
AI 자동화 강의와 뉴스레터를 만든다.
보고는 결론부터 짧게, 숫자에는 출처를 붙여 주면 좋겠다.
비용이 드는 작업이나 삭제·배포는 반드시 먼저 물어봐 달라.

마지막 줄처럼 "먼저 물어봐 달라"는 선을 소개에 적어 두면, 앞에서 본 네 가지 선(권한·비용·위험 작업 확인·최종 검토) 중 일부를 직원 모두에게 한 번에 걸 수 있다.

Hermes 게이트웨이 연결하기

DeskRPG에는 자체 AI 기능이 없다. 엔진으로 Hermes를 쓰도록 만들어져 있다. 게이트웨이는 DeskRPG가 Hermes에 말을 거는 출입구 주소다.

원격 연결 고르기

사이드 패널에서 "연결"을 클릭한다.

확인: 게이트웨이 목록 화면이 열린다.
"새 게이트웨이" 버튼을 누른다.

확인: 연결 방식 선택 화면이 나온다.
"원격 연결"을 선택한다. 컨테이너끼리는 서로 다른 컴퓨터이기 때문에 원격이다.

확인: 원격 연결이 선택된다.
연결 방식에서 "게이트웨이 주소 연결"을 선택한다. SSH 방식도 있지만 Docker 컨테이너 환경에서는 반드시 이쪽이다.

확인: 게이트웨이 주소 입력 폼이 나온다.
표시 이름을 입력한다. 영상에서는 "VPS 헤르메스"로 적었다. 아무 이름이나 된다.

확인: 이름 칸이 채워진다.

게이트웨이 주소와 인증키 넣기

다른 탭에서 Docker 매니저를 열어 Hermes 컨테이너의 이름을 확인한다. 영상 기준 이름 형태는 desk-rpg-hermes다.

확인: 컨테이너 정보에서 이름을 눈으로 확인한다.
게이트웨이 주소 칸에 아래 형식으로 입력한다.

프롬프트

http://desk-rpg-hermes:8642

확인: 주소 칸에 위 형식의 값이 들어간다.

https가 아니라 http다. 화자가 "S 없이"라고 못 박는다. 컨테이너 이름 부분은 방금 확인한 본인 값으로 바꾸고, 포트 8642는 고정이다.

인증키 넣고 연결하기

API 인증키 칸에 메모장에 저장해 둔 난수를 붙여 넣는다. 환경 변수의 Hermes API 키로 넣었던 값과 똑같은 값이다.

확인: 인증키 칸이 채워진다.
"주소로 연결" 버튼을 누른다.

확인: "연결 확인됨" 문구가 뜬다.

연결 테스트하기

생성된 게이트웨이를 클릭해 상세로 들어간다.

확인: 게이트웨이 상세 화면이 열린다.
"연결 테스트" 버튼을 누른다.

확인: 초록색 "연결됨" 표시가 뜬다.
(확인용) Hermes 대시보드 바로가기 버튼을 눌러 본다.

확인: Hermes 대시보드 로그인 화면이 뜬다.
(선택) 사용자에 admin, 비밀번호에 환경 변수로 넣은 대시보드 비밀번호를 입력한다.

확인: Hermes 에이전트 대시보드에 접근된다. 화자는 "직접 쓸 건 아니니 일단 닫아 두겠다"며 닫았다.

초록색이 안 뜨면 주소(http인지, 컨테이너 이름, 8642 포트)와 인증키 값을 다시 본다.

첫 번째 AI 직원 고용하기

프로필 만들기

사이드 패널에서 "직원"을 클릭한다. 홈 화면의 "직원 관리 열기" 버튼을 눌러도 같다.

확인: 게이트웨이마다 박스가 하나씩 있는 화면이 나온다. Hermes가 여러 곳에 있을 수 있어서 게이트웨이는 여러 개 만들 수 있다.
"새 직원 고용" 버튼을 누른다.

확인: 프로필 이름 입력 화면이 나온다.
직원(프로필) 이름을 입력한다. 영상 예시는 Noah이고 화자는 영문 사용을 권한다.

확인: 이름 칸이 채워진다.
"프로필 만들기" 버튼을 누른다.

확인: 프로필이 생성된다.
"다음 단계" 버튼을 누른다.

확인: 인격(페르소나) 입력 화면이 나온다.

새로 설치한 Hermes에는 기본 프로필이 하나 있지만 영상에서는 그걸 쓰지 않는다.

인격(페르소나) 적기

인격 내용을 입력한다.

확인: 입력칸이 채워진다.
"저장"을 누른다.

확인: 인격이 저장된다. Hermes 쪽에도 함께 설정된다.
"다음"을 누른다.

확인: 외형 선택 화면이 나온다.

Hermes를 써 본 사람이라면 SOUL.md 파일(Hermes에서 프로필의 성격과 말투를 적어 두는 파일)에 넣던 정보가 여기 들어간다. 영상 예시는 "당신은 Noah, 단테랩스의 리서치 담당자다"에 설정을 덧붙인 형태였고, 나중에 고칠 수 있다. 영상은 전문을 보여 주지 않으니 아래 예시를 고쳐 써도 된다. 회의 결과의 질을 올리려면 성향과 분야를 적어 두라는 팁이 뒤에 나오는데, 그 팁을 반영했다.

프롬프트

당신은 Noah, 단테랩스의 리서치 담당자다.
분야: AI 자동화 도구와 업무 사례 조사.
성향: 근거가 없으면 주장하지 않는다. 출처 링크를 꼭 붙인다.
말투: 한국어, 존댓말, 3문장 이내로 짧게.
하지 않는 일: 글을 최종 편집하지 않는다(콘텐츠 담당 몫). 결제·삭제가 필요한 일은 대표에게 먼저 묻는다.

외형 고르기

직원의 3D 캐릭터 외형을 하나 고른다. 영상 예시는 "이안".

확인: 선택한 외형이 하이라이트된다.
"외형 저장"을 누른다.

확인: 외형이 저장된다.
"다음"을 누른다.

확인: AI 모델(프로바이더) 선택 화면이 나온다. 여기서는 무조건 AI 프로바이더가 연결돼 있어야 한다.

AI 모델에 로그인하기

프로바이더 목록에서 OpenAI Codex를 찾는다.

확인: Codex 항목이 보인다.
Codex를 선택한다.

확인: "로그인" 안내가 표시된다.
"로그인" 버튼을 누른다.

확인: 인증 코드가 화면에 표시된다.
표시된 코드를 복사한다.

확인: 클립보드에 코드가 담긴다.
인증 페이지를 연다.

확인: 코드 입력 화면이 열린다.
코드를 붙여 넣고 "계속"을 누른다.

확인: 로그인이 완료된다.
DeskRPG 화면으로 돌아와 잠시 기다린다.

확인: "연결됨" 표시가 뜨고, 조금 더 기다리면 상단의 "인증 안 됨"이 사라진다.

프로바이더 목록에는 여러 회사가 있다. 대부분은 API 키 종량제(쓴 만큼 돈을 내는 방식)이고, OpenAI·그록·미니맥스 등은 OAuth 로그인으로 구독 플랜을 쓸 수 있다.

모델과 추론 강도 정하기

모델 드롭다운에서 사용할 모델을 선택한다. 영상에서 고른 값은 자막상 "GPT 5.6 솔로"로 들린다.

확인: 드롭다운에 모델명이 표시된다.
추론 강도(답하기 전에 얼마나 오래 생각할지 정하는 설정)를 Low로 설정한다.

확인: 추론 강도가 Low로 바뀐다.
(선택) 하위 설정을 펼쳐 도구·스킬별 프로바이더를 확인한다. Hermes 에이전트 셋업과 같은 구성이고 화자는 기본값 그대로 갔다.

확인: 세부 설정 항목이 펼쳐진다.
"저장"을 누른다.

확인: 설정이 저장된다.
"완료"를 누른다.

확인: 직원 한 명(Noah)이 세팅 완료 상태로 목록에 뜬다.
그 직원의 "연결 테스트" 버튼을 누른다. 처음에는 "테스트 안 함" 상태로 표시된다.

확인: "정상" 표시가 뜬다.

두 번째 직원 추가하기

여기서 화자가 한 번 더 강조한다. 직원마다 각각 모델 로그인을 해 줘야 한다. 첫 직원의 로그인이 자동으로 공유되지 않는다.

프로필과 인격

"새 직원 고용" 버튼을 다시 누른다.

확인: 프로필 이름 입력 화면이 나온다.
두 번째 이름을 입력한다. 영상 예시는 Oliver. Hermes에 이미 만들어 둔 프로필이 있으면 그걸 바로 가져올 수도 있다.

확인: 이름 칸이 채워진다.
"프로필 만들기"를 누른다.

확인: 프로필이 생성된다.
"다음 단계"를 누른다.

확인: 인격 입력 화면이 나온다.
두 번째 직원의 페르소나를 입력한다. 영상 예시는 "Oliver는 콘텐츠 작성 담당"에 말투·세계관·하는 일을 붙인 것이다.

확인: 입력칸이 채워진다.
"저장" 후 "다음"을 누른다.

확인: 외형 선택 화면이 나온다.

역할이 겹치지 않게 나누는 게 요령이다. 영상에서는 Noah가 리서처, Oliver가 콘텐츠 작성이었다. 앞의 Noah 예시와 짝을 맞추면 이렇게 쓸 수 있다.

프롬프트

당신은 Oliver, 단테랩스의 콘텐츠 작성 담당이다.
분야: AI 자동화를 처음 접하는 직장인용 글.
성향: 전문용어는 처음 나올 때 풀어 쓴다. 예시를 하나씩 붙인다.
말투: 한국어, 친근한 존댓말.
하지 않는 일: 조사는 Noah에게 맡기고, 근거 없는 숫자는 쓰지 않는다.

외형과 모델 로그인

첫 직원과 다른 외형을 고른다. 영상 예시는 "성호".

확인: 외형이 선택된다.
"외형 저장" 후 "다음"을 누른다.

확인: 프로바이더 화면이 나온다.
Codex를 선택하고 "로그인"을 누른다.

확인: 인증 코드가 표시된다.
코드를 복사해 인증 페이지에서 인증한다.

확인: "연결됨"이 뜨고 잠시 뒤 드롭다운이 갱신된다.
첫 직원과 같은 모델을 선택한다.

확인: 모델이 선택된다.
추론 강도를 Low로 맞춘다.

확인: Low로 설정된다.
하위 설정은 기본값으로 두고 "저장" 다음 "완료"를 누른다.

확인: 직원이 총 2명 세팅된다.
두 번째 직원의 "연결 테스트"를 누른다.

확인: 정상 표시가 뜬다.

오피스(사무실) 만들기

이름과 공개 범위 정하기

사이드 패널에서 "오피스"를 클릭한다.

확인: "현재 만들어진 사무 공간이 없다"는 빈 화면이 나온다.
"오피스 만들기" 버튼을 누른다.

확인: 사무실 생성 폼이 열린다.
사무실 이름을 입력한다. 영상 예시는 "우리 사무실".

확인: 이름 칸이 채워진다.
설명을 입력한다. 영상에서는 간단히 "우리 사무실"만 적었고 더 자세히 써도 된다.

확인: 설명 칸이 채워진다.
그룹 설정은 기본값 그대로 둔다.

확인: 그룹이 기본 상태다.
공개 범위를 선택한다. 비공개와 공개 중 하나이고 영상에서는 공개를 골랐다.

확인: 선택한 값이 표시된다.

맵과 AI 게이트웨이 고르기

빌트인 맵 5종 중 하나를 고른다. 영상 선택은 "크리에이티브 스튜디오"이고 상당히 큰 맵이다.

확인: 맵이 선택되고 프리뷰가 보인다.
(선택) 프리뷰에서 Ctrl 키를 누른 채 마우스를 돌려 맵을 여러 각도에서 확인한다.

확인: 3D 맵이 회전한다.
AI 게이트웨이 항목에서 앞서 만든 게이트웨이를 목록에서 선택한다. 직접 입력도 되지만 미리 만든 것을 고른다.

확인: 게이트웨이 이름이 선택된다.
"연결 테스트"를 누른다.

확인: "연결됨"이 뜬다.
"생성" 버튼을 누른다.

확인: 맵이 생성되고 바로 접속된다. 직원들이 정해진 자리에 앉아 있다.

나머지 맵 4종의 이름은 영상에서 말하지 않았다. 의자마다 1번, 2번, 3번 식으로 번호가 있고 직원이 그 순서대로 배치된다. 게이트웨이 선택은 화자가 "이게 중요하다"고 한 대목이다. 여기서 빠뜨리면 사무실은 만들어져도 직원이 대답하지 않는다.

오피스 안에서 AI 직원과 대화하기

걸어가서 말 걸기

방향 조작으로 캐릭터를 걸어서 이동시킨다. 맵에는 대표실, 촬영 스튜디오, 회의실 같은 공간이 있다.

확인: 내 캐릭터가 맵 안에서 움직인다.
의자 같은 사물을 클릭한다.

확인: 캐릭터가 그 자리에 앉는다.
대화하고 싶은 직원 근처까지 이동한다.

확인: 인접하면 옆에 채팅창이 활성화된다.
채팅창에 메시지를 입력한다. 영상 예시는 "안녕, 이름이 어떻게 돼?"였다.

확인: 입력칸에 문장이 들어간다.
엔터를 눌러 보낸다.

확인: "생각 중" 표시 후 직원이 자기 이름을 밝히며 답한다. 내 캐릭터 소개를 넣었다면 내 이름까지 알아본다.

NPC는 산책 기능으로 스스로 돌아다니고, 마주치면 서로 인사와 스몰토크를 한다.

걷지 않고 대화하는 방법

(대안) 좌측 목록에서 대화할 캐릭터 이름을 클릭한다.

확인: 내 캐릭터가 그 캐릭터 위치로 자동 이동한다.
(대안) 캐릭터를 호출한다.

확인: 호출된 캐릭터가 내 위치로 달려와 말을 건다.
(선택) 좌측 패널의 "새 방"을 눌러 그룹 채팅방을 만든다.

확인: 그룹이 좌측 목록에 추가된다.
(선택) 우측 채팅 패널을 접거나 펼친다.

확인: 패널이 접히고 펼쳐진다.

멤버가 많으면 부분 그룹을 여러 개 만들 수 있고, 오피스 전체에 방송하듯 말하는 옵션도 있다.

칸반·크론·결과물 메뉴 살펴보기

칸반 보드와 수행 기능

벽면에 붙어 있는 칸반 보드를 클릭한다. 상단 메뉴의 "칸반"을 눌러도 같은 화면이다.

확인: 칸반 보드가 뜬다. Hermes의 칸반과 동일하게 연동돼 있다.
칸반에서 카드를 만들거나 카드 상태를 옮긴다.

확인: 카드 상태가 바뀌고 Hermes 쪽에도 동기화된다.
(선택) 칸반의 "수행" 기능을 연다.

확인: 목표·주 워커·검증자를 지정하는 폼이 뜬다.
목표, 주 워커(담당), 검증자를 각각 지정한다.

확인: 세 항목이 채워진다.
"수행 시작"을 누른다.

확인: 카드들이 자동으로 분배·배치된다.

"수행"은 카드 실행을 맡기는 기능이다. Hermes 네이티브 화면에는 없는 DeskRPG 전용 기능이라고 한다. 검증자를 따로 두는 구조는 앞에서 본 "검토 에이전트에게는 맥락을 적게" 원칙과 맞닿아 있다.

크론·결과물·판단 모음

상단 메뉴에서 "크론"을 연다.

확인: 스케줄링된 업무 목록이 보인다.
상단 메뉴에서 "결과물"을 연다.

확인: 채팅·크론·칸반으로 만들어진 마크다운 문서, 이미지, 링크가 모여서 보인다.
"판단 모음" 메뉴를 연다.

확인: 처음에는 "지금은 답할 것이 없습니다"로 비어 있다.

판단 모음에는 NPC가 "어떻게 할까요?"라고 사람에게 물은 의사결정이 쌓인다. 앞의 네 가지 선 가운데 "위험 작업에서 사람이 확인하는 시점"이 여기서 실제로 작동한다.

직원 퇴근시키기와 모델 바꾸기

(필요할 때) 안 쓰는 NPC를 "퇴근"시킨다.

확인: 그 NPC가 맵에서 사라진다. "출근"으로 되돌릴 수 있다.
(필요할 때) "프로필 설정"을 눌러 모델을 변경한다.

확인: 모델 변경 화면이 열린다.

AI 회의 실행하기

회의실로 모으기

회의실까지 캐릭터를 이동시킨다. 상단의 "회의실" 버튼을 눌러도 된다.

확인: 화면 위쪽에 "회의 시작"이 표시된다.
"회의 시작" 버튼을 누른다.

확인: 멤버들이 회의실로 달려와 자리에 앉고 회의 패널이 뜬다.

참여자·턴 수·모드 정하기

회의 패널에서 참여시킬 멤버를 선택한다.

확인: 참여자 체크가 표시된다.
최대 턴 수를 입력한다. 영상은 시간 관계상 5로 설정했다. 턴이 많으면 오래 걸린다.

확인: 턴 수 칸에 값이 들어간다.
시작 모드를 고른다. 수동은 다음 턴에 발언할 사람을 내가 그때그때 클릭해 넘기는 방식이고, 자동은 턴이 알아서 넘어간다.

확인: 선택한 모드가 표시된다.

참여자를 고를 때의 팁이 하나 있다. 비판자 역할을 하는 참여자를 섞으면 대화가 더 견고해진다.

회의 주제 프롬프트 쓰기

회의 주제를 입력한다. 영상에서 쓴 프롬프트 구조를 그대로 옮기면 아래와 같다.

프롬프트

목표: 단테랩스 10월 뉴스레터 발행
독자: AI 자동화를 아직 업무에서 못 써 본 직장인
정할 것:
  - 각자 주제 후보 1개와 이유
  - 서로의 후보에서 걱정되는 점 1가지
  - 주제를 하나로 확정하고 필요한 일·담당·순서
결과물: 확정 주제 한 줄 + 담당과 순서가 붙은 후속 업무를 마크다운 파일로
발언은 2~3문장, 한국어로

확인: 주제 입력칸이 채워진다.

여기서 "결과물"을 명시해야 회의 뒤에 후속 과제를 카드로 부여할 수 있다. 화자가 가장 강조한 대목이다. 페르소나에 성향과 분야를 적어 두면 회의 결과의 질이 올라간다는 팁도 같이 나온다.

같은 틀을 다른 업무에 옮기면 이렇게 된다. 목표·독자·정할 것·결과물 네 줄만 바꾸면 된다.

프롬프트

목표: 다음 주 신규 강의 홍보 계획 수립
독자: 지난 강의 수강생과 뉴스레터 구독자
정할 것:
  - 각자 홍보 채널 후보 1개와 이유
  - 서로의 후보에서 비용이나 위험이 걱정되는 점 1가지
  - 채널을 두 개로 좁히고 필요한 일·담당·순서
결과물: 확정 채널 두 줄 + 담당과 순서가 붙은 후속 업무를 마크다운 파일로
발언은 2~3문장, 한국어로

회의 진행과 종료

"회의 시작" 버튼을 누른다.

확인: 회의가 자동으로 시작되고 "○○ 발언 중" 표시와 함께 발언이 하나씩 올라온다.
(필요하면) 멈춤 버튼을 눌러 회의를 일시정지한다.

확인: 회의가 멈추고 내용을 천천히 읽을 수 있다. 재생 버튼으로 재개한다.
(선택) 회의 중간에 내가 직접 발언을 끼워 넣는다.

확인: 내 발언이 대화에 추가되고 흐름이 바뀐다.
설정한 최대 턴 수까지 회의가 끝나기를 기다린다.

확인: 턴 수를 넘지 않고 회의가 종료되며 요약(통계·주요 주제·결론)과 결정 사항이 나온다.

회의 결과를 칸반 카드로 실행하기

후속 업무 카드 등록하기

회의 결과 화면에서 후속 업무 카드 목록을 확인한다.

확인: 확정 주제 한 줄과 함께 후속 업무가 카드로 떨어져 있다. 영상 데모는 4건이었다.
각 카드에 지정된 핸드오프 프로필(담당자)을 확인한다. 필요하면 바꿀 수 있고 안 바꿔도 된다.

확인: 카드마다 담당 프로필이 미리 세팅돼 있다.
등록할 카드의 체크박스를 확인한다.

확인: 체크된 카드만 등록 대상이 된다.
등록할 서브 프로젝트 이름을 확인한다.

확인: 이름이 자동으로 채워져 있다. 그대로 써도 되고 바꿔도 된다.
"프로젝트에 등록" 버튼을 누른다.

확인: 카드 몇 건을 등록했다는 메시지가 뜨고, 회의가 자동 종료되며 회의 화면에서 빠져나온다.

구조상 칸반 보드 하나가 프로젝트 하나이고, 보드 안에 서브 프로젝트가 있다.

카드를 "준비됨"으로 옮겨 실행하기

칸반 보드를 연다.

확인: 등록된 카드들이 보인다. 영상에서는 처음에 "막힘" 상태로 들어가 있었다.
실행할 카드를 "준비됨" 열로 드래그해 옮긴다.

확인: 옮기자마자 디스패치(담당 직원에게 작업 배정)되어 "실행 중"으로 바뀐다.
다른 직원의 카드도 같은 방식으로 "준비됨"(To Do)으로 옮긴다.

확인: 해당 직원이 작업을 준비하고 시작한다.

"준비됨"으로 옮기는 동작이 실행 트리거다. 옮기지 않으면 카드는 실행되지 않는다.

실행 로그와 선행·후행 작업

카드를 클릭해 상세 화면을 연다.

확인: 상태 수정, 선행·후행 작업 연결 정보가 보인다. Hermes와 동일하게 동기화돼 있다.
상세에서 실행 로그를 연다.

확인: 현재 세션에서 처리 중인 로그가 실시간으로 찍힌다.
(선택) 카드에 댓글을 달아 코멘트를 남긴다.

확인: 댓글이 등록된다.
선행 작업이 끝날 때까지 기다린다.

확인: 선행 카드가 "완료"로 넘어가고 결과물(마크다운 파일)이 카드에 붙는다. 동시에 후행 작업이 "준비됨"으로 자동 전환된다.
후행 카드를 선택하고 "배정"을 눌러 이어서 실행시킨다.

확인: 후행 카드가 실행 중으로 들어간다.
(선택) 뷰를 목록이나 타임라인으로 전환한다.

확인: 보드, 목록, 타임라인 세 가지 뷰로 같은 작업을 볼 수 있다.

영상의 흐름은 "가상 회의 메모와 전체 구성안 작성" 다음 "자동화 예시 및 보안 주의사항 작성", 그다음 "초보 독자 관점에서 원고 통합 교정"이었다. 앞 카드의 결과물이 다음 카드의 재료가 되는 식이다.

보고 받고 결과물 꺼내기

작업을 마친 직원이 나에게 오는 것을 확인한다.

확인: NPC가 내 위치로 달려와 보고한다.
그 직원의 "카드" 탭을 누른다.

확인: 그 직원에게 배정된 카드 목록이 보인다. 크론이 있으면 크론 목록도 같이 보인다.
카드를 열어 처리 결과를 확인한다.

확인: 직원이 처리한 카드 내용과 결과물이 보인다.
상단 메뉴의 "결과물"을 연다.

확인: 직원별 결과물이 모여서 보인다.
마크다운 파일을 클릭해 보고서 내용을 연다.

확인: 보고서 전문이 표시된다.
필요하면 다운로드나 복사 버튼을 누른다.

확인: 파일이 내려받아지거나 클립보드에 복사된다.
일이 끝난 직원을 자기 자리로 복귀시킨다.

확인: NPC가 원래 자리로 돌아간다.

결과물은 종류별로 쌓인다. 이미지는 미디어로, 일반 파일은 마크다운으로, 리서치하거나 크롤링한 사이트는 링크로 각각 모인다.

DeskRPG 설치가 끝났는지 확인하는 체크리스트

VPS 경로라면 Docker 매니저에 DeskRPG와 Hermes 컨테이너가 남아 있고, Traefik은 그 뒤에 따로 추가된다.
환경 변수 3개(Hermes API 키, Traefik 호스트, Hermes 대시보드 비밀번호)를 넣고 재배포했다.
openssl rand -hex 32로 만든 난수를 환경 변수와 게이트웨이 인증키 두 곳에 같은 값으로 넣었다.
방화벽에 TCP 22 / 80 / 443 규칙 3개를 만들고 스위치를 켰다.
"열기" 버튼으로 DeskRPG 3D 홈에 접속된다.
관리자 계정을 만들었다. 첫 접속자가 관리자다.
사이드 패널 4단계를 내 캐릭터 → 연결 → 직원 → 오피스 순서로 끝냈다.
게이트웨이 주소를 http://{컨테이너명}:8642로 넣었고(https 아님) 연결 테스트가 초록색 "연결됨"이다.
직원마다 각각 프로바이더 로그인을 했고 각 직원의 연결 테스트가 "정상"이다.
오피스를 만들 때 AI 게이트웨이를 지정했다.
직원에게 말을 걸었을 때 내 이름을 알아본다. 내 캐릭터 소개가 컨텍스트에 들어갔다는 뜻이다.
회의 주제에 "결과물"을 명시했다. 안 하면 후속 카드가 안 나온다.
칸반 카드를 "준비됨"으로 옮겨 실행이 시작되는 것을 확인했다.

DeskRPG 설치할 때 자주 막히는 곳

Docker 매니저 원클릭 목록에 DeskRPG가 안 보인다

영상 녹화 시점에는 원클릭 배포 카탈로그에 등록되지 않았다. "URL에서 컴포즈 가져오기"로 docker-compose.yml Raw 링크를 넣어 설치한다. 참고로 지금 DeskRPG 저장소 안내문은 호스팅어 원클릭 카탈로그에 올라갔다고 적고 있으니, 새로 VPS를 주문한다면 주문 화면의 애플리케이션 목록에서 먼저 찾아보는 게 빠르다.

배포했는데 "열기" 버튼이 없다

도메인이 연결되지 않은 상태다. Traefik을 추가로 배포한다.

"열기"를 눌러도 접속이 안 된다

환경 변수 설정이 아직 안 끝났다. Hermes API 키, Traefik 호스트, 대시보드 비밀번호 세 칸을 채우고 "저장 후 배포"를 누른다.

게이트웨이 연결 테스트가 초록색이 안 된다

주소를 https로 넣었거나, 컨테이너 이름이나 포트가 틀렸거나, API 키가 환경 변수 값과 다르다. http://{Hermes 컨테이너명}:8642 형식을 확인하고 메모장에 저장한 난수와 같은 키인지 대조한다.

SSH로 연결을 시도했는데 안 된다

Docker 컨테이너 환경에서는 게이트웨이 주소 연결을 써야 한다. 연결 방식 선택 화면으로 돌아가 "게이트웨이 주소 연결"을 고른다.

Hermes 대시보드에 로그인이 안 된다

사용자명은 admin, 비밀번호는 환경 변수에 넣은 대시보드 비밀번호다.

두 번째 직원이 동작하지 않는다

직원마다 각각 모델 로그인을 해야 한다. 그 직원의 프로바이더 화면에서 Codex 로그인과 코드 인증을 다시 한다.

직원 연결이 "테스트 안 함"으로 남아 있다

생성 직후의 기본 상태다. "연결 테스트"를 눌러 "정상"을 확인한다.

방화벽 규칙을 만들었는데 적용이 안 된다

규칙만 만들고 스위치를 켜지 않았다. 방화벽 목록에서 스위치를 "사용 중"으로 바꾼다.

회의는 끝났는데 후속 업무 카드가 안 나온다

회의 주제에 결과물을 명시하지 않았다. 위 회의 주제 프롬프트처럼 "결과물: … 마크다운 파일로"를 주제에 넣는다.

카드가 "막힘"에 멈춰 있고 실행되지 않는다

아직 "준비됨"으로 옮기지 않았다. 드래그해서 옮기면 자동 디스패치된다.

후행 카드가 시작되지 않는다

선행 작업이 아직 완료되지 않았다. 선행이 끝나면 후행이 자동으로 준비됨으로 바뀐다.

크론을 걸었는데 실행되지 않았다

로컬 PC로 돌리고 있고 그 시각에 컴퓨터가 꺼져 있었다. 24시간 켜져 있는 서버로 옮기는 수밖에 없다.

`npx desk-rpg`가 패키지를 못 찾는다

패키지 이름은 하이픈 없는 deskrpg다. npx deskrpg init으로 다시 친다. npx 자체를 모른다는 오류라면 Node.js부터 설치한다.

모바일에서 안 열린다

현재 브라우저 전용이고 모바일은 지원하지 않는다. 모바일은 준비 중이라고 한다.

3D 공간이 오히려 부담스럽다

Hermes 에이전트 모드로 전환해 쓰면 된다. 엔진이 같아서 메신저와 DeskRPG를 병행할 수 있다.

지우고 되돌릴 때 지켜야 할 것

볼륨은 반드시 남긴다

컨테이너를 지울 때 볼륨은 반드시 남긴다. 화자가 명시적으로 경고한 유일한 되돌리기 주의사항이다. 기억·칸반 카드·일정이 전부 Hermes에 저장되므로, 볼륨만 남아 있으면 DeskRPG를 다시 설치해도 기록이 그대로 유지된다.

직원은 삭제 대신 퇴근

직원을 잠시 치우고 싶으면 삭제하지 말고 "퇴근"시킨다. "출근"으로 되돌릴 수 있다. VPS가 더 이상 필요 없으면 서버를 끄면 된다.

백업은 따로 챙긴다

컨테이너와 볼륨 삭제의 구체적 조작 순서, 데이터 백업·복원 절차는 영상에 나오지 않는다. 호스팅어 VPS를 쓴다면 VPS 관리 화면의 스냅샷·백업 메뉴에서 큰 변경 전에 스냅샷을 한 장 떠 두는 방법이 가장 간단하다. 로컬 설치라면 홈 폴더의 .deskrpg 폴더와 Hermes 데이터 폴더를 통째로 복사해 둔다.

DeskRPG 현재 한계와 로드맵

지원 언어는 한국어·영어·일본어·중국어 네 가지다. 맵은 빌트인 5종이고 추가 예정이다. 3D 모델링은 "아직 러프하다"고 화자 본인이 인정했고 UI도 개선할 계획이다. 모바일은 미지원이고, 지금은 브라우저 전용이다.

개발 예정으로 언급한 것은 영상 채팅과 음성 채팅, 드래그 앤 드롭, 맵 에디터다. 우선순위는 댓글 의견을 받아 정하겠다고 했다.

AI 직원을 쓸 때 화자가 권한 네 가지

처음에는 노트북에 설치해 만져 보고, 감이 오면 그때 서버를 고민하라.
회의 주제에는 반드시 결과물을 명시하라. 그래야 후속 업무가 카드로 떨어진다.
참여자에 비판자 역할을 섞고 페르소나에 성향과 분야를 적어 두라. 회의 결과의 질이 달라진다.
프로필을 직원이라고 부르되 사람처럼 대하지는 말라. 권한 범위, 비용 한도, 위험 작업의 확인 시점, 최종 검토 주체 네 가지 선을 먼저 그어 두라.

AI를 세션으로 볼까, 직원으로 볼까

마지막 메시지는 3D 이야기가 아니었다. 이번 프로젝트에서 가장 중요하게 본 건 3D 그래픽이 아니라 AI를 어떤 단위로 다룰 것인가였다는 것이다. 세션 단위로 다루면 어제 세션을 찾게 되고, 직원 단위로 다루면 그냥 직원에게 다시 말을 걸게 된다.

DeskRPG는 Hermes의 대체제가 아니라 Hermes 위에 얹은 사무실 인터페이스라는 점도 다시 강조된다. 이미 Hermes를 쓰고 있다면 게이트웨이 주소만 넣으면 프로필이 그대로 직원으로 뜬다. 옮길 게 없다.

영상 말미에는 화자 본인의 유료 8주 강의 홍보가 붙는다. 8주 뒤 나만의 AI 회사를 갖게 된다, 코딩을 몰라도 된다, 콘텐츠 팀과 마케팅 팀과 재무팀을 서버 한 대에서 운영한다는 내용이다. 강의 효과를 뒷받침하는 자료는 영상에 나오지 않으므로 이 부분은 화자의 홍보 문구로 읽는 게 맞다.

읽고 나서 남는 건 설치 절차보다 그 한 줄이다. AI를 세션으로 볼 것인가, 직원으로 볼 것인가. 다만 직원이라고 부르는 순간 사람이 오류를 17% 덜 잡아낸다는 실험도 같은 영상 안에 있었다. 두 이야기를 같이 기억해 두는 편이 낫겠다.

자주 묻는 질문

DeskRPG는 무료로 쓸 수 있나요?

DeskRPG와 Hermes는 오픈소스라 무료다. 다만 24시간 돌리려면 VPS 요금이 들고, AI 모델은 프로바이더 구독이나 종량제로 따로 낸다. VPS 요금은 바뀌므로 호스팅어 공식 안내를 확인해야 한다.

DeskRPG를 쓰려면 Hermes를 따로 설치해야 하나요?

호스팅어 Docker 매니저로 배포하면 DeskRPG 컨테이너와 함께 Hermes 컨테이너가 같이 설치된다. DeskRPG에는 자체 AI 기능이 없어서 Hermes 게이트웨이가 반드시 필요하다. 이미 Hermes를 쓰고 있다면 게이트웨이 주소만 넣으면 기존 프로필이 그대로 직원으로 뜬다.

DeskRPG 게이트웨이 연결 테스트가 실패하면 어떻게 하나요?

주소가 http://{Hermes 컨테이너명}:8642 형식인지부터 본다. https로 넣었거나 컨테이너 이름·포트가 틀린 경우가 많다. 인증키는 openssl rand -hex 32로 만들어 환경 변수에 넣은 값과 똑같아야 한다.

노트북에 설치해도 크론 예약 작업이 돌아가나요?

컴퓨터가 켜져 있을 때만 돈다. 크론을 아침 8시에 걸어 놨는데 그 시각에 노트북이 꺼져 있으면 그냥 지나간다. 예약 작업을 꾸준히 돌릴 거라면 24시간 켜져 있는 VPS가 필요하다.

DeskRPG를 휴대폰에서 쓸 수 있나요?

아직 안 된다. 현재는 PC 웹 브라우저 전용이고 모바일은 준비 중이다. 지원 언어는 한국어·영어·일본어·중국어 네 가지다.

이 글은 자동 자막을 바탕으로 정리해 화면과 대조하지 못했고, 버튼 이름은 화자 발음 기준이다. 설치 명령어, 저장소·홈페이지 주소, 환경 변수 이름, 레퍼럴 링크는 DeskRPG 공개 저장소 안내(글 작성 시점)로 확인해 보탰다. 자막 표기는 "MPX desk-rpg"(npx deskrpg), "3JS"(Three.js), "트래픽"(Traefik), "수험"(수행), "오픈 ssl 띄고 r고 - hx 띄고 32"(openssl rand -hex 32)로 잡혔다. 원본은 Dante's Datalab 채널의 3873초(약 64분) 영상이다.

출처: youtube.com/…

원본 영상 보러가기 ↗