Section 5: 에이전트 실행하기

이 섹션에서 일어나는 일

각 에이전트를 OpenClaw에 등록하고 첫 번째 명령을 내립니다. 섹션이 끝나면 6개의 에이전트 모두가 실행 중 상태가 되어 — Discord 채널에 보고하고 여러분의 지시를 받을 준비가 됩니다.

에이전트와 대화하는 두 가지 방법:

방법	적합한 경우	작동 방식
OpenGoat UI	초보자 — 시각적 인터페이스	브라우저 기반 대시보드, 에이전트 클릭 선택, 메시지 입력
VS Code 터미널	권장 — 더 빠르고 많은 제어	`openclaw agent --agent [id] "메시지"`

두 방법 모두 작동합니다. 편한 것부터 시작하세요.

권장 접근 방식 — AI와 함께하는 하이브리드: 처음 시작할 때는 에이전트와 함께 사용 중인 채팅 AI를 열어두세요. 명령이 작동하지 않거나 무엇을 입력해야 할지 모를 때, AI에게 상황을 설명하고 도움을 요청하세요. 이것이 대부분의 사람들 — BALIA OS 팀 포함 — 이 처음에 운영하던 방식입니다. 첫날부터 터미널을 마스터할 필요는 없습니다. AI 채팅 창은 항상 여러분의 부조종사로 있습니다.

이 섹션의 작동 방식

아래 프롬프트를 사용 중인 채팅 AI에 붙여넣으세요. AI가 6개의 에이전트 모두를 등록하고 각각에게 첫 번째 명령을 보내는 과정을 안내합니다. AI가 에이전트 ID와 작업 공간 경로를 알 수 있도록 팀 설계 문서를 첨부하세요.

문제가 생기면, 오류를 설명하거나 스크린샷을 찍어 공유하세요 — AI가 수정을 도와드립니다.

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

전송하기 전에 팀 설계 문서를 첨부하세요.

당신은 내 BALIA OS 멀티 에이전트 팀을
OpenClaw에 등록하고 실행하는 것을 도와주고 있습니다.

팀 설계 문서를 첨부했습니다. 시작하기 전에 읽어서
에이전트 ID와 이름을 파악하세요.

시작하기 전에 나에게 물어보세요:
"Windows 사용자 이름이 무엇인가요? (C:\Users\[username]의 이름)"
이 세션 전체에서 모든 파일 경로에 그 사용자 이름을 사용하세요.
내 모든 에이전트 파일은 $env:USERPROFILE/.opengoat/ 아래에 있습니다

단계별로 안내해 주세요. 한 번에 하나의 단계. 오류가 발생하면,
계속 진행하기 전에 수정을 도와주세요. 막히면 스크린샷을
공유하거나 오류 메시지를 붙여넣도록 요청하세요.

해야 할 것들:

STEP 1 — 게이트웨이 시작
나에게 말해주세요: "터미널이 읽기 좋게 유지되도록
시끄러운 배경 로그를 필터링하는 명령으로 OpenClaw 게이트웨이를 시작합니다."

새 VS Code 터미널 탭을 열고 내 OS에 맞는 명령을 실행하도록 안내해 주세요
(아직 모르면 어떤 OS인지 물어보세요):

Windows:
  $env:DEBUG="-ciao*"; openclaw gateway --force

Mac:
  DEBUG="-ciao*" openclaw gateway --force

이것이 하는 일을 설명하세요:
"DEBUG='-ciao*' 부분은 터미널을 범람시키는 배경 네트워크 검색 로그를
숨깁니다. --force 플래그는 이전 게이트웨이 인스턴스를 지웁니다.
터미널이 깨끗하고 읽기 좋게 유지됩니다."

나에게 확인을 요청하세요: "✓ Gateway running on port 18789"
이 터미널 탭을 열어두도록 알려주세요 — 게이트웨이는 계속 실행되어야 합니다.
오류가 있으면 계속 진행하기 전에 수정을 도와주세요.

