DureClaw 멀티머신 AI 팀 오케스트레이션
Claude Code 네이티브 플러그인 · v0.4.0 · 오픈소스

두레클로 — 두레(협동 경작) 정신을 AI 에이전트에 담다

내 모든 머신이
AI 팀이 된다

Claude Code를 창 하나에서만 쓰고 있다면?
DureClaw는 내 모든 머신을 하나의 팀으로 연결한다.
Mac이 오케스트레이트하는 동안, GPU 서버·Linux 박스·라즈베리파이가 동시에 일한다.

한 줄 설치 — 서버 + MCP + Tailscale 안내 포함
bash <(curl -fsSL https://dureclaw.baryon.ai/install)

서버 자동 시작 · Claude Code MCP 자동 등록 · Tailscale 보안 안내 포함 · 소스 보기 ↗

이런 분을 위해

🖥️
맥 + 서버/워크스테이션 보유 개발자
메인 Mac + GPU 서버 or Linux 박스
기존: Claude Code는 맥에서만. 서버는 별도 SSH로 수동 작업.
DureClaw: Mac Claude가 지시하면 서버가 동시에 빌드·테스트·학습 실행.
🤖
집·회사 멀티 셋업 개발자
회사 Mac + 집 워크스테이션 (Tailscale로 연결)
기존: 한 곳에서만 작업 가능. 다른 머신은 놀고 있음.
DureClaw: 어디서든 Claude에게 말하면 두 머신이 동시에 태스크 수행.
👥
소규모 팀·스터디그룹
팀원 각자의 머신에 AI 에이전트 설치
기존: AI 도구를 각자 따로. 결과 공유가 느리고 번거롭다.
DureClaw: 팀장 Claude가 태스크 배분 → 모든 머신이 협력해서 결과 통합.
→

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처럼 인증을 두기 어려운 머신도 그대로 합류. 키 없는 손, 하나의 두뇌.
★

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

마스터(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
≣

어디에 위치하는가 — 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) ↗
⚡

왜 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 버스 — 레이어가 다릅니다.
📄 전체 실험 리포트 보기 — 태스크별 수치 · 균질/이종 비교 · 구조적 한계 ↗
01

지원 환경

🍎
macOS — Apple Silicon
M1 / M2 / M3 / M4 · arm64
서버 ✓ 워커 ✓ 사전빌드
$ bash <(curl -fsSL https://dureclaw.baryon.ai/server)
✅ darwin-arm64 바이너리 다운로드 완료
✅ Tailscale 연결됨: 100.x.x.x
→ 서버 시작 · ws://100.x.x.x:4000
완전 지원 · 권장 환경
💻
macOS — Intel
Core i5/i7/i9 · x86_64
서버 ✓ 워커 ✓ 사전빌드
$ bash <(curl -fsSL https://dureclaw.baryon.ai/server)
✅ darwin-x86_64 바이너리 다운로드 완료
→ 서버 시작 · ws://192.168.x.x:4000
완전 지원
🐧
Linux — x86_64
Ubuntu / Debian / CentOS · amd64
서버 ✓ 워커 ✓ 사전빌드 Docker
$ ROLE=builder bash <(curl -fsSL https://dureclaw.baryon.ai/agent)
✅ linux-x86_64 에이전트 설치 완료
✅ claude-cli 감지됨
→ builder@gpu-server 연결 완료
완전 지원 · GPU 서버 권장
🫐
Raspberry Pi 4 / 5
Linux arm64 · aarch64
서버 ✓ 워커 ✓ 사전빌드
$ ROLE=executor bash <(curl -fsSL https://dureclaw.baryon.ai/agent)
✅ linux-arm64 에이전트 설치 완료
✅ pi 감지됨
→ executor@raspberrypi 연결 완료
완전 지원 · executor 역할 최적
📡
Raspberry Pi Zero W/2W
WiFi 내장 · armv6 / arm64 · 512MB RAM
워커 ✓ JS 번들
$ ROLE=executor bash <(curl -fsSL https://dureclaw.baryon.ai/agent)
✅ JS 번들 모드 (armv6)
⚠ aider 경량 모드 사용
→ executor@zero-w 연결 완료 (WiFi)
IoT 센서 · 경량 executor · WiFi로 연결
🪟
Windows 10 / 11
PowerShell · x86_64
워커 ✓ Docker
PS> irm https://dureclaw.baryon.ai/agent.ps1 | iex
→ 서버 자동 탐색 (oah.local · Tailscale 피어)
✅ pi 설치 완료
→ builder@DESKTOP-WIN 연결 완료
워커 지원 · PowerShell 설치 스크립트
🐳
Docker
모든 플랫폼 · ghcr.io/dureclaw/dureclaw
서버 ✓ 컨테이너
$ docker compose up
✅ ghcr.io/dureclaw/dureclaw:latest
Elixir 불필요 · /data 볼륨 마운트
→ 서버 준비 완료 · :4000
Elixir 없이 즉시 실행
02

시스템 아키텍처

① 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 반환
03

빠른 시작

1
Claude Code 플러그인
필수 · 로컬 실행 가능
여기까지만 해도 바로 사용 가능.
Claude Code가 오케스트레이터로 로컬 태스크를 실행한다.
2
Phoenix 서버 설치
멀티머신 확장 시 · Docker/바이너리
Elixir 불필요.
사전빌드 바이너리 → Docker 자동 선택.
대시보드: http://서버IP:4000/
3
워커 에이전트 설치
각 원격 머신 · /setup-team 자동 안내
또는 Claude Code에게 말하세요:
"워커 추가해줘" / "팀 설정해줘"
→ 서버 IP 자동 감지 + 복붙 명령어 출력
04

AI 팀원 추가하기

새 머신에서 아래 명령어를 실행하면 설치·설정·연결이 자동 처리된다. 서버IP는 Tailscale IP(100.x.x.x) 또는 LAN IP로 교체하거나, "워커 추가해줘"라고 Claude에게 말하면 자동으로 채워준다.

builder
코드 작성
PHOENIX=ws://서버IP:4000 ROLE=builder bash <(curl -fsSL https://dureclaw.baryon.ai/agent)
tester
테스트 실행
PHOENIX=ws://서버IP:4000 ROLE=tester bash <(curl -fsSL https://dureclaw.baryon.ai/agent)
analyst
코드 분석
PHOENIX=ws://서버IP:4000 ROLE=analyst bash <(curl -fsSL https://dureclaw.baryon.ai/agent)
executor
명령 실행
PHOENIX=ws://서버IP:4000 ROLE=executor bash <(curl -fsSL https://dureclaw.baryon.ai/agent)

Work Key 생략 시 서버에서 자동 감지 · 에이전트 이름 미지정 시 역할@머신이름으로 자동 설정 · Windows는 PowerShell 스크립트 지원

05

활용 예시 — fix-agent

3개의 에이전트가 협력해 레포지토리 버그를 자동 분석·수정·PR 생성하는 파이프라인.

시작
Claude Code가 버그 리포트 수신 → 에이전트 배분
analyzer→버그 탐지·분석
분석 완료
분석 결과 → fixer에게 전달
analyzer✓root cause 특정
fixer→코드 수정
수정 완료
수정 코드 → tester 검증 + PR 생성
fixer✓패치 완료
tester→테스트 실행 + PR 생성
PR 자동 생성 · 테스트 통과 확인 · 리뷰 요청까지 자동화
06

채널 이벤트

EVENTDIRECTIONPAYLOAD (주요 필드)설명
task.assignorch → agentto, task_id, role, instructions태스크 할당. 대상 agent가 AI 백엔드 실행.
task.progressagent → alltask_id, message, output_tail10초마다 진행 상황 브로드캐스트.
task.resultagent → alltask_id, exit_code, artifacts[]태스크 완료 보고. ARTIFACT: 라인 자동 파싱.
task.cancelorch → agenttask_id실행 중 태스크 취소. AbortController 신호.
task.blockedany → alltask_id, reason진행 불가. orchestrator가 재배정 판단.
state.updateany → serverkey: valueWork Key 상태 업데이트 (DETS 영속).
mailbox.postany → targetto, body오프라인이면 큐잉, 온라인이면 즉시 전달.
agent.helloserver → allagent, role, machine에이전트 JOIN 알림.
agent.byeserver → allagent, role에이전트 퇴장 알림.
07

REST API

METHODENDPOINT설명
GET/api/health서버 상태 · work_key 개수
GET/api/presence온라인 에이전트 목록 (name, role, machine)
GET/api/work-keysWork Key 목록
GET/api/work-keys/latest최신 Work Key (없으면 404)
POST/api/work-keys새 Work Key 발급
POST/api/task태스크 디스패치 { role, to, instructions }
GET/api/task/:id태스크 결과 폴링
POST/api/task/:id/result태스크 결과 저장 · 채널 브로드캐스트
GET/api/state/:wkWork Key 상태 조회
PATCH/api/state/:wkWork Key 상태 업데이트
GET/api/mailbox/:agent에이전트 mailbox 읽기
POST/api/mailbox/:agent에이전트 mailbox 메시지 전송
08

스크린샷

DureClaw 대시보드 라이브 데모 — 에이전트 팀 태스크 디스패치
OAH control 대시보드 — 6개 에이전트 온라인
OAH 컨트롤 대시보드 6개 에이전트 온라인 · Work Key 관리 · 실시간 이벤트 로그
태스크 디스패치 — builder/tester/orchestrator 에이전트 선택
태스크 디스패치 에이전트 선택 → Instructions 입력 → 전송 한 번으로 팀 전체에 배분
Claude Code에서 DureClaw로 태스크 디스패치 — 터미널
Claude Code 터미널 오케스트레이터가 자연어로 지시 → DureClaw가 원격 에이전트에 실행
↗

데모 시나리오

라이브 데모 / LIVE — 실제 시스템 캡처
fan-out → 마스터 종합
① fan-out → 종합
불량 fan-out → 이종 노드 fan-in → 마스터 SUGGEST(원인·신뢰도·권고).
결정 동결 — LLM as compiler
② 결정 동결
승인 → 룰 동결 → 같은 패턴은 LLM 0회·2µs 재사용(15.6s 절감).
deskclaw RPA record→replay
③ deskclaw RPA
한 번 가르치면(record) → [RUN]은 LLM 없이 결정론적 재생.
# 문제
$ claude
# 창 하나 = 머신 하나
# GPU·Linux·Pi는 대기
SCENE 01 0:00 – 0:15
문제: Claude Code는 창 하나에서만
"Mac에서 Claude Code를 쓰고 있는데 — 옆에 GPU 서버가 그냥 놀고 있어요."

Mac 터미널에서 Claude Code 실행 중. 서버 터미널은 idle. 두 창을 번갈아 가며 수동으로 SSH → 복붙하는 불편함.
$ bash <(curl -fsSL
   dureclaw.baryon.ai/install)
✓ 서버 + MCP + Tailscale
SCENE 02 0:15 – 0:45
한 줄 설치 — 서버 + MCP 자동 등록
Mac 터미널에서: bash <(curl -fsSL dureclaw.baryon.ai/install)

자동 처리: Phoenix 서버 백그라운드 시작 → OAH_SECRET 생성 → Claude Code MCP 등록 → Tailscale IP 감지 → 워커 연결 명령어 출력까지 한 번에.
$ PHOENIX=ws://100.x:4000
   bash <(…/agent)
✓ builder@server 연결됨
SCENE 03 0:45 – 1:05
워커 머신에서 한 줄 연결
GPU 서버 터미널에서 install.sh가 출력한 명령어 복붙:
PHOENIX=ws://100.x.x.x:4000 bash <(curl -fsSL …/agent)

✅ builder@gpuserver 연결 완료 메시지. 대시보드 http://localhost:4000에서 에이전트 온라인 확인.
claude › /두레팀
"팀 설정해줘"
→ N개 머신에 fan-out
SCENE 04 1:05 – 1:25
Claude에게 팀 구성 지시
Claude Code 터미널: /두레팀 입력

Claude가 자동으로: 온라인 에이전트 스캔 → Work Key 생성 → 팀 매니페스트 구성 → 역할 배분.

팀 현황 출력: orchestrator@mac · builder@gpuserver
두 머신이 동시에 — fleet fan-out
SCENE 05 1:25 – 2:30
두 머신이 동시에 — The Magic Moment
"프론트엔드 빌드는 Mac에서, 백엔드 테스트는 서버에서 동시에 돌려줘."

두 터미널이 동시에 움직인다. Mac: npm run build 실행 중 · GPU 서버: pytest tests/ 병렬 실행.

Claude가 양쪽 결과를 수집해 통합 리포트 출력. 전체 소요 시간: 직렬 대비 ~50% 단축.

설치 → 워커 연결 → 한 줄 지시 → 동시 실행 · 약 2.5분. 위 라이브 데모는 실제 시스템 캡처.

09

Changelog

v0.5.0 latest
2026-06-16
  • feature5단계 학습 루프 — 관측→종합→목적화→지식화→학습·선택 (승인이 아니라 사람이 학습)
  • feature결정론적 스킬 결정화 — 채택된 산출물을 재추론 없이 재실행 가능한 SKILL.md로 동결
  • feature코딩 백엔드 pi 전환 (@earendil-works/pi-coding-agent) — opencode 대체
  • feature브레인 노드 위임 — 마스터 단일 인증, 키 없는 서브노드(Pi Zero 포함)가 마스터 pi로 위임
  • featureWindows 무설정 자동탐색 — mDNS(oah.local) + Tailscale 피어 스캔
  • fixWindows agent.ps1 출력 인코딩(mojibake) 수정 + 도달성 진단
v0.4.0
2025-05-04
  • securityBearer token auth (OAH_SECRET) — REST + WebSocket 전체 보호
  • securityWork Key 무작위화 → WK-<8hex>
  • securityPhoenix 서버 Tailscale IP 바인드 (0.0.0.0 제거)
  • securityOAH_BIND_IP로 바인드 주소 명시 지정
  • feature대시보드 URL 해시 네비게이션 (탭/에이전트 상태 북마크)
  • feature🖥 Monitors 탭 — GPU/RAM/ollama 실시간 모니터링
v0.3.0
2025-04
  • feature--version 플래그 + presence 버전 메타데이터
  • featureCI GitHub Releases 바이너리 자동 빌드/배포
  • featuremailbox 폴링 폴백 — WebSocket task.assign 유실 방지
  • fixPOST /api/task 커스텀 task_id 존중
  • fix에이전트 설치 시 PATH + rc 파일 영속 저장
v0.2.0
2025-03
  • feature파일 변경 추적 탭 — ARTIFACT 이벤트 실시간 표시
  • feature에이전트 대화 탭 — 이벤트 타임라인
  • featureWK State 편집기 — 공유 컨텍스트 직접 수정
  • featureTailscale 사설망 통합 — 원격 머신 에이전트 연결
  • featureDETS 영속 상태 — 재시작 후 Work Key 유지
v0.1.0
2025-02
  • featurePhoenix WebSocket 채널 기반 태스크 오케스트레이션
  • feature[SHELL] 태스크 원격 에이전트 실행
  • featureWork Key 생성/관리 + 에이전트 presence 추적
  • featureREST API + 대시보드 기본 UI
⚙

제조 현장 하드웨어 조합

실제 제조공정에 바로 설치하는 권장 조합입니다. 모두 keyless(엣지에 키 0, 마스터가 두뇌) · edgeclaw 한 줄 설치(curl -fsSL .../install.sh | sh). 제품은 예시이며 동등 사양으로 대체 가능합니다. Recommended hardware kits for the shop floor — keyless, one-line install.

📏 거리·근접 센싱
Raspberry Pi Zero 2 W + HC-SR04 초음파 센서. 컨베이어 위치·재고·접근 감지.
edgeclaw · sensor
Pi Zero 2 W ↗ · HC-SR04 ↗
🌡 금형·설비 온도
Raspberry Pi 4·5 + MAX31855 열전대 앰프 + K형 열전대. 사출 금형온도·베어링 온도.
edgeclaw · sensor
Pi 5 ↗ · MAX31855+열전대 ↗
🚦 신호탑·안돈 (승인=물리)
Pi + 5V 릴레이 모듈 + 산업 신호탑(패트라이트) + 부저. 승인 시 🔴 점등·경보.
edgeclaw · physical-edge
릴레이 모듈 ↗ · PATLITE 신호탑 ↗
👁 비전 검사
NVIDIA Jetson Orin Nano + USB 산업 카메라. 외관 불량·스크래치 검출(마스터 비전 종합).
edgeclaw + 마스터 비전
Jetson Orin Nano ↗ · Arducam ↗
🔌 현장 게이트웨이·PLC
산업용 팬리스 IPC(x86) + USB-RS485(Modbus RTU). 기존 PLC·설비 시리얼 수집.
edgeclaw · shell/serial
USB-RS485 ↗ · Advantech IPC ↗
🖥 현장 PC GUI 자동화
기존 Windows 현장 PC(MES·ERP 화면). 화면을 보고 클릭·입력, RPA로 반복 자동화.
deskclaw · RPA
기존 PC 자산 활용 — 추가 HW 0
🔊 음성 안내(PA)
Raspberry Pi + USB 사운드카드 + 스피커. 합류·불량·승인 음성 안내(헤더 납땜 불필요).
edgeclaw · audio
범용 USB 오디오 — WAV 바이너리 내장
통신 프로토콜 게이트웨이 / FIELDBUS GATEWAYS — 기존 설비·PLC를 버스에

설비가 쓰는 산업 프로토콜을 게이트웨이로 표준화해 edgeclaw가 수집한다. edgeclaw는 게이트웨이 옆(또는 산업용 리눅스 GW 위)에서 돈다.

프로토콜 / 용도 대표 게이트웨이 링크
시리얼(RS-232/422/485) → EthernetMoxa NPort 5100NPort 5100 ↗
Modbus RTU/ASCII ↔ Modbus TCPMoxa MGate MB3180/3280/3480MGate MB3000 ↗
Modbus ↔ PROFINET / EtherNet/IPMoxa MGate 5103MGate 5103 ↗
OPC-UA ↔ Modbus/EtherNet-IP/PROFINETAdvantech EKI-1242IEIMSEKI OPC-UA ↗
MQTT / IIoT (Modbus·serial → MQTT)Moxa ioThinx 4510 · Advantech ADAM-6000ioThinx ↗ · ADAM-6000 ↗
멀티 필드버스(PROFIBUS·CC-Link·CANopen·EtherCAT)HMS Anybus CommunicatorAnybus ↗
BACnet (빌딩/설비)HMS IntesisIntesis BACnet ↗
리눅스 엣지 GW (edgeclaw 직접 구동)Advantech UNO-2271G V3UNO-2271G ↗
🧩 Pi는 한 예시 — 저비용 보드도 동일 바이너리 / ALSO RUNS ON

edgeclaw는 단일 정적 Go 바이너리(arm64·armv7·armv6·riscv64·amd64)로 빌드 → 아래 보드는 edgeclaw 릴리즈 바이너리를 그대로 받아 설치한다. 한국산 Hardkernel ODROID 포함. (어댑터 picoclaw는 Sipeed 계열 포크.)

보드 / Board 칩·아키텍처 edgeclaw 바이너리 링크
Raspberry Pi Zero 2 W / 4 / 5arm64 (Zero=armv6)linux-arm64 · armv6raspberrypi.com ↗
🇰🇷 Hardkernel ODROID-C4 / N2+ / M1Sarm64 (Amlogic/RK)linux-arm64hardkernel.com ↗
🇰🇷 Hardkernel ODROID-H4x86_64 (Intel)linux-amd64hardkernel.com ↗
Sipeed Lichee Pi 4ARISC-V (TH1520)linux-riscv64sipeed.com ↗
Sipeed Maix K230RISC-V (C908) · K210은 MCU(리눅스 미지원)linux-riscv64wiki.sipeed ↗
Milk-V Duo / MarsRISC-V (SG200x/JH7110)linux-riscv64milkv.io ↗
Radxa Rock 시리즈arm64 (RK3588 등)linux-arm64radxa.com ↗
Orange Piarm64 (일부 RISC-V)linux-arm64 · riscv64orangepi.org ↗
BeagleBone Black / AIarmv7 / arm64linux-armv7 · arm64beagleboard.org ↗
Luckfox PicoARM Cortex-A7 (armv7)linux-armv7luckfox.com ↗
🇰🇷 국산 제품 / KOREAN SUPPLIERS
분류 국내 업체 대표 제품 링크
신호탑·타워램프 (PATLITE 대안)큐라이트 · 카콘LED 타워램프·표시등 (ST/QTC, IO-Link)Qlight ↗ · KACON ↗
센서·온도조절기·계측오토닉스 · 한영넥스PID 온도조절기·근접/광센서·패널미터Autonics ↗ · 한영넥스 ↗
시리얼↔이더넷 (Moxa NPort 대안)솔내시스템 · 위즈넷시리얼 디바이스 서버(CSE), WIZ750SR·W5500Sollae ↗ · WIZnet ↗
PLC·산업제어LS일렉트릭 · 컴파일XGT/XGB PLC, CUBLOC 임베디드 컨트롤러LS ELECTRIC ↗ · Comfile ↗
산업용 IPC·패널PC·임베디드MX On(구 M2I) · 컴텍 · 비맥스 · 휴인스 · 코텍산업용 박스/팬리스 PC, HMI 터치패널, 임베디드 보드MX On ↗ · 컴텍 ↗ · 비맥스 ↗ · 휴인스 ↗ · 코텍 ↗
SBC·엣지 컴퓨터하드커널 (Hardkernel)ODROID (arm64 / x86)Hardkernel ↗
비전 카메라위드로봇 (Withrobot)oCam USB3.0 산업 카메라(UVC)Withrobot ↗
국내 총판 / 구매처 / KR DISTRIBUTORS
Moxa: 여의시스템(대표총판) · 위존 · 목사스토어  |  Advantech: 어드밴텍 한국 · 어드밴텍코리아  |  HMS·Anybus·Red Lion: anybus.com (한국 영업 본사 채널)
부품·게이트웨이 유통: 디바이스마트 · 엘레파츠 · 메카솔루션 · RS Korea · Mouser Korea
모든 노드 설치: curl -fsSL https://github.com/DureClaw/edgeclaw/releases/latest/download/install.sh | sh