이 섹션 완료 시 .opengoat 폴더 구조

이 폴더들은 섹션 1~8을 통해 단계별로 만들어집니다. 지금 비어 있어도 걱정하지 마세요 — 각 섹션에서 필요한 파일이 추가됩니다.

📁 .opengoat 전체 폴더 구조

$env:USERPROFILE\.opengoat\          ← BALIA OS 홈 디렉터리
├── identity\                         ← 섹션 2에서 생성
│   └── team_design.md               ← 팀 설계 문서
├── .env                              ← 섹션 3에서 생성 (API 키 & 웹훅)
├── workspaces\                       ← 섹션 3에서 생성
│   ├── [agentid]\                    ← 섹션 4에서 각 에이전트별로 생성
│   │   ├── SOUL.md
│   │   ├── AGENTS.md
│   │   ├── IDENTITY.md
│   │   ├── HEARTBEAT.md
│   │   ├── TOOLS.md
│   │   ├── USER.md
│   │   └── SPEC_[이름].md
│   └── security-guardian\            ← 섹션 3에서 자동 배포
├── agents\                           ← OpenClaw 설정 파일은 섹션 5에서 자동 생성
│   └── [agentid]
│       ├── config.json
│       └── models.json
├── memory\                           ← 섹션 6에서 생성
│   └── _SKILL_STATUS.md             ← 카세트 ON/OFF 목록 (단일 관리 파일)
└── skills\                           ← 섹션 6에서 카세트 추가
    └── [cassette-name]\
        └── SKILL.md

이 폴더가 BALIA OS의 "집"입니다. 모든 에이전트의 정체성, 메모리, 스킬이 여기에 저장됩니다.

---

💡 API란 무엇인가? — 그리고 왜 필요한가?

AI 에이전트를 행동하기 전에 생각해야 하는 직원이라고 생각해 보세요.

에이전트가 상황을 분석하거나, 보고서를 작성하거나, 결정을 내릴 때마다 AI 모델을 호출해서 그 생각을 처리해야 합니다. API는 그 호출을 가능하게 하는 채널이자, 그것을 구동하는 연료입니다.

채팅 AI vs API — 두 가지는 다릅니다:

	채팅 AI (Claude / Gemini / ChatGPT)	API
정체	나만의 개인 비서	에이전트의 사고 엔진
사용자	나, 직접	에이전트, 자동으로
비용 모델	구독 (정액제)	사용량 기반 (입력 + 출력 토큰)
권장 사항	유료 플랜 — 더 나은 추론	$5 크레딧으로 시작

왜 둘 다 사용하는가? (하이브리드 설정)

API 과금은 입력 + 출력 토큰으로 이루어집니다 — 에이전트에게 보내는 모든 단어와 에이전트가 응답하는 모든 단어에 소액의 비용이 발생합니다.

즉, 에이전트에게 어떻게 지시하느냐가 중요합니다.

사용 중인 채팅 AI (더 나은 추론을 위해 유료 플랜 권장)를 사용해:

• 에이전트에게 보내기 전에 명확하고 간결한 지시를 작성하세요
• 긴 문서를 에이전트에게 전달하기 전에 요약하세요
• 에이전트가 원하는 것을 파악하느라 토큰을 낭비하지 않도록 작업을 사전 구조화하세요

잘 구조화된 200 토큰 지시는 모호한 2,000 토큰 주고받기보다 훨씬 저렴합니다. 채팅 AI는 전략가입니다. 에이전트는 실행자입니다. 이 조합을 통해 API 비용을 낮게 유지하면서도 출력 품질은 높게 유지할 수 있습니다.

시작 전 — API 비용 투명성

BALIA OS를 실행하려면 AI API 키가 필요합니다. 이는 가이드 비용 $48와는 별도입니다.

필요한 것:

• 최소 $5의 선불 크레딧이 있는 Anthropic 계정
• 이 가이드의 모든 에이전트는 Claude Sonnet 5를 사용합니다

