midea-ai/SemaClaw
요약
SemaClaw는 개인 AI 에이전트 구축을 위한 범용 오픈 소스 엔지니어링 프레임워크입니다. 재사용 가능한 런타임을 기반으로 권한, 메모리, 스케줄링 등 다양한 주변 장치를 제공합니다. 특히 세 계층의 컨텍스트 관리와 Human-in-the-Loop 권한 같은 고급 기능을 지원하며, DAG 오케스트레이션과 플러그인 마켓플레이스를 통해 확장성을 극대화했습니다.
핵심 포인트
- 개인 AI 에이전트 구축을 위한 범용 엔지니어링 하네스 제공
- 세 계층 컨텍스트 관리 및 Human-in-the-Loop 권한 지원
- DAG 기반의 동적 작업 분해와 결정론적 오케스트레이션 구현
- 플러그인 마켓플레이스를 통한 높은 확장성과 커스터마이징 가능
개인 AI 에이전트를 위한 범용 오픈 소스 프레임워크입니다.
English | 简体中文
SemaClaw는 개인 AI 에이전트를 구축하기 위한 범용 엔지니어링 하네스(engineering harness)입니다. 재사용 가능한 에이전트 런타임(sema-code-core)을 기반으로 하며, 원시 런타임을 사용 가능한 개인 AI 시스템으로 변환하는 주변 장치들 — 권한(permissions), 메모리(memory), 스케줄링(scheduling), 다중 에이전트 오케스트레이션(multi-agent orchestration), 채널 어댑터(channel adapters), 그리고 웹 UI(Web UI) — 을 제공합니다. 또한, 이는 커뮤니티가 그 뒤에 숨겨진 엔지니어링 결정을 평가하고 개선할 수 있는 레퍼런스 구현체이자 시작점입니다.
SemaClaw는 자체 소스 코드를 분석하여 위에 소개된 인트로 비디오를 생성했습니다 — frontend-slides와 remotion 스킬을 활용했으며 (이전 모든 단계는 DeepSeek-Chat으로, Remotion 애니메이션 코딩은 Claude Sonnet 4.6으로 구동됨). 전체 데모 비디오 시청
세 계층의 컨텍스트 관리(Three-layer context management) — 작업 컨텍스트, 장기 메모리 검색, 에이전트별 페르소나 분할을 단일하고 일관된 모델로 통합합니다.휴먼 인 더 루프 권한(Human-in-the-Loop permissions) — PermissionBridge
는 고위험 도구 작업에 대한 명시적 사용자 승인과 에이전트가 시작하는 명확화 요청을 모두 지원하는 네이티브 하네스 프리미티브입니다.4계층 플러그인 아키텍처 — MCP 도구, 서브에이전트(subagents), 스킬(skills), 및 훅(hooks)으로 구성되며, 각각은 고유한 엔지니어링 관심사에 기반하여 원칙적인 확장 표면을 형성합니다.플러그인 마켓플레이스 — 모든 git 저장소 또는 로컬 디렉토리에서 서드파티 플러그인 번들을 설치할 수 있습니다. 각 플러그인은 스킬, 서브에이전트, 훅 및 MCP 서버를 함께 패키징할 수 있습니다. 플러그인은 기본적으로 비활성화되어 있으며 Web UI에서 개별 플러그인별로 토글할 수 있고, 우선순위 순서 지정과 함께 여러 소스를 추가할 수 있습니다.DAG 팀 — LLM 기반의 동적 작업 분해와 결정론적 DAG(Directed Acyclic Graph) 실행을 결합한 2단계 하이브리드 오케스트레이션 프레임워크입니다. 지속적인 에이전트와 가상 에이전트를 혼합하여 지원하며, 즉시 사용할 수 있는 5개의 내장 가상 서브에이전트가 준비되어 있습니다.4가지 모드의 예약 작업 — 순수 알림(Pure notification), 순수 스크립트(pure script), 순수 에이전트(pure agent), 그리고 하이브리드 스크립트+에이전트 실행으로 구성되며, 작업 복잡도에 맞는 모드를 사용하여 토큰 소비가 추론 작업량에 비례하도록 유지합니다.에이전틱 위키 — 작업 출력을 구조화되고 검색 가능한 위키 항목으로 변환하여 에이전트 메모리와 함께 인덱싱하고, 미래의 에이전트 세션에 피드백되는 복리적인 개인 지식 기반을 만듭니다.워크벤치: 임시 UI로서의 HTML(HTML-as-throwaway-UI) — 에이전트가 생성하는 결과물을 위한 내장 렌더링 표면입니다. LaunchUI 도구를 사용하면 에이전트가 상호작용 가능한 HTML, 풍부한 마크다운(rich Markdown), 임베디드 웹 서비스(iframe), 또는 API 엔드포인트 카드를 전송할 수 있으며, Web UI 워크벤치는 별도의 빌드 단계 없이 각 아티팩트를 전환 가능한 히스토리 탭으로 마운트합니다.
Overture는 SemaClaw를 자체 개선형 개인 에이전트 시스템으로 변환하는 음악 테마의 컴패니언 플러그인 팩입니다. Plugin Marketplace에서 Add Source를 통해 레포지토리 URL을 붙여넣어 설치할 수 있습니다.
— 모든 도구 호출, 사용자 수정 및 결과를 구조화된 로그로 포착하는 데이터 피드휠(Data-flywheel) 후크.
아래 두 가지 진화 루프를 위한 시그널 피드입니다. notation
— 2계층 자체 진화(cadence와 repertoire).
cadence는 에이전트의 기본 유전체(프롬프트, 정책, 기본 휴리스틱)를 진화시키고; repertoire는 스킬 라이브러리— 개별 스킬을 추가, 개선 또는 폐기—를 진화시킵니다. — 페르소나 플러그인 팩은 각 음색(timbre)에 어조/가치/전문성을 묶어 재사용 가능한 캐릭터 프로필로 만들어 어떤 에이전트든 착용할 수 있게 하며, 음색(timbre)을 에이전트의 정체성과 지식으로부터 분리합니다.
# 1. 전역 설치
npm install -g semaclaw
# 2. 실행
...
끝입니다. **http://127.0.0.1:18788/**에서 Web UI를 여세요.
설치에 실패했나요? docs/INSTALL_TROUBLESHOOTING.md를 참조하세요. 여기에는 macOS sharp postinstall 실패 및 기타 보고된 문제가 다루어져 있습니다.
첫 실행 시 LLM을 구성해야 합니다. SemaClaw는 내장 모델 없이 시작합니다. Web UI → Settings → LLM으로 이동하여 제공자 프로필(OpenAI / Anthropic / DeepSeek / Qwen / …)을 baseURL, apiKey, modelName과 함께 추가하세요. 이 프로필은 ~/.semaclaw/config.json에 저장되고 ~/.semaclaw/semaclaw-model.conf와 동기화됩니다.
— 최소한 하나의 활성 프로필이 존재할 때까지, LLM을 호출하는 에이전트 실행은 실패합니다.
메시징 채널(Telegram / Feishu / QQ / WeChat)을 활성화하려면, semaclaw를 시작하기 전에 작업 디렉토리에 .env 파일을 생성하세요. 환경 변수의 전체 목록은 docs/QUICK_START.md를 참조하세요.
# 1. 클론
git clone https://github.com/midea-ai/SemaClaw.git
cd SemaClaw
...
시작한 후, **http://127.0.0.1:18788/**에서 Web UI를 열고, Settings → LLM으로 이동하여 최소 하나의 활성 제공자 프로필을 추가하세요 (옵션 A의 참고 사항 참조).
환경 변수, CLI 사용법, 런타임 레이아웃 및 아키텍처 세부 정보가 포함된 전체 워크스루는 docs/QUICK_START.md를 참조하세요 (현재 중국어).
| 문서 | 설명 |
|---|---|
| Quick Start & Usage Guide | 설치, 구성, CLI 명령어, 런타임 레이아웃, MCP 도구 |
| ... |
semaclaw/
├── src/
│ ├── agent/ # 에이전트 생명 주기(Agent lifecycle), 브릿지(bridges), 권한 라우팅(permission routing)
...
기여는 환영합니다. SemaClaw는 개인 AI 에이전트를 위한 공유 엔지니어링 기반을 발전시키기 위해 존재하며, 이슈, 풀 리퀘스트, 디자인 논의 모두 가치가 있습니다. 지침은 CONTRIBUTING.md *(곧 공개)*를 참조하세요.
MIT © AIRC Sema Team
SemaClaw 로고는 등에서 발톱 모양의 날개가 솟아난 말을 묘사합니다. 이 이미지는 중국어 구절 以梦为马 — “꿈을 말처럼 타다” — 에서 영감을 받았으며, 사용자의 상상이 어디로 이끌든 그곳으로 운반하는 AI 하네스(harness)의 정신을 포착하고 있습니다. 이름 자체는 Sema(semantic에서 유래)와 Claw를 결합했으며, 하네스는 단어의 문자적 의미에 경의를 표합니다: 말을 제어하고 구속하는 데 사용되는 장비입니다.
SemaClaw는 기본 에이전트 런타임(agent runtime)을 제공하는 sema-code-core 위에 구축되었습니다. 그 제품 형태 역시 OpenClaw에서 영감을 받았으며, 같은 프로젝트의 ClaWHub 플러그인 마켓플레이스와 통합됩니다. 또한 Model Context Protocol, grammY 등 이 프로젝트가 의존하는 광범위한 오픈 소스 생태계에도 감사를 표합니다.
SemaClaw의 목표는 개인 AI 에이전트의 최종 아키텍처를 정의하는 것이 아니라, 더 나은 아키텍처가 구축될 수 있는 공유 엔지니어링 기반을 발전시키는 것입니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기