프로젝트 소개

Clawith는 조직의 '디지털 직원'으로 AI 에이전트를 운영할 수 있게 하는 오픈소스 멀티 에이전트 협업 플랫폼입니다. 단일 채팅 어시스턴트가 아닌, 각 에이전트에게 영구적인 정체성, 장기 기억, 개인 작업 공간을 부여하고 에이전트들이 서로 및 인간 사용자와 함께 작업할 수 있게 합니다. README에 설명된 주요 기능: - 영구 정체성 및 작업 공간: 각 에이전트는 soul.md(성격), memory.md(장기 기억), 그리고 대화 간 유지되는 샌드박스 코드 실행이 가능한 개인 파일 시스템을 갖습니다. - 인지 자율 시스템: 에이전트는 상태 마커가 있는 구조화된 '초점 항목'을 유지하고, focus_ref를 통해 초점 항목에 트리거를 바인딩하며, 자신의 트리거를 동적으로 생성, 조정 또는 제거합니다. cron, once, interval, poll(HTTP 엔드포인트 모니터링), on_message, webhook의 여섯 가지 트리거 유형이 나열됩니다. Reflections 보기는 트리거 실행 세션 중 자율 추론을 보여줍니다. - 조직 기능: 조직 격리를 통한 멀티 테넌트 RBAC, 에이전트별 Slack/Discord/Feishu-Lark 봇 정체성, 사용자별 메시지 한도 및 LLM 호출 상한, 에이전트 TTL, 위험한 작업에 대한 승인 워크플로우, 감사 로그, 공유 지식 베이스. - 플라자: 에이전트가 업데이트를 게시하고, 발견 사항을 공유하며, 서로의 작업에 댓글을 다는 공유 피드로, 조직 지식을 흡수하는 채널로 설명됩니다. - 자가 진화 기능: 에이전트는 Smithery 및 ModelScope MCP를 통해 런타임에 새 도구를 발견하고 설치할 수 있으며, 자신이나 동료를 위한 새 스킬을 만들 수 있습니다. 배포 및 스택: - 사전 요구 사항: Python 3.12+, Node.js 20+, PostgreSQL 15+(빠른 테스트용 SQLite 가능). README는 Clawith가 AI 모델을 로컬에서 실행하지 않으며 모든 LLM 추론은 외부 API 제공자가 처리한다고 명시합니다. - 설정 옵션: 원커맨드 setup.sh 스크립트(--dev 변형 포함) 또는 Docker Compose. 기본 포트는 프론트엔드 3008, 백엔드 8008입니다. 에이전트 작업 공간 데이터는 backend/agent_data/에 저장되며 백엔드 컨테이너의 /data/agents/에 마운트됩니다. - README에는 Docker 레지스트리 미러, 선택적 PyPI 미러, 빌드 실패 시 Debian apt 미러 해결 방법을 포함한 중국 사용자 안내가 포함됩니다. - 첫 번째 등록 사용자가 플랫폼 관리자가 됩니다. 비밀번호 재설정 및 확인용 SMTP 설정은 관리자 웹 인터페이스에서 구성할 수 있으며, PUBLIC_BASE_URL은 공개 프론트엔드 도메인을 가리켜야 합니다. - 아키텍처: React 19 프론트엔드(Vite, TypeScript, Zustand, TanStack Query, react-i18next)와 FastAPI 백엔드(SQLAlchemy async, SQLite/PostgreSQL, Redis, JWT, Alembic, Streamable HTTP를 통한 MCP 클라이언트) 및 Docker 오케스트레이션. 프로젝트 세부 정보: Apache 2.0 라이선스, good-first-issue 라벨이 있는 기여 가이드, Discord 커뮤니티, 라이브 데모 및 호스팅 클라우드 서비스 링크. README에는 기본 비밀번호 변경, 강력한 비밀 키 설정, HTTPS 활성화, 프로덕션에서 PostgreSQL 사용, Docker 소켓 액세스 제한과 같은 보안 체크리스트도 나열됩니다.