$5로 시작하기에 충분한 이유: Claude Sonnet 5의 요금은 입력 토큰 100만 개당 $2, 출력 토큰 100만 개당 $10입니다 (2026년 8월 31일까지 적용되는 도입 가격이며, 이후에는 입력 $3·출력 $15로 전환됩니다). 일반적인 에이전트 세션은 수천 개의 토큰을 사용합니다. $5로 더 지출하기 전에 수십 번의 세션을 통해 학습하고 실험할 수 있습니다.

Anthropic API에는 무료 등급이 없습니다. 신용카드가 필요합니다. 크레딧 추가: console.anthropic.com → Billing → Add credits (최소 $5)

이것이 BALIA OS를 실행하는 데 필요한 유일한 외부 비용입니다. 관점에서 보면: 사람 비서를 고용하면 한 달에 $2,000–$5,000이 듭니다. AI 팀은 $5의 API 크레딧으로 시작할 수 있습니다. 같은 일. 비용의 극히 일부.

---

설치할 것들

이 섹션을 마치면 다섯 가지가 준비됩니다:

• VS Code — 에이전트 파일을 편집하고 명령을 실행하는 작업 공간
• Claude Code — VS Code 안에서 오류 수정·파일 편집까지 자동으로 처리하는 하이브리드 운영의 실행 담당 (섹션 1 참고). 채팅 AI로 Claude Pro를 사용 중이라면 같은 계약으로 그대로 사용할 수 있으며 추가 구매는 필요하지 않습니다
• Node.js — OpenClaw·Claude Code 실행에 필요
• OpenClaw — BALIA OS를 구동하는 AI 에이전트 프레임워크
• Anthropic API 키 — 에이전트가 생각하는 데 사용하는 AI 엔진
• 보안 가디언 — 파일을 관리하고 구성을 검증하는 자동화된 설정 도우미

이 섹션의 작동 방식: 아래 프롬프트를 복사해 사용 중인 채팅 AI에 붙여넣으세요. AI가 전체 설치 과정을 안내해 드립니다 — 운영 체제를 묻고, 각 단계를 안내하고, 문제가 발생하면 해결을 도와드립니다. 어느 단계에서 막히더라도, AI에게 문제를 설명하면 도움을 받을 수 있습니다.

---

▶ 시작하려면 이것을 AI에 붙여넣으세요

당신은 OpenClaw 위에 구축된 멀티 에이전트 AI 운영 체제인
BALIA OS를 설치하고 설정하는 것을 도와주고 있습니다.

당신의 역할은 나를 단계별로 설치 과정으로 안내하는 것입니다.
한 번에 하나의 질문을 하세요. 계속 진행하기 전에 내 답변을 기다리세요.
오류가 발생하면, 계속하기 전에 해결을 도와주세요.

설치하고 설정해야 할 모든 것이 순서대로 여기 있습니다:

STEP 1 — 운영 체제 확인
나에게 물어보세요: "Windows를 사용하고 있나요, Mac을 사용하고 있나요?"
그런 다음 모든 단계에서 내 OS에 맞는 지시를 제공하세요.

STEP 2 — VS Code 설치
code.visualstudio.com에서 VS Code를 설치하도록 안내해 주세요
- Windows: 설치 프로그램을 다운로드하고 실행하세요. "Add to PATH"가 체크되어 있는지 확인하세요.
- Mac: 다운로드하고, 압축을 풀고, Applications로 드래그한 다음,
  "code"를 PATH에 추가하는 셸 명령을 실행하세요:
  Cmd+Shift+P → "Shell Command: Install 'code' command in PATH"
설치 후, VS Code에서 터미널을 열고 실행하도록 요청하세요:
  code --version
무엇이 표시되는지 물어보세요. 오류가 있으면 수정을 도와주세요.

