RightNow-AI/openfang

Rust로 구축된 오픈소스 Agent OS. 137K LOC. 14 crates. 1,767개 이상의 테스트. Clippy 경고 제로.

단일 바이너리. 검증된 성능. 실제로 당신을 위해 작동하는 에이전트.

Documentation • Quick Start • Twitter / X

v0.5.10 (2026년 4월) OpenFang는 기능 구현이 완료되었으나 아직 1.0 버전 이전 단계입니다. 마이너 버전 간에 거친 부분이나 Breaking Changes(파괴적 변경 사항)가 있을 수 있습니다. 우리는 빠르게 배포하고 빠르게 수정합니다. v1.0 전까지 프로덕션 환경에서 사용하려면 특정 커밋에 고정(Pin)하여 사용하세요. 이슈는 여기서 보고해 주세요.

OpenFang는 **오픈소스 Agent Operating System (에이전트 운영체제)**입니다. 챗봇 프레임워크가 아닙니다. LLM을 감싸는 Python wrapper도 아닙니다.

HAND.toml: 도구(tools), 설정(settings), 요구사항(requirements) 및 대시보드 메트릭(dashboard metrics)을 선언하는 매니페스트(manifest).
System Prompt: 다단계 운영 플레이북(operational playbook). 한 줄짜리가 아닙니다. 이는 500단어 이상의 전문가 절차입니다.
SKILL.md: 런타임(runtime) 시 컨텍스트(context)에 주입되는 도메인 전문 지식 참조.
Guardrails: 민감한 작업에 대한 승인 게이트(approval gates) (예: Browser Hand는 구매 전 승인이 필요함).

모두 바이너리(binary)로 컴파일됩니다. 다운로드도, pip install도, Docker pull도 필요 없습니다.

Hand	실제 수행하는 작업
Clip	YouTube URL을 입력받아 다운로드하고, 최적의 순간을 식별하며, 자막과 썸네일이 포함된 세로형 쇼츠(shorts)로 편집하고, 선택적으로 AI 음성 해설(voice-over)을 추가한 뒤, Telegram 및 WhatsApp에 게시합니다. 8단계 파이프라인으로 작동하며, FFmpeg + yt-dlp + 5개의 STT 백엔드를 사용합니다.
Lead	매일 실행됩니다. 귀하의 ICP(Ideal Customer Profile, 이상적 고객 프로필)와 일치하는 잠재 고객을 발굴하고, 웹 조사를 통해 정보를 보강하며, 0-100점 사이의 점수를 매기고, 기존 데이터베이스와 중복을 제거한 뒤, CSV/JSON/Markdown 형식으로 검증된 리드(leads)를 전달합니다. 시간이 지남에 따라 ICP 프로필을 구축합니다.
Collector	OSINT(Open Source Intelligence, 공개 출처 정보)급 인텔리전스입니다. 대상(기업, 개인, 주제)을 지정하면 지속적으로 모니터링합니다: 변경 사항 감지, 감성 추적(sentiment tracking), 지식 그래프(knowledge graph) 구축, 그리고 중요한 변화가 발생할 때의 핵심 알림을 제공합니다.
Predictor	슈퍼포캐스팅(Superforecasting) 엔진입니다. 여러 소스에서 신호를 수집하고, 보정된 추론 체인(reasoning chains)을 구축하며, 신뢰 구간(confidence intervals)과 함께 예측을 수행하고, Brier score를 사용하여 자체 정확도를 추적합니다. 의도적으로 합의에 반대되는 논리를 펼치는 반대 의견 모드(contrarian mode)를 갖추고 있습니다.
Researcher	심층 자율 연구원입니다. 여러 소스를 교차 참조하고, CRAAP 기준(최신성(Currency), 관련성(Relevance), 권위성(Authority), 정확성(Accuracy), 목적성(Purpose))을 사용하여 신뢰성을 평가하며, APA 형식을 갖춘 인용 보고서를 생성하고 다국어를 지원합니다.
Twitter	자율적인 Twitter/X 계정 관리자입니다. 7가지 순환 포맷으로 콘텐츠를 생성하고, 최적의 참여(engagement)를 위해 게시물을 예약하며, 언급(mentions)에 응답하고, 성능 메트릭을 추적합니다. 승인 대기열(approval queue)이 있어 귀하의 승인 없이는 아무것도 게시되지 않습니다.

