openclaw/openclaw — GitHub README
Source: openclaw-github-readme Type: article (GitHub repository README) By: openclaw (Peter Steinberger + community) Valid as of: 2026-04-28
핵심 Takeaway
- OpenClaw는 Peter Steinberger가 만든 오픈소스 개인 AI 어시스턴트 프레임워크 — 이전 entity 페이지의 “동명이인 Contradiction”이 동일 제품으로 해소됨 (출처: GitHub 공식 저장소)
- 2025-11-24 생성, 5개월 만에 365,607 stars / 74,929 forks 달성 — Agentic AI 도구 중 이례적 성장 속도 (2026-04-28 기준)
- 설치 2줄로 완료:
npm install -g openclaw@latest+openclaw onboard --install-daemon(launchd/systemd 데몬 자동 등록) - 스킬 시스템 경로 확인:
~/.openclaw/workspace/skills/<skill>/SKILL.md— Claude Code 하네스 패턴과 완전히 동일한 구조 - DM 페어링 보안 기본값:
dmPolicy="pairing"— 모르는 발신자에게 페어링 코드 발급, 자동 처리 없음.openclaw doctor로 감사
상세 요약
제품 정의
OpenClaw는 자신의 디바이스에서 직접 실행하는 개인 AI 어시스턴트다. Gateway(로컬 데몬)가 제어 평면을 담당하고, 이미 사용 중인 메시지 채널(WhatsApp, Telegram, Slack, Discord 등 22+)을 통해 에이전트와 상호작용한다. TypeScript 기반 MIT 라이선스 오픈소스.
아키텍처
사용자 채널 (WhatsApp / Telegram / Slack / ...)
↓
OpenClaw Gateway (로컬 데몬, 포트 18789)
├─ 채널 라우팅 (채널 → 에이전트 워크스페이스)
├─ 세션 관리
├─ 도구 실행 (browser, canvas, nodes, cron, sessions...)
└─ 스킬 로딩 (~/.openclaw/workspace/skills/)
↓
LLM 모델 (OpenAI / Anthropic / 기타)
설치 및 시작
- Node 24 (권장) 또는 Node 22.14+ 필요
npm install -g openclaw@latest→openclaw onboard --install-daemon- Onboard CLI가 Gateway 데몬, 워크스페이스, 채널, 스킬을 단계적으로 설정
- macOS/Linux/Windows(WSL2 권장) 지원
- 개발 채널: stable (latest) / beta / dev
에이전트 워크스페이스
- 루트:
~/.openclaw/workspace(설정 가능) - 자동 주입 파일:
AGENTS.md,SOUL.md,TOOLS.md - 스킬 위치:
~/.openclaw/workspace/skills/<skill>/SKILL.md - 최소 설정:
~/.openclaw/openclaw.json에agent.model지정
보안 모델
- 기본값 DM 페어링: 모르는 발신자 → 짧은 코드 발급 + 처리 거부
openclaw pairing approve <channel> <code>로 수동 승인- 공개 DM:
dmPolicy="open"+allowFrom: ["*"]명시적 opt-in 필요 - 샌드박스:
agents.defaults.sandbox.mode: "non-main"→ Docker 컨테이너 격리 - 정기 감사:
openclaw doctor
주목할 지표 (2026-04-28 기준)
| 항목 | 값 |
|---|---|
| Stars | 365,607 |
| Forks | 74,929 |
| Open Issues | 6,988 |
| 언어 | TypeScript |
| 라이선스 | MIT |
| 생성일 | 2025-11-24 |
| 스폰서 | OpenAI, GitHub, NVIDIA, Vercel |
연결되는 위키 페이지
- OpenClaw — 이 소스로 Contradiction 해소 및 실제 GitHub 사실 강화
- gateway-architecture — DM 페어링 보안 기본값 추가
- agent-skill-design — 실제 스킬 경로(
~/.openclaw/workspace/skills/) 확인