STEP 2b — VS Code 표시 언어 변경하기 (선택)
VS Code는 기본적으로 영어로 표시됩니다. 한국어로 사용하고 싶다면
다음 절차를 안내해 주세요:
1. VS Code를 열고 Ctrl+Shift+X (Mac: Cmd+Shift+X)로 확장 프로그램 패널을 엽니다
2. "Korean Language Pack" (Microsoft 제작, 확장 프로그램 ID: MS-CEINTL.vscode-language-pack-ko)을 검색해 설치합니다
3. 설치 후 나타나는 "Change Language and Restart"를 클릭합니다
   (나타나지 않으면 Ctrl+Shift+P → "Configure Display Language" → "ko"를 선택합니다)
4. VS Code가 재시작되고 메뉴가 한국어로 표시되는지 확인합니다
한국어로 바꾸지 않아도 이 단계는 건너뛰고 다음으로 진행해도 된다는 점을 알려주세요.

STEP 3 — Python 설치
VS Code 터미널에서 사용자에게 다음을 실행하도록 요청하세요:
  python --version
"Python 3.x.x"가 표시되면 Python이 이미 설치되어 있습니다. 다음 STEP으로 진행하세요.

그렇지 않으면 https://www.python.org/downloads/ 에서 설치하도록 알려주세요
- Windows: 설치 프로그램을 실행하세요. "Add Python to PATH"를 체크했는지 확인하세요.
- Mac: 설치 프로그램을 실행하고 기본값으로 진행하세요.

설치 후, VS Code를 재시작하고 python --version을 다시 실행하여 확인하세요.

STEP 4 — Node.js 설치
nodejs.org에서 Node.js 22 이상(LTS 버전)을 설치하도록 안내해 주세요.
설치 후, 다음을 실행하도록 요청하세요: node --version
무엇이 표시되는지 물어보세요.
- v22 이상: 좋습니다, 계속 진행하세요.
- v22 미만: nvm (Mac/Linux) 또는 nvm-windows (Windows)를 사용하여
  업그레이드하도록 안내해 주세요.
- 오류: 문제 해결을 도와주세요.

STEP 5 — OpenClaw 설치
VS Code 터미널에서 다음을 실행하도록 안내해 주세요:
  npm install -g openclaw
그런 다음 확인하세요:
  openclaw --version
처리할 일반적인 오류:
- Mac에서 EACCES: npm 글로벌 접두사 수정 안내
- "openclaw not found": 터미널을 닫고 다시 열어 재시도하도록 요청

STEP 5b — Claude Code 설치
먼저 이것을 설명하세요:
"Claude Code는 섹션 1에서 소개한 하이브리드 운영의 실행 담당입니다.
VS Code 안에서 오류를 읽고 파일 수정·명령 실행까지 처리합니다.
Claude Pro 이상 플랜($20/월~)에 가입되어 있다면 추가 구매는 필요하지 않습니다 —
claude.ai의 채팅과 Claude Code는 동일한 구독·동일한 이용 한도를 공유합니다.
섹션 1에서 채팅 AI로 Claude Pro를 선택했다면 그 계정으로 그대로 로그인할 수 있습니다.
채팅 AI로 Claude 이외(ChatGPT・Gemini 등)를 사용 중이라면,
Claude Code를 이용하려면 별도로 Claude Pro 이상 가입 또는 Anthropic API 액세스가 필요합니다."

다음을 안내해 주세요:
1. VS Code 터미널에서 다음을 실행해 CLI를 설치합니다:
     npm install -g @anthropic-ai/claude-code
2. 설치 확인:
     claude --version
   버전 번호가 표시되는지 확인합니다
3. VS Code 확장 프로그램 패널(Ctrl+Shift+X)에서 "Claude Code"(제작사: Anthropic)를 검색해
   설치합니다
4. VS Code 터미널에서 다음을 실행해 첫 로그인을 진행합니다:
     claude
   브라우저가 열리면 Claude Pro 계정(또는 API 키)으로 로그인하도록 안내합니다
5. 로그인 완료 후 터미널로 돌아와 프롬프트가 표시되는지 확인합니다

