Claude Code와 OpenClaw 에이전트 간 협업을 위한 Swarmbus 구축

실용적 조언

Claude Code 인스턴스를 여러 개 운영하며 연구와 실행 업무를 분리하고 싶다면 Swarmbus를 통해 이들을 동기화할 수 있다
설치 시 ~/.claude/settings.json 설정과 skills 폴더의 스킬 등록이 정확히 되었는지 확인해야 한다

섹션별 상세

Swarmbus는 Claude Code(CC) 인스턴스 간 또는 CC와 OpenClaw 간의 협업을 가능하게 하는 통신 레이어를 제공한다. 설치 스크립트를 통해 ~/.claude/settings.json에 MCP 서버를 등록하고 전용 행동 스킬을 추가하여 에이전트가 통신 방법을 학습하도록 설계했다. 이를 통해 에이전트는 send_message, read_inbox 등 4가지 전용 도구를 사용하여 다른 에이전트와 데이터를 교환한다.

bash

bash scripts/setup-cc-plugin.sh

Claude Code에 Swarmbus MCP 서버와 행동 스킬을 설치하는 스크립트 실행 예시

에이전트가 종료된 상태에서도 메시지를 수신할 수 있도록 외부 리스너 데몬을 운영하는 아키텍처를 채택했다. 데몬은 수신된 메시지를 파일 브리지 방식으로 인박스에 저장하며, 메시지 도착 시 자동으로 새로운 CC 세션을 생성하는 반응형 웨이크(Reactive Wake) 기능을 수행한다. 특히 높은 우선순위 메시지의 경우 세션 시작 전 텔레그램 알림을 발송하는 기능이 포함되어 실시간 대응력을 높였다.

외부 에이전트로부터 수신된 메시지 본문을 신뢰할 수 없는 데이터로 규정하여 프롬프트 주입 공격을 방어한다. 행동 스킬 교육을 통해 수신된 내용을 실행 지침이 아닌 단순 데이터로 처리하도록 강제하며 보안성을 확보했다. 새로운 세션 생성 시 발생하는 약 10만 토큰의 비용 문제는 프롬프트 캐싱 기술을 활용하여 경제성을 확보하는 전략을 사용한다.

용어 해설

모델 컨텍스트 프로토콜(Model Context Protocol (MCP)): — AI 모델이 외부 도구, 데이터 소스 및 다른 에이전트와 상호작용할 수 있도록 설계된 개방형 표준 프로토콜이다. 이 아티클에서는 서로 다른 에이전트 인스턴스 간의 통신 및 도구 공유를 위한 기반 기술로 활용된다.
프롬프트 캐싱(Prompt Caching): — 자주 반복되는 프롬프트 데이터를 API 서버 측에 저장하여 재사용함으로써 추론 비용과 지연 시간을 줄이는 기술이다. 새로운 세션을 시작할 때 발생하는 약 10만 토큰의 비용 부담을 완화하는 핵심 수단으로 언급된다.
프롬프트 주입(Prompt Injection): — 외부 입력 데이터에 악의적인 명령을 포함시켜 AI 모델의 원래 지침을 무시하고 공격자의 의도대로 행동하게 만드는 보안 위협이다. 에이전트 간 통신 시 수신된 메시지를 신뢰할 수 없는 데이터로 취급하여 실행을 방지하는 보안 설계가 포함되었다.

언급된 도구

Swarmbus추천링크

MCP 기반 에이전트 간 통신 브로커 및 메시지 관리 도구

OpenClaw중립

Raspberry Pi 등에서 실행 가능한 오픈소스 AI 에이전트 구현체

언급된 리소스

GitHubSwarmbus GitHub Repository

문서Swarmbus Documentation