ttguy0707/CyberClaw

해결하는 문제

CyberClaw는 AI 에이전트의 '블랙박스' 특성을 해결하여 투명하고 제어 가능하며 안전한 아키텍처를 제공합니다. 제로트러스트 실행 모델을 통해 예기치 않거나 위험한 AI 동작을 방지하고, 에이전트의 의사결정 과정에 대한 완전한 추적 가능성을 제공합니다.

작동 방식

이 시스템은 여러 핵심 메커니즘을 통합한 LangGraph 기반의 에이전트 루프 위에 구축됩니다:

• 이중 단계 호출: 도구를 즉시 실행하는 대신, 에이전트는 먼저 help 모드로 도구의 SKILL.md 매뉴얼을 읽은 후 run 모드로 전환합니다.
• 이중 워터마크 메모리: 장기적인 사용자 프로필(user_profile.md)과 SQLite에 저장된 단기 대화 요약을 결합하여 토큰 폭발 없이 문맥을 유지합니다.
• 행동 감사: LLM 입력, 도구 호출, 시스템 작업을 포함한 모든 동작이 JSONL 형식으로 로그 기록되며, 전용 Rich 터미널 UI를 통해 실시간 모니터링이 가능합니다.
• 하트비트 엔진: 메인 채팅 인터페이스와 별도로 스케줄링 및 반복 작업을 관리하는 백그라운드 프로세스입니다.
• 보안 사ند박스: 모든 파일 및 셸 작업은 정규표현식 기반의 명령 차단과 경로 가로채기를 통해 특정 office/ 디렉터리에 제한됩니다.

대상 사용자

• 기업 사용자: AI 배포에 대해 엄격한 감사 로그와 권한 제어가 필요한 사용자.
• AI 연구자: 에이전트의 의사결정 체인과 안전 경계를 분석하는 개발자.
• 파워 사용자: 스케줄된 자동화와 크로스플랫폼 셸 기능을 갖춘 개인용 어시스턴트를 원하는 사용자.

주요 특징

• 제로트러스트 실행: 행동 전 문서를 읽도록 강제함으로써 P0 인시던트 발생률을 80% 감소.
• 에코시스템 호환성: OpenClaw 및 Claude Code의 스킬을 직접 지원.
• 투명한 모니터링: 별도의 모니터 터미널을 통해 에이전트의 내부 논리를 실시간으로 시각화.
• 크로스플랫폼: Windows (PowerShell/CMD) 및 Unix (Bash/Zsh)를 네이티브로 지원하며, 경로 및 명령어 자동 적응 기능 제공.