자주 발생하는 오류 대처:
- npm install에서 EACCES (권한 오류, Mac/Linux):
    mkdir -p ~/.npm-global
    npm config set prefix ~/.npm-global
    export PATH=~/.npm-global/bin:$PATH
  순서대로 실행한 후 다시 시도하도록 안내해 주세요
- "claude: command not found": 터미널을 닫고 다시 열어 재시도하도록 요청
- 로그인 화면이 열리지 않음: console.anthropic.com에서 유효한 구독/API 액세스가 있는지 확인하도록 안내

STEP 6 — Anthropic API 키 얻기
먼저 이것을 설명하세요:
"BALIA OS는 에이전트의 기본 AI 엔진으로 Claude (Anthropic)를 사용합니다.
지금은 Claude만 설정합니다. 다른 AI 엔진은 나중에 원하는 것을 만들 때
추가할 수 있습니다:
- 자신만의 스킬을 만들 때 (섹션 6), 해당 스킬에 가장 적합한 AI를 선택합니다
  — 예를 들어, 비디오를 직접 분석할 수 있는 YouTube용 Gemini,
  또는 세일즈 카피용 GPT-4o.
- BALIA 스킬 마켓이 열리면, 다른 사용자가 만든 스킬을 설치할 수 있으며,
  각각 자체 권장 AI 엔진이 있습니다."

그런 다음 안내해 주세요:
1. console.anthropic.com으로 이동
2. 가입 또는 로그인
3. API Keys → Create Key로 이동
4. "balia-os"라고 이름 지정
5. 키 복사 (sk-ant-로 시작)
나에게 말해주세요: "이것을 안전한 곳에 저장하세요 — 한 번만 볼 수 있습니다."
계속 진행하기 전에 키를 가지고 있는지 확인해 주세요.
채팅에 키를 붙여넣도록 요청하지 마세요.

STEP 7 — OpenClaw 설정 실행
VS Code 터미널에서 다음을 실행하도록 안내해 주세요:
  openclaw setup
예상되는 것을 알려주세요:
- Anthropic API 키를 요청할 것입니다 — 거기에 붙여넣으세요
- 자동으로 ~/.opengoat/ (Mac) 또는
  $env:USERPROFILE\.opengoat\ (Windows) 폴더를 생성합니다
  이것이 BALIA OS 홈 디렉토리입니다 — 모든 에이전트 파일이 여기에 있습니다.
설정이 완료되면, 게이트웨이를 시작하기 위해 이 명령을 실행하도록 안내해 주세요:
  Windows: $env:DEBUG="-ciao*"; openclaw gateway --force
  Mac:     DEBUG="-ciao*" openclaw gateway --force
다음을 확인하도록 요청하세요:
  "✓ Gateway running on port 18789"
알려주세요: "이 터미널 탭을 열어두세요 — 이것이 게이트웨이입니다. 향후 명령을 위해 새 탭을 여세요."

그런 다음 폴더가 생성되었는지 확인하도록 요청하세요:
- Windows: dir $env:USERPROFILE\.opengoat
- Mac:     ls ~/.opengoat
나에게 물어보세요: ".opengoat 폴더가 보이나요?"
그렇지 않으면 문제 해결을 도와주세요.

STEP 9 — .env 파일 생성
.opengoat 폴더 안에 .env 파일을 생성하도록 안내해 주세요.
- Windows: VS Code에서 $env:USERPROFILE\.opengoat 폴더를 열기
           왼쪽 패널에서 오른쪽 클릭 → New File → .env로 이름 지정
- Mac:     VS Code에서 ~/.opengoat 폴더를 열기
           왼쪽 패널에서 오른쪽 클릭 → New File → .env로 이름 지정

그런 다음 이 템플릿을 붙여넣으세요:

# BALIA OS
BALIA_TOKEN=paste-your-token-here
AGENT_ID=ceo

# Anthropic API
ANTHROPIC_API_KEY=sk-ant-paste-your-key-here

