Cisco의 Python 도구로 YARA 규칙, LLM 분석, Cisco AI Defense를 사용해 MCP 서버 등을 보안 검사합니다.
SafeAI-Lab-X/ClawKeeper
도구를 사용하는 AI 에이전트와 도구 사이에서 위험한 호출을 차단하고 민감한 결과를 가리는 호스트에 구애받지 않는 안전 미들웨어입니다.
- 스타
- 1,018
- 포크
- 59
- 열린 이슈
- 7
- 마지막 커밋
- 2개월 전
어떤 프로젝트인가요?
ClawKeeper는 shell, Python, browser, filesystem, network 함수 같은 도구를 호출하는 에이전트 시스템을 위한 안전 계층입니다. 도구 호출은 실행 전에 가로채고, 도구가 반환한 결과는 받은 뒤 검사하므로 호스트 에이전트의 핵심 로직을 다시 작성하지 않고도 보호할 수 있습니다. Hermes Agent, MCP tools, HTTP bridges, OpenClaw 스타일 런타임 또는 사용자 지정 호스트에 연결할 수 있습니다.
기본 가드 세트는 프롬프트 인젝션, 자격 증명 읽기, 자격 증명 유출로 이어지는 호출 체인, 안전하지 않은 셸 명령, 보호 경로 접근, SSRF 유형의 URL, base64 또는 hex 인코딩 페이로드, 오염된 도구 출력 등 흔한 에이전트 보안 취약점을 대상으로 합니다. Python을 사용하지 않는 호스트는 HTTP 서버가 제공하는 Judge API를 호출할 수 있습니다.
선택 사항인 Watcher 데몬은 단일 명령 규칙으로는 포착할 수 없는 판단을 위해 의도, 최근 도구 기록, 제안된 호출을 검토합니다. Watcher가 탐지한 항목은 학습된 패턴으로 전환해 ~/.clawkeeper/에 저장하고, 실행 중인 가드 계층에 핫 리로드할 수 있습니다.
핵심 기능
- 01위험한 shell, Python, browser, filesystem, network 도구 호출을 실행 전에 차단합니다.
- 02도구 결과의 민감한 내용을 가리고 반환된 출력에 오염된 내용이 있는지 검사합니다.
- 03자격 증명 유출로 이어지는 호출 체인과 보호 경로 접근을 탐지합니다.
- 04judge, event, audit, log/skill scan 엔드포인트를 갖춘 HTTP 코어를 제공합니다.
- 05의도와 여러 단계에 걸친 도구 기록을 검토하는 선택형 Watcher 데몬을 제공합니다.
활용 사례
- 몇 줄의 Python 코드로 Hermes Agent 배포 환경에 안전 가드를 추가합니다.
- 도구를 실행하기 전에 HTTP Judge API를 호출해 Python을 사용하지 않는 에이전트 런타임을 보호합니다.
- 에이전트 도구 호출을 감사해 자격 증명 접근과 유출 시도를 확인합니다.
- Watcher 탐지 결과를 바탕으로 가드 계층이 새로운 공격 패턴을 학습하게 합니다.
빠른 시작
- 1
리포지토리를 클론합니다
git clone git@github.com:SafeAI-Lab-X/ClawKeeper.git - 2
가상 환경을 만듭니다
python -m venv .venv - 3
dev extras를 포함해 패키지를 환경에 설치합니다
pip install -e ".[dev]" - 4
정상 작동을 확인하기 위해 테스트 스위트를 실행합니다
pytest -q
사용 전 알아둘 점
- 리포지토리에 라이선스가 지정되어 있지 않아 사용 권한이 불분명합니다.
- 선택 사항인 Watcher를 사용하려면 LLM API 키와 구성된 모델이 필요합니다.
토픽
자주 묻는 질문
- ClawKeeper은(는) 무엇인가요?
- 도구를 사용하는 AI 에이전트와 도구 사이에서 위험한 호출을 차단하고 민감한 결과를 가리는 호스트에 구애받지 않는 안전 미들웨어입니다. ClawKeeper는 shell, Python, browser, filesystem, network 함수 같은 도구를 호출하는 에이전트 시스템을 위한 안전 계층입니다. 도구 호출은 실행 전에 가로채고, 도구가 반환한 결과는 받은 뒤 검사하므로 호스트 에이전트의 핵심 로직을 다시 작성하지 않고도 보호할 수 있습니다. Hermes Agent, MCP tools, HTTP bridges, OpenClaw 스타일 런타임 또는 사용자 지정 호스트에 연결할 수 있습니다.
- ClawKeeper은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- ClawKeeper에는 명시된 라이선스가 없습니다. 코드는 공개되어 있지만 라이선스가 없으면 재사용 허가가 명확하지 않으므로, 사용 전에 작성자에게 문의하는 것이 좋습니다.
- ClawKeeper은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. ClawKeeper의 마지막 커밋은 2026년 8월 17일입니다.
- ClawKeeper은(는) 어디에 사용할 수 있나요?
- 몇 줄의 Python 코드로 Hermes Agent 배포 환경에 안전 가드를 추가합니다. 도구를 실행하기 전에 HTTP Judge API를 호출해 Python을 사용하지 않는 에이전트 런타임을 보호합니다. 에이전트 도구 호출을 감사해 자격 증명 접근과 유출 시도를 확인합니다. Watcher 탐지 결과를 바탕으로 가드 계층이 새로운 공격 패턴을 학습하게 합니다.
- ClawKeeper는 어떻게 설치하나요?
- 리포지토리를 클론합니다: git clone git@github.com:SafeAI-Lab-X/ClawKeeper.git 가상 환경을 만듭니다: python -m venv .venv dev extras를 포함해 패키지를 환경에 설치합니다: pip install -e ".[dev]" 정상 작동을 확인하기 위해 테스트 스위트를 실행합니다: pytest -q
- ClawKeeper은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/SafeAI-Lab-X/ClawKeeper
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
LLM 기반 대화형 애플리케이션에 프로그래밍 가능한 가드레일을 추가해 주제, 대화 흐름, 출력을 제어하는 오픈 소스 Python 툴킷입니다.
AI 에이전트의 셸 명령, 파일 접근, 패키지 설치 및 MCP 도구 호출을 실행 전에 검토하는 로컬 우선 런타임 보안 계층입니다.
AI 모델 파일, 코드, 실시간 LLM/에이전트/MCP 엔드포인트와 저장된 에이전트 추적을 검증하고 발견 사항과 점검 공백을 보고하는 오픈소스 CLI 및 라이브러리입니다.
Tencent Zhuque Lab이 개발한 풀스택 AI 레드팀 플랫폼으로, AI 에이전트, MCP 서버, Agent Skills, AI 인프라의 보안 위험을 검사합니다.
OpenShell 샌드박스에서 OpenClaw, Hermes, LangChain Deep Agents 같은 AI 에이전트를 더 안전하게 실행하기 위한 NVIDIA의 참조 스택입니다.