STEP 2 — 각 에이전트를 OpenClaw에 등록
먼저 이것을 설명해 주세요:
"이 명령을 실행하면 두 가지 일이 일어납니다. 에이전트를 OpenClaw에
등록하는 것과, 해당 에이전트의 config.json과 models.json을
agents/[agentid]/ 아래에 자동으로 생성하는 것입니다. 이 파일들을
직접 만들 필요는 없습니다."

내 6개 에이전트 각각에 대해 (팀 설계 문서에서 ID 읽기),
VS Code 터미널에서 이 명령을 실행하도록 안내해 주세요:

Windows:
openclaw agents add [agentid] --workspace $env:USERPROFILE\.opengoat\workspaces\[agentid]

Mac:
openclaw agents add [agentid] --workspace ~/.opengoat/workspaces/[agentid]

예시 (Windows): openclaw agents add marcus --workspace C:\Users\john\.opengoat\workspaces\marcus
(marcus는 예시입니다 — 팀 설계 문서의 실제 에이전트 ID로 교체하세요.)

내 실제 에이전트 ID와 사용자 이름이 채워진 6개의 명령을 한꺼번에 보여주세요.
각각을 하나씩 실행하고 다음을 보여주기 전에 성공을 확인하도록 요청하세요.

6개 모두 등록되면, 다음을 확인하도록 안내해 주세요:
openclaw agents list
6개의 에이전트 모두 목록에 나타나는지 확인해 주세요.

STEP 2b — 보안 가디언 등록 확인
보안 가디언은 섹션 4에서 이미 OpenClaw에 등록되었습니다.
존재하는지 확인하도록 안내해 주세요:

openclaw agents list

목록에 security-guardian이 나타나는지 확인해 주세요.
없으면 다음을 실행하도록 안내해 주세요:

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

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

그런 다음 계속 진행하기 전에 목록을 다시 확인하세요.

STEP 3 — 게이트웨이 재시작
에이전트를 등록한 후, 게이트웨이를 재시작하여 로드해야 합니다.
다음을 실행하도록 안내해 주세요:
openclaw gateway restart
계속 진행하기 전에 게이트웨이가 다시 실행 중인지 확인해 주세요.

STEP 4 — 보안 가디언 시작 (PM2)
보안 가디언은 PM2를 사용하여 백그라운드에서 지속적으로 실행됩니다.
시작하도록 안내해 주세요:

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

(Mac: 경로를 ~/.opengoat/workspaces/security-guardian/scripts/guardian.js로 교체)

그런 다음 재부팅 시 자동으로 재시작되도록 PM2 프로세스 목록을 저장하세요:
pm2 save

PM2 목록에서 보안 가디언을 확인해 주세요:
pm2 list

그런 다음 Discord #security-channel에 시작 메시지가 있는지 확인해 주세요.

STEP 5 — VS Code 터미널을 통해 첫 번째 명령 보내기 (권장)
먼저 이것을 설명하세요:
"VS Code 터미널은 에이전트와 대화하는 권장 방법입니다.
명령은:
openclaw agent --agent [agentid] '여기에 메시지'

이것은 특정 에이전트에게 직접 메시지를 보냅니다."

첫 번째 에이전트에게 테스트 명령을 보내도록 안내해 주세요:
openclaw agent --agent [first-agentid] '자기소개를 해주고
SOUL.md, AGENTS.md, IDENTITY.md, HEARTBEAT.md,
TOOLS.md, USER.md를 읽었는지 확인해 주세요.
그런 다음 Discord 채널에 온라인 상태라고 보고해 주세요.'

나에게 물어보세요: "에이전트가 어떻게 응답했나요?
Discord 채널에 메시지가 나타났나요?"
예: 좋습니다 — 다음 에이전트로 이동.
아니오: 문제 해결을 도와주세요.

6개의 에이전트 모두에 대해 반복하세요.