|
Browser |
웹 자동화 에이전트 (Web automation agent). 사이트를 탐색하고, 양식을 채우며, 버튼을 클릭하고, 다단계 워크플로 (multi-step workflows)를 처리합니다. 세션 지속성 (session persistence)을 갖춘 Playwright 브릿지를 사용합니다. 필수 구매 승인 게이트 (purchase approval gate): 명시적인 확인 없이는 절대로 귀하의 돈을 사용하지 않습니다.

# Researcher Hand를 활성화합니다. 즉시 작동을 시작합니다.
openfang hand activate researcher
# 언제든지 진행 상황을 확인하세요
...

직접 구축해 보세요. 도구, 설정 및 시스템 프롬프트 (system prompt)가 포함된 HAND.toml을 정의하세요. FangHub에 게시할 수 있습니다.

모든 데이터는 공식 문서 및 공개 저장소(public repositories)를 바탕으로 하며, 2026년 2월 기준입니다.

ZeroClaw ██░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 10 ms
OpenFang ██████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 180 ms ★
LangGraph █████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 2.5 sec
...

ZeroClaw █░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 5 MB
OpenFang ████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 40 MB ★
LangGraph ██████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 180 MB
...

ZeroClaw █░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 8.8 MB
OpenFang ███░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 32 MB ★
CrewAI ████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 100 MB
...

OpenFang ████████████████████████████████████████████ 16 ★
ZeroClaw ███████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 6
OpenClaw ████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 3
...

OpenFang ████████████████████████████████████████████ 40 ★
ZeroClaw ███████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 15
OpenClaw █████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 13
...

ZeroClaw ████████████████████████████████████████████ 28
OpenFang ██████████████████████████████████████████░░ 27 ★
LangGraph ██████████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 15
...

기능	OpenFang	OpenClaw	ZeroClaw	CrewAI	AutoGen	LangGraph
언어	Rust	TypeScript	Rust	Python	Python	Python
자율 핸즈 (Autonomous Hands)	7개 내장	없음	없음	없음	없음	없음
보안 계층 (Security Layers)	16개 개별 계층	3개 기본 계층	6개 계층	1개 기본 계층	Docker	AES 암호화 (AES enc.)
에이전트 샌드박스 (Agent Sandbox)	WASM 이중 계측 (dual-metered)	없음	허용 목록 (Allowlists)	없음	Docker	없음
채널 어댑터 (Channel Adapters)	40	13	15	0	0	0
내장 도구 (Built-in Tools)	53 + MCP + A2A	50+
	12	플러그인 (Plugins)	MCP	LC 도구 (LC tools)
메모리 (Memory)	SQLite + 벡터 (vector)	파일 기반 (File-based)	SQLite FTS5	4계층	외부 (External)	체크포인트 (Checkpoints)
데스크톱 앱 (Desktop App)	Tauri 2.0	없음	없음	없음	Studio	없음
감사 추적 (Audit Trail)	Merkle 해시 체인 (Merkle hash-chain)	로그 (Logs)	로그 (Logs)	트레이싱 (Tracing)	로그 (Logs)	체크포인트 (Checkpoints)
콜드 스타트 (Cold Start)	<200ms	~6s	~10ms	~3s	~4s	~2.5s
설치 크기 (Install Size)	~32 MB	~500 MB	~8.8 MB	~100 MB	~200 MB	~150 MB
라이선스 (License)	MIT	MIT	MIT	MIT	Apache 2.0	MIT

OpenFang는 보안을 사후에 덧붙이지 않습니다. 모든 계층은 독립적으로 테스트 가능하며 단일 장애점 (single point of failure) 없이 작동합니다.