# Agent model
CLAUDE_MODEL=claude-sonnet-5

# Discord Webhooks — 섹션 4에서 입력하세요
# 예시: DISCORD_WEBHOOK_MAYA=https://discord.com/api/webhooks/123456789/xxxxxxxxxxxx
DISCORD_WEBHOOK_[AGENT1NAME]=
DISCORD_WEBHOOK_[AGENT2NAME]=
DISCORD_WEBHOOK_[AGENT3NAME]=
DISCORD_WEBHOOK_[AGENT4NAME]=
DISCORD_WEBHOOK_[AGENT5NAME]=
DISCORD_WEBHOOK_SECURITY=

BALIA_TOKEN 입력:
"구매 후 받은 이메일을 확인하세요.
제목 줄에 'Your BALIA OS Access Token'이라고 적혀 있습니다.
토큰을 복사하세요 (BALIA-로 시작) 그리고 BALIA_TOKEN= 다음에 붙여넣으세요
이것을 입력하는 것은 이번 한 번뿐입니다 —
섹션 6의 설치 프로그램이 이 파일에서 자동으로 읽습니다.
채팅에 붙여넣지 마세요."

AGENT_ID 입력:
"이것은 CEO 에이전트의 ID입니다 — 가장 많이 대화하는 기본 에이전트입니다.
ID는 고정되어 있습니다: ceo. AGENT_ID=ceo를 위에 나타난 대로 그대로 두세요.
변경하지 마세요. 설치 스크립트와 섹션 4 모두 이 값에 의존합니다."

나에게 말해주세요: "지금은 Discord 웹훅을 비워두세요 — 섹션 4에서
실제 URL을 얻게 됩니다.
URL 형식은 다음과 같습니다: https://discord.com/api/webhooks/숫자/문자
[AGENT1NAME]부터 [AGENT5NAME]을 에이전트 이름으로 대문자로 바꾸세요.
DISCORD_WEBHOOK_SECURITY는 항상 마지막에 있습니다 — 보안 가디언 에이전트용입니다."

보안 참고 — 이것을 말해주세요:
"파일에 토큰을 넣는 것이 불편하다면:
지금 BALIA_TOKEN을 건너뛰고 섹션 6 설치 중에
요청 시 수동으로 입력할 수 있습니다."

나에게 말해주세요: "이 파일을 절대 공유하지 마세요. GitHub에 커밋하지 마세요."

STEP 9b — .env 파일에 API 키 쓰기
참고: API 키는 이미 STEP 7 (openclaw setup)에서 입력했습니다. 여기서도 필요한 이유를 설명하세요.
말해주세요: "동일한 API 키를 두 곳에 설정하고 있습니다:
- openclaw setup은 OpenClaw의 자체 구성 내부에 저장합니다.
- .env 파일은 BALIA OS 에이전트를 위해 저장합니다 — 에이전트는 .env에서 직접 키를 읽습니다.
둘 다 동일한 키를 가져야 합니다. 이것은 일회성 설정입니다."
안내해 주세요:
1. VS Code에서 .env 파일 열기 (.opengoat 폴더에 있습니다)
2. 줄 찾기: ANTHROPIC_API_KEY=sk-ant-paste-your-key-here
3. "sk-ant-paste-your-key-here"를 실제 키로 교체
4. 파일 저장 (Windows에서 Ctrl+S / Mac에서 Cmd+S)
확인: "API 키가 이제 .env 파일에 저장되었습니다.
이 파일을 절대 공유하거나 GitHub에 커밋하지 마세요."
채팅에 키를 붙여넣도록 요청하지 마세요.

STEP 9b를 마치면 저에게 말하세요: "환경이 준비되었습니다. 다음으로 보안 가디언을 설정하겠습니다 — 자동화된 설정 도우미입니다."

지금 시작하세요. 첫 번째 질문을 해주세요.

🛡️ 먼저 보안 가디언 설정하기

