구조와 원리 — DureClaw

→

3분이면 팀 완성

STEP 01

한 줄로 설치

Claude Code 플러그인 + Phoenix 서버 + MCP 등록까지 자동으로 처리된다.

bash <(curl -fsSL dureclaw.baryon.ai/install)

→

STEP 02

워커 머신 연결 keyless

다른 머신에서 한 줄 실행. 시크릿 불필요 — 노드가 서버에 가입 요청하면 사설망(Tailscale) 피어는 자동 승인·토큰 발급.

bash <(curl -fsSL …/agent)
# OAH_SECRET 없이 자동 등록

→

STEP 03

Claude에게 말하기

Claude Code에서 슬래시 명령 하나. 팀 구성부터 태스크 배분까지 Claude가 알아서 한다.

/두레팀 또는 "팀 설정해줘"

🔑 키리스 접근 — 시크릿을 미리 나눠주지 않는다

노드는 공유 시크릿을 몰라도 됩니다. 서버에 가입 요청하면 서버가 승인 후 노드별 토큰을 발급합니다. 마스터 시크릿은 어디에도 복사되지 않고, 토큰은 노드마다 개별 폐기할 수 있습니다.

① 가입 · 자동 승인

노드가 POST /api/join → Tailscale 사설망 피어는 즉시 자동 승인(zero-click). 밖에서 오면 운영자 승인 대기.

② 노드별 토큰

서버가 per-node 토큰 발급 → 노드가 캐시. 다음부턴 즉시 재접속. 마스터 시크릿 무노출·개별 폐기 가능.

③ 단일 지시자

워커는 연결·수신·보고만. 업무지시(디스패치)는 마스터 한 곳에서만 — 워커 토큰으로는 지시 불가.

Windows·RPi Zero처럼 인증을 두기 어려운 머신도 그대로 합류. 키 없는 손, 하나의 두뇌.

→

왜 SSH가 아니라 DureClaw인가

SSH는 "이종 인바운드"를 그대로 노출하고,
DureClaw는 그걸 "균질 아웃바운드 + 정규화 마커"로 바꾼다.

Linux↔Mac은 둘 다 POSIX라 "키 한 번 → 끝". 하지만 Windows가 노드에 끼는 순간 SSH가 기대는 전제가 5개 축에서 동시에 깨진다 — Windows가 낄수록 이 차이가 커진다.

축	SSH — 이종 인바운드 (Windows에서)	DureClaw — 균질 아웃바운드
셸	cmd ↔ PowerShell ↔ WSL 혼재 — 따옴표·이스케이프 파손	`[SHELL]` 데몬이 OS별 셸 자동 선택
경로	`C:\…` 역슬래시·드라이브레터·`cd /d`	경로를 그대로 전달, 노드가 로컬 해석
인코딩	cmd 코드페이지 → mojibake	`[WRITE:b64]` 바이트 그대로 기록
개행	CRLF ↔ LF — heredoc·스크립트 깨짐	base64 전송 → 개행 무관
인증	관리자는 `administrators_authorized_keys` + 무상속 ACL + UAC 상승	keyless 등록 — 인바운드 인증·방화벽·상승 전부 없음

실측 실험: 같은 과제(Mac→Windows 파이썬→exe 빌드)에서 DureClaw는 셋업 0 · 6단계로 exe 완성, SSH는 작업 전 인증에서 4번 실패 + UAC 벽으로 한 줄도 실행 못 함. 차이는 전송 속도가 아니라 온보딩·인증·이종-OS 정규화의 마찰 제거다.

🔄 복원력 · 가시성 — SSH엔 없는 것

서버를 재가동·업그레이드해도 노드가 자동 재접속(지수 백오프)하고, 실시간 대시보드로 fleet 현황을 본다. SSH는 세션이 끊기면 수동 재연결이고, "누가 살아있나"를 보는 화면이 없다.
실측: 이 프로젝트를 개선·배포하며 서버를 여러 번 재시작했지만 전 노드가 매번 스스로 복귀.

균질 Linux↔Linux에서도 SSH엔 구조적 한계가 남습니다 — 인바운드 도달성(NAT/방화벽 뒤 불가) · 1:N 팬아웃 · 지속성 · fleet 가시성 · 셸 밖 능력. 실측 한 방: 같은 리눅스 박스에 SSH inbound :22는 timeout(못 들어감)인데 DureClaw는 outbound로 붙어 exe까지 빌드했습니다. SSH는 전송 파이프, DureClaw는 fleet 버스 — 레이어가 다릅니다.

📄 전체 실험 리포트 보기 — 태스크별 수치 · 균질/이종 비교 · 구조적 한계 ↗

→

어디에 위치하는가 — L4→L0 수직 스택

Claude Code 에코시스템에서 대부분의 메타팩토리는 L3에서 구조/설정을 뱉고 외부 런타임에 넘깁니다. DureClaw는 팀을 생성(L3)할 뿐 아니라, 그 팀이 실제로 도는 런타임(L1)·물리 실행(L0)을 소유하고, 산출물을 평가해 되먹이는 자기개선(L4)까지 한 몸으로 가진 유일한 수직 스택입니다. One vertical from self-improvement down to the physical actuator.

