ttguy0707/CyberClaw

해결하는 문제

CyberClaw는 관측 가능하고, 안전하며 확장 가능한 에이전트 워크플로우를 만들기 위해 설계된 일반 목적의 AI 에이전트 프레임워크입니다. 동적 기술에 대해 엄격한 "help → run" 프로토콜을 도입함으로써, 명령을 실행하기 전에 최신 지침에 접근했는지를 보장하여 신뢰할 수 없는 도구 실행 문제를 해결합니다.

작동 방식

LangGraph 기반으로 구축되어 있으며, 상태 그래프(START → agent → tools → agent)를 구현합니다. 세션 지속성을 위해 AsyncSqliteSaver를 사용하고, 장기 기억을 위해 마크다운 기반의 사용자 프로필을 사용합니다. 컨텍스트를 관리하기 위해 40턴 이후 메시지를 자르며, 최신 10턴은 유지하고 나머지는 LLM을 통해 요약합니다.

주요 기술적 메커니즘은 다음과 같습니다:

• 이중 단계 기술 실행: 기술은 직접 호출되지 않습니다. 에이전트는 먼저 help를 요청하여 일회용 help_token을 받아야 합니다. 이 토큰은 run 단계에서 제공되어야 하며, 세션, 기술 식별자, 콘텐츠 해시와 비교하여 검증된 후 실행됩니다.
• 서브에이전트 위임: 메인 에이전트는 전문적인 서브에이전트(code_reviewer 또는 document_analyst 등)에게 작업을 위임하거나, 필요에 따라 즉시 임시 역할을 정의할 수 있습니다. 이러한 서브에이전트는 제한된 도구 접근 권한을 가진 격리된 컨텍스트에서 작동합니다.
• 스케줄된 작업: 하트비트 코루틴이 10초마다 tasks.json 파일을 확인하여 시간 기반 작업을 트리거합니다.
• 관측 가능성: 제한된 비동기 큐가 LLM 입력, 도구 호출, 결과, AI 메시지, 시스템 작업 등 5가지 유형의 이벤트를 JSONL 파일에 로깅하며, 전용 모니터 CLI로 확인할 수 있습니다.

대상 사용자

• 동적 도구와 기술을 구조적으로 관리해야 하는 자율 에이전트를 개발하는 개발자
• 장기 기억과 전문 서브에이전트에게 복잡한 작업을 위임할 수 있는 CLI 기반 AI 어시스턴트를 원하는 사용자
• 도구 호출에 프로토콜 기반 접근 방식을 강제하여 신뢰성을 높이고자 하는 사람

주요 특징

• 프로토콜 강제: help 호출에서 유효하고 시간 제한이 있는 토큰을 요구함으로써 임의의 도구 실행을 방지합니다.
• 계층적 에이전시: 미리 정의된 서브에이전트와 동적으로 정의된 서브에이전트를 모두 지원하며, 격리된 컨텍스트를 제공합니다.
• 컨텍스트 관리: 자동적인 LLM 기반 요약과 턴 기반 트리밍을 통해 긴 대화를 처리합니다.
• 내장 도구 세트: 파일 시스템 작업, 쉘 실행(허용 목록 포함), 스케줄링, 프로필 관리용 13개의 핵심 도구를 포함합니다.
• 구조화된 감사: JSONL 로그를 통해 에이전트의 의사결정과 도구 상호작용을 실시간으로 모니터링할 수 있습니다.