에이전트를 만들기 전에 보안 가디언을 시작할게요. 이 시점부터 보안 가디언이 자동으로 설정을 확인하고, 필요한 경우 파일을 올바른 위치로 이동하고, 누락된 파일을 생성합니다. 실수를 걱정할 필요 없어요 — 가디언이 알아서 해결해드립니다.

---

🛡️ 보안 가디언 배포

⚠️ 경고: API 비용 폭주

[해외에서 실제로 발생한 사례 — BALIA OS와 무관] 2025년 11월, 해외 개발팀의 AI 에이전트가 무한 루프 상태에 진입하여 아무도 알아채지 못한 채 11일 동안 계속 실행되었고, $47,000의 API 청구서가 발생했습니다. (출처: Tech Startups / Hacker News)

AI 에이전트는 사용자가 인식하지 못하는 사이에 API를 계속 호출할 수 있습니다. 이러한 위험을 방지하기 위해 Security Guardian이 24시간 비용을 모니터링하고 이상을 감지하면 즉시 Discord로 알림을 전송합니다.

항상 다음도 설정하세요:

1. 이용 중인 AI 제공업체 콘솔에서 비용 알림 설정 (권장: $3–5/일) (Anthropic 사용자의 경우) → https://console.anthropic.com/settings/billing
2. Security Guardian 비용 모니터링 설정 확인 (2.5단계)

에이전트 파일이 완료되었습니다.

BALIA OS에는 한 명의 에이전트가 더 있습니다: 보안 가디언 (security-guardian).

이 에이전트는 BALIA에 의해 미리 구성됩니다. 이름, ID, 경로를 변경하지 마세요. 변경하면 다른 에이전트와의 통합이 깨집니다.

---

전제 조건: PM2 설치

PM2는 Node.js 프로세스 관리자입니다. PC를 재시작한 후에도 Security Guardian이 자동으로 실행되도록 합니다.

VS Code 터미널을 열고 다음 명령어를 붙여넣어 설치하세요:

npm install -g pm2

PM2가 이미 설치되어 있으면 이 단계를 건너뜁니다.

---

설치 프로그램 다운로드 및 실행

💡 토큰이란 무엇인가요?

구매 후 전송된 접속 URL의 ?token= 이후 문자열입니다.

예시: https://guide.baliaos.com/?token=BALIA-XXXX-XXXX-0001 이 경우 토큰은 BALIA-XXXX-XXXX-0001입니다.

이메일을 찾을 수 없는 경우 고객 지원에 문의하세요.

1단계 — 설치 프로그램 다운로드

VS Code 터미널에서:

Windows:

Invoke-WebRequest -Uri "https://balia-os-guide.vercel.app/scripts/install_core_pack.py" -OutFile install_core_pack.py
python install_core_pack.py

Mac / Linux:

curl -o install_core_pack.py https://balia-os-guide.vercel.app/scripts/install_core_pack.py
python3 install_core_pack.py

2단계 — OpenClaw에 보안 가디언 등록

Windows:

openclaw agents add security-guardian --workspace $env:USERPROFILE\.opengoat\workspaces\security-guardian

Mac:

openclaw agents add security-guardian --workspace ~/.opengoat/workspaces/security-guardian

이렇게 하면 OpenClaw이 명령을 라우팅할 수 있도록 security-guardian이 등록됩니다.

2.5단계 — 등록 확인

OpenClaw가 에이전트를 인식할 수 있는지 확인하세요:

openclaw agents list

security-guardian가 목록에 있는지 확인하세요. 없다면 2단계를 반복하세요.

---

📋 guardian_config.json 커스터마이징 가이드

다음 설정은 언제든지 변경할 수 있습니다. 파일 위치:

$env:USERPROFILE\.opengoat\workspaces\security-guardian\guardian_config.json