L4

RSI / 자기개선 ★ DureClaw 고유

5단계 학습 루프(관측→종합→목적화→지식화→학습·선택) + eval + 결정 동결. 팀 산출물을 평가해 결정론적 스킬로 결정화하고 L3 패턴에 되먹임 — 팩토리 자체를 진화. Recursive self-improvement above the meta-factory.

L3

Meta-Factory / Team-Architecture 이웃: Archon · meta-harness

도메인 문장 → 에이전트 팀 + 스킬. /dureclaw 6패턴(Pipeline · Fan-out/in · Expert Pool · Producer-Reviewer · Supervisor · Hierarchical).

L2

Cross-Harness Workflow 이웃: ECC

스킬·룰·훅 표준화 + 플러그인 마켓플레이스 로더 — 여러 하니스 간 공통 규약.

L1

Orchestration Runtime ★ DureClaw 고유

Phoenix Channel 버스 + MCP + Work Key + DETS 영속 + keyless brain 위임. 팀이 실제로 실행되는 분산 메시지 버스.

L0

Physical Execution ★ DureClaw 고유

edgeclaw(shell·GPIO·신호탑·PA) · webclaw(브라우저) · deskclaw(GUI). Win·mac·Linux·Pi·riscv — 물리 액추에이터까지 "승인=물리 결과".

Archon은 런타임 결정론을 만든다. DureClaw는 L4 결정 동결로 그 결정론을 L0 엣지에 직접 내린다 — 생성·실행·자기개선을 한 수직으로.

🗺 clawfit 에코시스템 맵에서 보면 — DureClaw = L2

clawfit 은 Claude Code 에코시스템의 162+ 도구를 7계층(L1–L7)으로 분류하는 추천 엔진·생태계 맵입니다. 그 기준에서 DureClaw는 L2 — Meta wrappers / harnesses / orchestration: Claude Code·pi 같은 L1 베이스 런타임 위에 올라타는 메타-래퍼/오케스트레이션 슬롯입니다(이웃: SuperClaude · Archon · oh-my-*).

⚠️ 두 렌즈는 직교합니다. clawfit의 L1–L7은 "성숙도 사다리가 아니라 아키텍처 역할"을 가르는 가로 렌즈(어느 슬롯인가). 위의 L4→L0은 세로 렌즈 — DureClaw가 그 L2 역할을 하면서 실제로 자기개선(L4)부터 물리 실행(L0)까지 몇 계층을 직접 소유하는가를 보여줍니다. 같은 사물의 다른 축.

clawfit — 에코시스템 맵 ↗ 7계층 택소노미 (L1–L7) ↗

→

에코시스템 — 한 두뇌, 여러 손

마스터(Claude)가 두뇌, 각 claw는 서로 다른 손입니다. 같은 버스·같은 keyless 위임으로 물리 세계·브라우저·데스크톱 어디로든 손을 뻗습니다. One brain, many hands — one bus, one keyless delegation.

네이티브 노드 / NATIVE NODES

edgeclaw ↗

OS·물리 노드. 단일 정적 Go 바이너리 — Win·Mac·Linux·Pi Zero·riscv… shell·sensor·GPIO·LED·부저·릴레이·신호탑까지(승인=물리 결과).

go · gpio · cross-platform

webclaw ↗

브라우저 노드. Chrome MV3 확장 — 브라우저를 fleet에 빌려준다(fetch·DOM, CORS-free, 상시). 순수 JS.

chrome-extension · browser

deskclaw ↗

데스크톱 GUI 노드. Win/macOS — 눈(스크린샷)+손(클릭·타이핑·앱실행). RPA record→replay: 한 번 가르치면 LLM 없이 재생.

go · desktop · rpa

어댑터 / ADAPTERS — 기존 도구를 fleet에

picoclaw(Go) · nanobot(Py) · zeroclaw(Rust) · nullclaw(Zig) — 각 repo에 dureclaw/ 브리지를 더해 같은 버스에 합류.

문서·데모 / DOCS & DEMO

📄 whitepaper ↗

기술 백서 — 아키텍처·원칙·보안·사례. 한국어판 / English PDF.

🏭 dure-factory ↗

분산 엣지 × 제조 MES 데모 — 센싱→종합→승인→결정 동결. DureClaw + Open MES Korea.

🗺 clawfit ↗

Claude Code 에코시스템 맵 — 162+ 도구를 7계층(L1–L7)으로 분류·추천. DureClaw가 어디에 있는지(L2) 보여준다.

전체 조직 / all repos → github.com/DureClaw

→

시스템 아키텍처

① Claude Code (오케스트레이터, 맥북)
     /plugin marketplace add DureClaw/dureclaw
   └─ MCP (oah-mcp) → Phoenix WebSocket

② Phoenix Server (메시지 버스)
     bash <(curl -fsSL https://dureclaw.baryon.ai/server)
   ws://host:4000

③ oah-agent (워커, 각 머신)
     PHOENIX=ws://host:4000 ROLE=builder bash <(curl -fsSL https://dureclaw.baryon.ai/agent)
   → WebSocket 연결 → task.assign 수신
   → AI 백엔드 실행 (claude / pi / gemini / aider / codex)
   → task.result 반환