STEP 6 — (선택) OpenGoat UI 설정
모든 에이전트가 터미널을 통해 작동하는지 확인한 후, 제안하세요:
"OpenGoat UI를 통해 에이전트와 대화할 수도 있습니다 —
시각적 브라우저 대시보드입니다.
이것도 설정하시겠어요?
터미널 명령을 입력하지 않고도 에이전트를 선택하고
메시지를 보낼 수 있는 클릭 가능한 인터페이스를 제공합니다."
예: 안내해 주세요:
1. 새 VS Code 터미널 탭 열기
2. 실행: opengoat start
3. 브라우저가 자동으로 OpenGoat UI와 함께 열립니다
인터페이스 안내 — 에이전트를 선택하고 메시지를 보내는 방법.
(브라우저가 자동으로 열리지 않으면 http://localhost:19123으로 이동)
아니오: 건너뛰고 7단계로 이동.

STEP 7 — 최종 확인
이 체크리스트를 함께 살펴보세요:
□ 6개 에이전트 모두 등록됨 (openclaw agents list에 6개 모두 표시)
□ 보안 가디언 등록됨 (목록에 security-guardian 표시)
□ 보안 가디언 PM2에서 실행 중 (pm2 list에 온라인 표시)
□ 게이트웨이 실행 중 (포트 18789)
□ 각 에이전트가 첫 번째 명령에 응답함
□ 각 에이전트가 Discord 채널에 게시함
□ (선택) localhost:19123에서 OpenGoat UI 접속 가능

STEP 8 — CLAUDE.md 생성
보안 가디언을 포함한 6개 에이전트 모두가 등록되고 실행 중임을 확인한 후, CLAUDE.md를 생성하도록 안내해 주세요 — 이 파일은 VS Code의 Claude Code가 세션이 시작될 때마다 자동으로 읽는 지침 파일입니다:

"이제 CLAUDE.md를 생성해 봅시다. 이미 완료된 팀 설정을 기반으로 자동으로 생성되며, 수동으로 입력할 필요가 없습니다."

Windows:
cd $env:USERPROFILE\.opengoat\workspaces\security-guardian
node generate_claude_md.js

Mac:
cd ~/.opengoat/workspaces/security-guardian
node generate_claude_md.js

다음과 같이 끝나는 메시지가 보이는지 확인하도록 요청하세요:
[OK] CLAUDE.md generated: (내 경로)\.opengoat\CLAUDE.md

CLAUDE.md가 이미 존재하면, 스크립트가 먼저 자동으로 백업을 만든 다음 덮어쓸지 묻습니다. "yes"는 덮어쓰기를 의미합니다(백업은 이미 완료됨); "no"는 새 콘텐츠가 CLAUDE_generated_draft.md로 저장되고 기존 CLAUDE.md는 전혀 변경되지 않음을 의미합니다.

구매한 tier(T1 / T2 / T3)를 물으면, 실제로 구매한 tier를 입력하도록 안내해 주세요.

생성 후, 내가
$env:USERPROFILE\.opengoat\CLAUDE.md를 열어 팀 이름과 역할이 올바르게 표시되는지 확인하도록 요청하세요.

모든 항목이 체크되면 말해주세요:
"BALIA OS 팀이 실행 중입니다. 6개의 에이전트 모두 실행 중이며
Discord에 보고하고 있습니다. 섹션 6 — 첫 번째 스킬 만들기로 넘어갈 준비가 되었습니다."

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

CLAUDE.md에 대하여

CLAUDE.md는 Claude Code 세션이 시작될 때마다 자동으로 읽히는 파일입니다. 이 파일은 AI 팀에게 팀 구성, 보안 규칙, 프로젝트 컨텍스트를 알려주므로 매 세션마다 다시 설명할 필요가 없습니다.

자동으로 포함되는 내용:

팀 구성 (에이전트 이름과 역할)
파괴적 작업에 대한 절대 금지 (파일 삭제/덮어쓰기 전 백업 필요)
민감 정보 처리 규칙 (API 키, webhook URL을 평문으로 표시하지 않음)
출력 언어 설정

이 파일 아래쪽 섹션은 자유롭게 커스터마이즈할 수 있습니다: 프로젝트별 규칙, 자주 사용하는 명령어, 코딩 규칙 등을 추가하세요.

절대 삭제하거나 수정하지 마세요: "파괴적 작업에 대한 절대 금지 (중요 — 항상 준수 — 삭제 금지)"와 "민감한 정보 처리 (삭제 금지)" 섹션. 이 두 섹션은 선택한 언어로 표시됩니다(20개 언어 지원). 이 두 섹션은 팀 보안의 기반을 이룹니다.

CLAUDE.md가 이미 존재하는 경우: 덮어쓰기 전에 generate_claude_md.js 스크립트가 기존 파일을 타임스탬프와 함께 99_Backups\ 폴더에 백업합니다 (예: CLAUDE.md_20260705_143000.bak). 이렇게 하면 커스터마이즈한 규칙을 잃지 않습니다 — 백업에서 필요한 부분을 새 파일로 수동으로 복사할 수 있습니다.

에이전트와 일상적으로 대화하기

모든 것이 설정되면, 명령을 내리는 방법은 다음과 같습니다:

게이트웨이 시작 (매 세션마다 이것을 먼저 하세요):

Windows:

$env:DEBUG="-ciao*"; openclaw gateway --force

Mac:

DEBUG="-ciao*" openclaw gateway --force

이 터미널 탭을 계속 실행하세요. 다른 명령을 위해 새 탭을 여세요.

VS Code 터미널을 통해:

# 특정 에이전트에게 말하기
openclaw agent --agent marcus "오늘 무엇을 작업했는지 요약해 주세요"

# 에이전트 목록 확인
openclaw agents list

# 필요시 게이트웨이 재시작
openclaw gateway restart

marcus는 예시입니다 — 자신의 에이전트 ID로 교체하세요 (예: --agent ceo 또는 --agent nova).

OpenGoat UI를 통해:

새 VS Code 터미널 탭 열기
실행: opengoat start
브라우저가 OpenGoat UI와 함께 자동으로 열림
왼쪽 패널에서 에이전트 선택
메시지를 입력하고 Enter 누르기 (브라우저가 자동으로 열리지 않으면: http://localhost:19123으로 이동)

Discord를 통해 (보고용 전용 — 명령용 아님): Discord는 에이전트가 보고를 게시하는 곳입니다. 여기서 업데이트를 읽습니다. Discord를 통해 에이전트에게 명령을 보내려면 Discord Bot이 필요합니다 — 이것은 T1에서 다루지 않는 고급 설정입니다. 지금은 VS Code 터미널 또는 OpenGoat UI를 사용하여 명령을 내리세요.

에이전트가 응답하지 않을 때

다음 순서로 확인하세요:

게이트웨이가 실행 중인가?
```
openclaw gateway restart
```
에이전트가 등록되어 있는가?
```
openclaw agents list
```
에이전트가 목록에 없으면 2단계의 agents add 명령을 다시 실행하세요.
작업 공간 파일이 올바른 위치에 있는가?
SOUL.md, AGENTS.md, IDENTITY.md가 다음 위치에 존재하는지 확인하세요:
Windows: $env:USERPROFILE\.opengoat\workspaces\[agentid]\
Mac: ~/.opengoat/workspaces/[agentid]/
API 키가 올바르게 설정되어 있는가?.env (.opengoat 폴더에 있음)를 열고 ANTHROPIC_API_KEY가 입력되어 있는지 확인하세요.

여전히 막히면 오류 메시지를 사용 중인 채팅 AI에 붙여넣고 도움을 요청하세요.

설정 확인

모든 에이전트가 실행 중으로 확인되면 다음을 실행하세요:

Windows:

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

Mac:

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

이것은 6개의 에이전트 모두가 등록되었는지, 보안 가디언이 실행 중인지, 섹션 6으로 넘어갈 준비가 되었는지 확인합니다.

이 섹션에서 일어나는 일 ​

이 섹션의 작동 방식 ​

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

CLAUDE.md에 대하여 ​

에이전트와 일상적으로 대화하기 ​