키	기본값	설명
cost.alertHourly	1.0	시간당 API 비용 알림 ($)
cost.alertDaily	5.0	일일 API 비용 알림 ($)
rollback.threshold	6	롤백 발동 전 누락 파일 수
rollback.autoRecovery	true	자동 롤백 (false = 수동 승인)
snapshot.intervalMinutes	10	스냅샷 빈도 (분)
snapshot.maxSnapshots	3	보관할 스냅샷 수
watchdog.checkGateway	true	OpenClaw 게이트웨이 모니터링
watchdog.checkWSL2	false	WSL2 모니터링 (기본값 off)
scanner.runIntervalHours	4	격리 스캔 빈도 (시간)
git.autoPushEnabled	true	GitHub 자동 백업
git.autoPushIntervalMinutes	30	백업 빈도 (분)

설정 변경 후 Security Guardian을 재시작하세요:

pm2 restart security-guardian

---

3단계 — 보안 가디언이 설치 프로그램을 실행하도록 지시

openclaw agent --agent security-guardian "Run: python install_core_pack.py --lang en (token loads from .env automatically). Tell me when done."

토큰은 .env 파일의 BALIA_TOKEN에서 자동으로 읽힙니다.

에이전트가 자율적으로:

1. 토큰 인증
2. 보안 가디언 파일 다운로드
3. .opengoat/agents/security-guardian/ 및 .opengoat/workspaces/security-guardian/에 배포
4. 터미널에 "✓ Security Guardian deployed successfully" 표시

⚠️ 중요: 보안 가디언의 ID, 이름, 폴더 경로를 변경하지 마세요. 다른 설정 파일이 이 에이전트를 직접 참조합니다. 변경하면 스킬 검역 시스템이 깨집니다.

터미널에 "✓ Security Guardian deployed successfully"가 표시되면 다음 단계로 계속하세요.

INFO

agents/security-guardian/ vs workspaces/[agentid]/

BALIA OS는 각 에이전트에 대해 두 가지 폴더 유형을 사용합니다:

• agents/[id]/ — OpenClaw 설정 파일 (config.json, models.json) — OpenClaw이 에이전트 실행을 위해 읽음
• workspaces/[id]/ — 작업 공간 파일 (SOUL, AGENTS, IDENTITY, HEARTBEAT, TOOLS, USER, SPEC) — 에이전트가 세션 시작 시 읽음

보안 가디언은 두 가지를 모두 사용합니다:

• agents/security-guardian/ — config.json 및 models.json
• workspaces/security-guardian/ — SOUL.md, SPEC_SECURITY.md, scripts/ 등

커스텀 에이전트도 동일한 구조를 사용합니다. 두 폴더 모두 $env:USERPROFILE/.opengoat/ 아래에 있습니다.

---

설정 확인

터미널에 "✓ Security Guardian deployed successfully"가 표시되면 다음을 실행하세요:

Windows:

node $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\verify_setup.js --section 4

Mac:

node ~/.opengoat/workspaces/security-guardian/scripts/verify_setup.js --section 4

이것은 섹션 5에서 팀을 실행하기 전에 모든 에이전트 파일이 제자리에 있고 보안 가디언이 올바르게 등록되었는지 확인합니다.

---

Step 3.5 — gateway를 중지하고 PM2로 Guardian을 시작한 후 재시작하기

설치가 완료되면 gateway를 안전하게 재시작합니다.

① gateway 중지

openclaw gateway가 실행 중인 PowerShell에서 다음을 누르세요:

Ctrl + C

"종료하시겠습니까?"라고 묻는 경우 Y를 누른 후 Enter를 누르세요.

② PM2로 Security Guardian 시작

새 PowerShell을 열고 다음을 한 줄씩 실행하세요:

pm2 start $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\security_guardian.js --name security-guardian

pm2 start $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\watchdog.js --name guardian-watchdog

pm2 save

pm2 list

security-guardian과 guardian-watchdog이 online 상태인지 확인하세요.

③ gateway 재시작

같은 PowerShell에서 다음을 한 줄씩 실행하세요:

$env:DEBUG="-ciao*"

