microclaw/microclaw

🦀An agentic AI assistant that lives in your chats, inspired by nanoclaw and incorporating some of its design ideas. Built with Rust 🦀

📚 MicroClaw란 무엇인가?

MicroClaw는 자체 호스팅, Rust 기반 AI 에이전트 플랫폼으로, 장기 실행 서버, 네이티브 데스크톱 "Work" 앱, 또는 microclaw-sdk를 통해 모든 Rust 프로그램에 임베드할 수 있습니다. 세 진입점 모두 동일한 핵심 Agent Engine을 공유합니다. 이 엔진은 LLM 공급자와 통신하고, 도구를 실행하고, 메모리를 유지하고, 안전 정책을 적용하는 부분입니다.

🎯 누구를 위한 것인가?

사용 사례	권장 표면
상시 가동 채팅 봇, 웹/API 엔드포인트, 예약 자동화	MicroClaw Server (macOS, Linux, Windows)
데스크톱에 존재하는 로컬, 작업 공간 중심 "협업자"	MicroClaw Work – 네이티브 GPUI 앱 (Apple Silicon macOS 13+, Linux/Windows 미리보기)
기존 Rust 코드베이스에 AI 에이전트 추가	microclaw-sdk – 엔진을 직접 임베드

⚙️ 핵심 기능

영역	제공되는 것
에이전트 실행	다단계 도구 사용, 병렬 읽기 전용 웨이브, 계획, 하위 에이전트, 완료 계약
지속성	재개 가능한 세션, 체크포인트, 지속적 발신 전달, 스케줄링, 취소
메모리 및 학습	파일 기반 + SQLite 메모리, 의미론적 회상, 시간적 지식 그래프, 관리되는 스킬 진화
확장성	스킬, 플러그인, 훅, MCP, ClawHub, A2A, ACP – 모두 동일한 런타임에 연결
인터페이스	Rust SDK, 네이티브 Work UI, 로컬 웹 UI, HTTP/SSE/WebSocket API, 수십 가지 채팅 어댑터 (Telegram, Discord, Slack, Matrix 등)
안전 및 운영	도구 승인 게이트, 범위 제한 기능 부여, Docker 샌드박싱, 이그레스 정책, 비밀 편집, 감사 추적

🛠️ 시작하는 방법

Work (데스크톱) – brew tap microclaw/tap && brew install --cask microclaw-work (Apple Silicon macOS) 또는 v0.9.0 릴리스에서 Linux/Windows 미리보기 다운로드.
Server – 원라이너 설치 프로그램: curl -fsSL https://microclaw.org/install.sh | bash (macOS/Linux) 또는 Windows용 PowerShell 해당 명령. 그런 다음 microclaw doctor && microclaw setup && microclaw start를 실행하고 http://127.0.0.1:10961을 엽니다.
SDK – Cargo.toml에 추가:
```
microclaw-sdk = { version = "0.9.0", features = ["full"] }
```
그리고 빠른 시작 코드 스니펫을 따라 프로그래밍 방식으로 에이전트를 시작합니다.

📖 문서 및 커뮤니티

문서 허브 – docs/README.md는 시작 가이드, SDK 개념, 도구 카탈로그, 보안 모델, 운영 런북에 대한 링크를 제공합니다.
지원 – Discord, Reddit, 공개 이슈 트래커. 보안 공개는 SECURITY.md를 통해 이루어집니다.
릴리스 주기 – 프로덕션용 안정 브랜치, 빠른 개발용 main. 최신 안정 버전은 v0.9.0입니다.

🤔 왜 MicroClaw를 선택해야 하나요?

단일 엔진, 다중 프론트엔드 – 데스크톱 앱으로 시작하여 나중에 서버로 전환하거나 동일한 엔진을 임베드할 수 있습니다. 로직을 다시 작성할 필요가 없습니다.
Rust 우선 – 고성능, 낮은 설치 공간, 단일 바이너리로 쉽게 배포 가능. SQLite 영속성으로 종속성을 최소화합니다.
지속적이고 재개 가능한 작업 – 런타임은 각 도구 호출 후 체크포인트를 생성하므로 장기 실행 또는 중단된 작업을 안전하게 복구할 수 있습니다.
공급자에 구애받지 않음 – 네이티브 Anthropic 지원과 통합 메시지 형식을 통한 모든 OpenAI 호환 또는 로컬 모델.
안전 내장 – 내장 가드레일, 샌드박스 도구 실행, 감사 추적으로 프로덕션 워크로드에 적합합니다.

📦 빠른 기술 스냅샷

언어: Rust (1.93+ 필요, v0.9.0은 1.96 툴체인으로 빌드)
라이선스: MIT
패키징: Homebrew, Docker (ghcr.io/microclaw/microclaw:latest), 소스 (cargo build --release)
플랫폼 지원: macOS (Apple Silicon), Linux (x86_64/arm64), Windows (휴대용 미리보기)

MicroClaw를 사용하면 복잡하고 상태 저장된 AI 에이전트를 로컬 또는 서비스로 실행할 수 있으며, 신뢰성, 확장성, 안전성에 중점을 둡니다. 모두 단일 Rust 코드베이스에서 제공됩니다.