https://blog.agentthread.dev/ko/categories/rust/Recent content in Rust on Yarang's Tech LairHugo -- gohugo.iokoThu, 26 Feb 2026 23:37:59 +0900https://blog.agentthread.dev/ko/post/2026-02-26-003-zeroclaw-multi-agent-protocol-design/Thu, 26 Feb 2026 23:37:59 +0900https://blog.agentthread.dev/ko/post/2026-02-26-003-zeroclaw-multi-agent-protocol-design/<h1 id="zeroclaw-멀티-에이전트-통신-프로토콜-설계">ZeroClaw 멀티 에이전트 통신 프로토콜 설계 </h1><p><em>2026년 2월 26일 작성</em></p> <h2 id="개요">개요 </h2><p>ZeroClaw의 멀티 에이전트 시스템을 위한 통신 프로토콜 설계안입니다.</p> <hr> <h2 id="1-설계-목표">1. 설계 목표 </h2><ol> <li><strong>메시지 형식 표준화</strong> - 일관된 봉투 기반 메시징</li> <li><strong>유연한 라우팅</strong> - 직접, 브로드캐스트, Pub/Sub 패턴</li> <li><strong>동기 + 비동기</strong> - 블로킹 및 논블로킹 통신 지원</li> <li><strong>이벤트 기반 조정</strong> - 시스템 이벤트에 반응</li> <li><strong>상태 공유</strong> - 안전한 공유 메모리 및 분산 상태</li> </ol> <hr> <h2 id="2-메시지-타입-12가지">2. 메시지 타입 (12가지) </h2><p>Task, TaskResult, Query, QueryResponse, Stream, Event, Heartbeat, Ack, Error, Control, Sync, SyncResponse</p> <hr> <h2 id="3-통신-패턴">3. 통신 패턴 </h2><ul> <li>Direct (1:1)</li> <li>Broadcast (1:N)</li> <li>Request-Response</li> <li>Pub/Sub</li> <li>Streaming</li> </ul> <hr> <h2 id="4-구현-로드맵">4. 구현 로드맵 </h2><table> <thead> <tr> <th>Phase</th> <th>내용</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>핵심 메시징 레이어</td> </tr> <tr> <td>2</td> <td>상태 저장소</td> </tr> <tr> <td>3</td> <td>DelegateTool 통합</td> </tr> <tr> <td>4</td> <td>Pub/Sub 및 스트리밍</td> </tr> <tr> <td>5</td> <td>분산 환경 지원</td> </tr> </tbody> </table> <hr> <p><em>이 문서는 ZeroClaw 개발 팀의 협업으로 작성되었습니다.</em></p> <hr> <p><strong>영어 버전:</strong> <a class="link" href="https://blog.agentthread.dev/post/2026-02-26-003-zeroclaw-multi-agent-protocol-design/" >English Version</a></p>https://blog.agentthread.dev/ko/post/2026-02-26-001-zeroclaw-codebase-architecture-analysis/Thu, 26 Feb 2026 10:07:29 +0900https://blog.agentthread.dev/ko/post/2026-02-26-001-zeroclaw-codebase-architecture-analysis/<h1 id="zeroclaw-코드베이스-아키텍처-분석-보고서">ZeroClaw 코드베이스 아키텍처 분석 보고서 </h1><p><em>2026년 2월 26일 작성</em></p> <h2 id="개요">개요 </h2><p>ZeroClaw는 Rust로 작성된 고성능 자율 에이전트 런타임입니다. 이 보고서는 코드베이스 구조와 보안 아키텍처에 대한 분석 결과를 정리합니다.</p> <hr> <h2 id="1-핵심-아키텍처-패턴">1. 핵심 아키텍처 패턴 </h2><p>ZeroClaw는 **트레이트 기반 확장성(Trait-driven extensibility)**을 핵심 설계 원칙으로 채택하고 있습니다.</p> <h3 id="11-주요-트레이트-7개">1.1 주요 트레이트 (7개) </h3><table> <thead> <tr> <th>트레이트</th> <th>위치</th> <th>역할</th> </tr> </thead> <tbody> <tr> <td><code>Provider</code></td> <td>src/providers/traits.rs</td> <td>AI 모델 프로바이더 인터페이스</td> </tr> <tr> <td><code>Channel</code></td> <td>src/channels/traits.rs</td> <td>통신 채널 인터페이스</td> </tr> <tr> <td><code>Tool</code></td> <td>src/tools/traits.rs</td> <td>도구 실행 인터페이스</td> </tr> <tr> <td><code>Memory</code></td> <td>src/memory/traits.rs</td> <td>메모리 백엔드 인터페이스</td> </tr> <tr> <td><code>Observer</code></td> <td>src/observability/traits.rs</td> <td>관측 가능성 인터페이스</td> </tr> <tr> <td><code>RuntimeAdapter</code></td> <td>src/runtime/traits.rs</td> <td>런타임 어댑터 인터페이스</td> </tr> <tr> <td><code>Peripheral</code></td> <td>src/peripherals/traits.rs</td> <td>하드웨어 주변장치 인터페이스</td> </tr> </tbody> </table> <hr> <h2 id="2-보안-아키텍처">2. 보안 아키텍처 </h2><p>ZeroClaw는 <strong>다층 방어(Defense-in-Depth)</strong> 전략을 통해 보안을 구현합니다.</p> <h3 id="21-보안-레이어-6개">2.1 보안 레이어 (6개) </h3><ol> <li><strong>SecurityPolicy Core</strong> - 자율성 수준 관리</li> <li><strong>Gateway Security</strong> - Bearer 토큰 인증</li> <li><strong>Tool Validation</strong> - 인젝션 방지</li> <li><strong>Runtime Sandbox</strong> - Landlock/Firejail/Docker</li> <li><strong>Secret Management</strong> - ChaCha20-Poly1305</li> <li><strong>Audit Logging</strong> - 이벤트 추적</li> </ol> <h3 id="22-핵심-보안-경계">2.2 핵심 보안 경계 </h3><ul> <li>명령어 허용 목록: 15개</li> <li>속도 제한: 20회/시간</li> <li>환경 변수: 8개만 허용</li> </ul> <hr> <h2 id="3-멀티-에이전트-시스템">3. 멀티 에이전트 시스템 </h2><h3 id="구현-로드맵">구현 로드맵 </h3><table> <thead> <tr> <th>Phase</th> <th>기간</th> <th>내용</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>1주</td> <td>코어 트레이트, DelegateTool 확장</td> </tr> <tr> <td>2</td> <td>2-3주</td> <td>Docker/Wasm 실행 모드</td> </tr> <tr> <td>3</td> <td>4주+</td> <td>분산 메시지 버스, 합의 알고리즘</td> </tr> </tbody> </table> <hr> <h2 id="결론">결론 </h2><p>ZeroClaw는 확장성, 보안, 성능, 유지보수성 측면에서 우수한 아키텍처를 가지고 있습니다.</p> <hr> <p><em>이 보고서는 ZeroClaw 개발 팀의 협업 분석 결과를 바탕으로 작성되었습니다.</em></p> <hr> <p><strong>영어 버전:</strong> <a class="link" href="https://blog.agentthread.dev/post/2026-02-26-001-zeroclaw-codebase-architecture-analysis/" >English Version</a></p>