openclaw gateway --force

이 PowerShell 창을 닫지 마세요.

---

▶ 계속: 이것을 AI에 붙여넣기

보안 가디언이 이제 실행 중입니다. workspace 폴더를 만들고 설정을 완료합시다.

STEP 8 — 각 에이전트의 작업 공간 폴더 생성
나에게 말해주세요: "섹션 2의 팀 설계 문서를 읽어
에이전트 ID를 자동으로 가져오겠습니다. 지금 첨부해 주세요."
첨부된 팀 설계 문서를 읽으세요.
모든 6개의 에이전트 이름/ID를 추출하세요 (소문자로 변환, 공백 없이, 공백은 하이픈으로).
목록을 보여주세요:
"6개의 에이전트를 찾았습니다: [id1], [id2], [id3], [id4], [id5], [id6]
맞나요?"
내 확인을 기다리세요.

그런 다음 실제 ID가 이미 채워진 6개의 작업 공간 폴더를 한꺼번에
생성하는 정확한 명령어를 제공해 주세요.
이 폴더 구조를 사용하세요: workspaces\[id]\ (workspace-[id] 아님).
- Windows: cd $env:USERPROFILE\.opengoat
           mkdir workspaces\[id1] workspaces\[id2] workspaces\[id3] workspaces\[id4] workspaces\[id5] workspaces\[id6]
- Mac:     cd ~/.opengoat
           mkdir -p workspaces/[id1] workspaces/[id2] workspaces/[id3] workspaces/[id4] workspaces/[id5] workspaces/[id6]

실행 후, 폴더가 생성되었는지 확인하도록 요청하세요:
- Windows: dir $env:USERPROFILE\.opengoat\workspaces
- Mac:     ls ~/.opengoat/workspaces

STEP 10 — 최종 확인
이 체크리스트를 한 번에 하나씩 함께 살펴보세요:
□ code --version → 버전 번호 표시
□ node --version → v22 이상 표시
□ openclaw --version → 버전 번호 표시
□ claude --version → 버전 번호 표시
□ VS Code에 Claude Code 확장 프로그램이 설치되고 로그인 완료
□ 게이트웨이 터미널이 "✓ Gateway running" 표시
□ .opengoat 폴더 존재 확인
□ 6개 모든 에이전트를 위한 workspaces/ 하위 폴더 생성
□ .opengoat 폴더에 .env 파일 존재
□ BALIA_TOKEN 입력됨 (또는 섹션 6에서 수동 입력 예정)
□ AGENT_ID가 ceo로 설정됨
□ ANTHROPIC_API_KEY 입력됨
□ 보안 가디언 배포됨 (터미널 출력으로 확인)

모든 항목이 체크되면 말해주세요:
"설치가 완료되었습니다. 섹션 4 —
에이전트 파일 만들기로 넘어갈 준비가 되었습니다."

STEP 8부터 시작하세요. 팀 디자인 문서를 첨부해 달라고 요청하세요.

---

🛡️ Security Guardian 감사

Security Guardian이 이제 전체 설정을 확인하고 문제를 자동으로 수정합니다.

Guardian이 확인하는 내용:

• $env:USERPROFILE\\.opengoat\\ 하위의 모든 필수 폴더 존재 여부
• 모든 필수 파일이 올바른 위치에 있는지
• 잘못된 위치의 파일은 자동으로 이동됩니다
• 누락된 파일은 자동으로 생성됩니다 (비어 있음 — Section 4에서 내용을 채웁니다)

Guardian이 아직 변경하지 않는 것:

• 파일 내용 (에이전트 개성과 설정은 Section 4에서 결정됩니다)

감사를 실행하세요:

Windows:

node $env:USERPROFILE\\.opengoat\\workspaces\\security-guardian\\scripts\\verify_setup.js --fix

Guardian이 발견하고 수정한 내용을 보고합니다. 모든 것이 녹색이면 Section 4로 진행할 준비가 된 것입니다.