#	시스템 (System)	기능 (What It Does)
1	WASM 이중 계량 샌드박스 (WASM Dual-Metered Sandbox)
도구 코드는 연료 계량 (fuel metering) 및 에포크 중단 (epoch interruption) 기능이 포함된 WebAssembly에서 실행됩니다. 와치독 (watchdog) 스레드가 폭주하는 코드를 종료합니다.
2	Merkle 해시 체인 감사 추적 (Merkle Hash-Chain Audit Trail)
모든 작업은 이전 작업과 암호학적으로 연결됩니다. 하나의 항목을 조작하면 전체 체인이 깨집니다.
3	정보 흐름 오염 추적 (Information Flow Taint Tracking)
레이블이 실행 과정을 통해 전파됩니다. 비밀 정보는 소스 (source)에서 싱크 (sink)까지 추적됩니다.
4	Ed25519 서명된 에이전트 매니페스트 (Ed25519 Signed Agent Manifests)
모든 에이전트의 신원과 권한 집합은 암호학적으로 서명됩니다.
5	SSRF 보호 (SSRF Protection)
사설 IP, 클라우드 메타데이터 엔드포인트, DNS 리바인딩 (DNS rebinding) 공격을 차단합니다.
6	비밀 정보 제로화 (Secret Zeroization)
`Zeroizing<String>`은 API 키가 더 이상 필요하지 않은 즉시 메모리에서 자동으로 삭제합니다.
7	OFP 상호 인증 (OFP Mutual Authentication)
P2P 네트워킹을 위한 HMAC-SHA256 논스 (nonce) 기반의 상수 시간 (constant-time) 검증을 수행합니다.
8	권한 게이트 (Capability Gates)
역할 기반 액세스 제어 (Role based access control)입니다. 에이전트가 필요한 도구를 선언하면 커널 (kernel)이 이를 강제합니다.
9	보안 헤더 (Security Headers)
모든 응답에 CSP, X-Frame-Options, HSTS, X-Content-Type-Options를 적용합니다.
10	상태 엔드포인트 편집 (Health Endpoint Redaction)
공개 상태 확인 (health check)은 최소한의 정보만 반환합니다. 전체 진단에는 인증이 필요합니다.
11	서브프로세스 샌드박스 (Subprocess Sandbox)
`env_clear()` 및 선택적 변수 전달을 사용합니다. 교차 플랫폼 종료 (cross-platform kill) 기능을 갖춘 프로세스 트리 격리를 제공합니다.
12	프롬프트 인젝션 스캐너 (Prompt Injection Scanner)
스킬 (skills) 내의 오버라이드 (override) 시도, 데이터 유출 패턴, 셸 참조 인젝션 (shell reference injection)을 탐지합니다.
13	루프 가드 (Loop Guard)
서킷 브레이커 (circuit breaker)를 갖춘 SHA256 기반의 도구 호출 루프 탐지 기능을 제공합니다. 핑퐁 (ping-pong) 패턴을 처리합니다.
14	세션 복구 (Session Repair)
7단계 메시지 이력 검증 및 손상으로부터의 자동 복구를 수행합니다.
15	경로 탐색 방지 (Path Traversal Prevention)
심볼릭 링크 탈출 (symlink escape) 방지를 포함한 정규화 (Canonicalization)를 수행합니다. 여기서는 `../`가 작동하지 않습니다.
16	GCRA 속도 제한기 (GCRA Rate Limiter)
IP별 추적 및 만료 데이터 정리를 포함한 비용 인식 토큰 버킷 (token bucket) 속도 제한을 제공합니다.

14개의 Rust 크레이트 (crates). 137,728줄의 코드. 모듈형 커널 설계.

openfang-kernel 오케스트레이션 (Orchestration), 워크플로우 (workflows), 미터링 (metering), RBAC, 스케줄러 (scheduler), 예산 추적 (budget tracking)
openfang-runtime 에이전트 루프 (Agent loop), 3개의 LLM 드라이버 (drivers), 53개의 도구 (tools), WASM 샌드박스 (sandbox), MCP, A2A
openfang-api 140개 이상의 REST/WS/SSE 엔드포인트 (endpoints), OpenAI 호환 API, 대시보드 (dashboard)
...

사용자가 이용 중인 모든 플랫폼에 에이전트를 연결하세요.

Core: Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Email (IMAP/SMTP)
Enterprise: Microsoft Teams, Mattermost, Google Chat, Webex, Feishu/Lark, Zulip
Social: LINE, Viber, Facebook Messenger, Mastodon, Bluesky, Reddit, LinkedIn, Twitch
Community: IRC, XMPP, Guilded, Revolt, Keybase, Discourse, Gitter
Privacy: Threema, Nostr, Mumble, Nextcloud Talk, Rocket.Chat, Ntfy, Gotify
Workplace: Pumble, Flock, Twist, DingTalk, Zalo, Webhooks

각 어댑터 (adapter)는 채널별 모델 재정의 (model overrides), DM/그룹 정책, 속도 제한 (rate limiting), 그리고 출력 포맷팅 (output formatting)을 지원합니다.

WhatsApp Web과 마찬가지로, QR 코드를 통해 개인 WhatsApp 계정을 OpenFang에 연결하세요. Meta Business 계정은 필요하지 않습니다.

Node.js >= 18 설치됨 (다운로드)- OpenFang 설치 및 초기화됨

1. 게이트웨이 (gateway) 의존성 설치:

cd packages/whatsapp-gateway
npm install

2. config.toml 설정:

[channels.whatsapp]
mode = "web"
default_agent = "assistant"

3. 게이트웨이 URL 설정 (하나를 선택하세요):

지속성을 위해 셸 프로필 (shell profile) 에 추가하세요:

# macOS / Linux
echo 'export WHATSAPP_WEB_GATEWAY_URL="http://127.0.0.1:3009"' >> ~/.zshrc
source ~/.zshrc

또는 게이트웨이를 시작할 때 인라인 (inline) 으로 설정하세요:

export WHATSAPP_WEB_GATEWAY_URL="http://127.0.0.1:3009"

4. 게이트웨이 시작:

node packages/whatsapp-gateway/index.js

게이트웨이는 기본적으로 3009 포트에서 대기합니다. WHATSAPP_GATEWAY_PORT로 재정의할 수 있습니다.

5. OpenFang 시작:

openfang start
# 대시보드 주소: http://localhost:4200

6. QR 코드 스캔:

대시보드 접속 → Channels → WhatsApp. QR 코드가 나타납니다. 휴대폰으로 스캔하세요:

설정 (Settings) → 연결된 기기 (Linked Devices) → 기기 연결 (Link a Device)

스캔이 완료되면 상태가 connected로 변경되며,

수신된 메시지는 설정된 에이전트 (Agent)로 라우팅 (Routing)됩니다.

변수 (Variable)	설명 (Description)	기본값 (Default)
`WHATSAPP_WEB_GATEWAY_URL`	OpenFang이 연결할 게이트웨이 (Gateway) URL	(비어 있음 = 비활성화)
`WHATSAPP_GATEWAY_PORT`	게이트웨이가 리스닝 (Listening)하는 포트 (Port)	`3009`
`OPENFANG_URL`	게이트웨이가 보고할 OpenFang API URL	`http://127.0.0.1:4200`
`OPENFANG_DEFAULT_AGENT`	수신 메시지를 처리하는 에이전트 (Agent)	`assistant`

메서드 (Method)	경로 (Route)	설명 (Description)
`POST`	`/login/start`	QR 코드 생성 (base64 PNG 반환)
`GET`	`/login/status`	연결 상태 (`disconnected`, `qr_ready`, `connected`)
`POST`	`/message/send`	메시지 전송 (`{ "to": "5511999999999", "text": "Hello" }`)
`GET`	`/health`	상태 확인 (Health check)

프로덕션 (Production) 워크로드의 경우, Meta Business 계정과 함께 WhatsApp Cloud API를 사용하십시오. Cloud API 설정 문서를 참조하십시오.

3개의 네이티브 드라이버 (Native drivers: Anthropic, Gemini, OpenAI 호환)가 27개의 제공업체 (Providers)로 라우팅합니다:

Anthropic, Gemini, OpenAI, Groq, DeepSeek, OpenRouter, Together, Mistral, Fireworks, Cohere, Perplexity, xAI, AI21, Cerebras, SambaNova, HuggingFace, Replicate, Ollama, vLLM, LM Studio, Qwen, MiniMax, Zhipu, Moonshot, Qianfan, Bedrock 등이 있습니다.

작업 복잡도 점수 산정 (Task complexity scoring), 자동 폴백 (Automatic fallback), 비용 추적 (Cost tracking) 및 모델별 가격 책정 (Per-model pricing)을 포함한 지능형 라우팅 (Intelligent routing)을 제공합니다.

이미 OpenClaw를 실행 중이신가요? 명령어 하나면 충분합니다:

# 모든 항목 마이그레이션 (Migrate): 에이전트 (Agents), 메모리 (Memory), 스킬 (Skills), 설정 (Configs).
openfang migrate --from openclaw
# 특정 경로로부터 마이그레이션
...

마이그레이션 엔진 (Migration engine)은 에이전트 (Agents), 대화 기록 (Conversation history), 스킬 (Skills) 및 설정을 가져옵니다. OpenFang은 SKILL.md를 네이티브하게 읽으며 ClawHub 마켓플레이스 (Marketplace)와 호환됩니다.

즉시 교체 가능 (Drop-in replacement). 기존 도구들을 OpenFang으로 지정하십시오:

curl -X POST localhost:4200/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
...

에이전트 (Agents), 메모리 (Memory), 워크플로 (Workflows), 채널 (Channels), 모델 (Models), 스킬 (Skills), A2A, Hands 등을 아우르는 140개 이상의 REST/WS/SSE 엔드포인트 (Endpoints)를 제공합니다.

RightNow-AI/openfang

요약

핵심 포인트

댓글