OpenClaw 멀티 에이전트 오케스트레이션 가이드 (2026)
단일 AI 어시스턴트는 빠른 질문에는 충분합니다. 프로덕션 코딩, 운영 알림, 가족 채팅, 리서치에는 세션·자격 증명·도구 권한을 공유하지 않는 여러 페르소나가 필요합니다. OpenClaw 멀티 에이전트 오케스트레이션은 하나의 Gateway 제어 평면과 워크스페이스·인증·세션 스토어가 분리된 여러 agent로 이를 해결합니다.
OpenClaw는 로컬 우선 개인 AI 어시스턴트(2026년 GitHub 스타 37.5만+)로, Gateway가 WhatsApp·Telegram·Discord·Slack 등 채널을 agent 두뇌에 연결합니다. 공식 멀티 에이전트 라우팅에서 수신 메시지는 binding 테이블을 거쳐 크로스토크 없이 올바른 agentId에 도달합니다.
이 가이드에서 다루는 내용:
- 디스크상 OpenClaw agent의 실체
- bindings 메시지 라우팅(peer·account·channel)
- 두 번째 agent 추가 7단계
- 라우팅을 넘는 멀티 에이전트 오케스트레이션
- 네이티브 Gateway vs 외부 오케스트레이터
이미 Obra Superpowers로 개발 워크플로를 쓰거나 Understand Anything으로 저장소를 파악한다면, OpenClaw는 다른 계층입니다. 상시 온 어시스턴트 + 채널 라우팅이며 IDE 전용 코딩이 아닙니다. 플러그인은 2026년 추천 Claude Code 플러그인도 참고하세요.
소개
프로덕션에서는 페르소나 분리가 전제입니다. 아래에서 agent 구성부터 설명합니다.
하나의 OpenClaw agent에 포함된 것
~/.openclaw/agents/<agentId>/ 아래 분리 세션 스토어를 포함한 완전한 페르소나 스코프입니다.| 구성요소 | 경로 | 목적 |
|---|---|---|
| Workspace | ~/.openclaw/workspace-<name> | 기본 cwd, SOUL.md, skills |
| Agent dir | ~/.openclaw/agents/<agentId>/agent | auth, 모델, 설정 |
| Sessions | ~/.openclaw/agents/<agentId>/sessions | 채팅·라우팅 상태 |
| Config | ~/.openclaw/openclaw.json | Gateway, agents.list, bindings |
중요: 동일 agentDir를 두 agent가 공유하지 마세요.
출처: OpenClaw multi-agent docs.
agentId · accountId · binding
| 개념 | 의미 |
|---|---|
agentId | 하나의 두뇌(workspace + sessions + auth) |
accountId | 채널 로그인 1개(예: WhatsApp personal/biz) |
binding | 매치 규칙 → agentId |
라우팅은 결정론적이며, 가장 구체적인 규칙이 우선합니다.
Gateway 아키텍처(제어 평면)
수신 메시지 → Gateway → bindings → agentId → workspace + session → agent별 LLM·tools·skills.
Gateway는 라우터이자 세션 관리자입니다. tools.agentToAgent는 기본 enabled: false입니다.
설정: 두 번째 agent 추가
1단계 — 설치/업데이트
공식 설치, openclaw --version 확인.
2단계 — agent 생성
openclaw agents add coding
3단계 — 목록
openclaw agents list --bindings
4단계 — 채널 로그인
openclaw channels login --channel whatsapp --account work
5단계 — bindings 편집
peer 규칙을 accountId: "*" 위에 배치합니다.
6단계 — 재시작·프로브
openclaw gateway restart · openclaw channels status --probe
7단계(선택) — 채널별 모델
agent마다 model:을 독립 설정할 수 있습니다.
오케스트레이션 패턴
라우팅: 어떤 agent? 오케스트레이션: 여러 agent 협업?
패턴 A — 네이티브 라우팅만(우선)
| 시나리오 | binding |
|---|---|
| 업무/개인 WhatsApp | accountId → agentId |
| DM에 큰 모델 | peer.kind: "direct" + E.164 |
| Discord 코딩 | guildId + channel |
| 가족 그룹 | 전용 agent + mentionPatterns |
패턴 B — agent 간 위임
tools.agentToAgent + allowlist.
패턴 C — 외부 오케스트레이터
| 프로젝트 | 스타일 | 용도 |
|---|---|---|
| openclaw-orchestrator | LLM 플래너 | 개방형 목표 |
| visual orchestrator | 그래프·승인 | 컴플라이언스 |
| open-claw-code | 계층형 코딩 agent | 멀티 리포 |
- 채널 신원 분리만 → 패턴 A
- 다단계 프로젝트 → B 또는 C
- IDE TDD → Obra Superpowers
보안
비신뢰 agent는 sandbox + tool deny. tools.elevated는 전역입니다.
Gateway 실행 위치
OpenClaw는 로컬 우선(macOS, Linux, WSL2)입니다. webhook을 위해 Gateway를 상시 가동하세요.
팀은 노트북 대신 24시간 전용 Mac에서 실행하기도 합니다. 서울 리전 등 저지연 노드를 쓰는 경우에도 보안 모델에 맞는 호스트를 선택하세요. 원격 관리는 Mac mini M4 SSH 원격 접속 가이드를 참고하세요.
문제 해결
잘못된 agent가 응답
openclaw agents list --bindings → 규칙 순서 확인 → openclaw gateway restart.
auth/세션 혼선
agent마다 고유 agentDir. 필요 시 openclaw channels login 재실행.
프로브 실패
자격 증명, 방화벽, 토큰을 채널 가이드에 따라 확인.
FAQ
agentId를 지정할 수 있습니다.allow와 enabled: true일 때만. 기본은 false.install.sh openclaw 브리지가 있습니다.결론
OpenClaw 멀티 에이전트 오케스트레이션은 Gateway에서 시작합니다. openclaw agents add, bindings, 재시작·프로브 후 필요 시 agent-to-agent나 외부 오케스트레이터를 추가하세요.