NetClaw – AI 기반 네트워크 운영 어시스턴트

정의 – NetClaw는 네트워크 엔지니어를 위한 로컬 실행, LLM 기반 "코파일럿"입니다. 기존 AI 에이전트 런타임(OpenClaw 또는 Hermes) 위에 구축되며, 네트워크 문서 읽기, 실시간 장치 쿼리, 구성 변경 제안 및 감사, 변조 방지 감사 추적 유지를 가능하게 하는 대규모 스킬(237개) 및 MCP 통합(176개)을 추가합니다.

사용 방법

• 설치 – Bash 기반 대화형 설치 프로그램(scripts/install.sh)을 사용하면 프로필(권장, Cisco 전용, 다중 벤더, 클라우드, 보안, 랩 등)을 선택하거나 개별 구성 요소를 직접 선택할 수 있습니다. 설치 프로그램은 --profile, --components 또는 --all 플래그를 사용하여 비대화형으로 실행할 수도 있습니다. 선택한 런타임을 구성하고 .env 파일을 생성하며 선택한 MCP 서버를 등록합니다.
• 런타임 선택 – 기본적으로 NetClaw는 OpenClaw에서 실행됩니다. --runtime hermes를 사용하여 Hermes(Nous Research의 자기 개선 에이전트)로 전환할 수 있습니다. 둘 다 동일한 공유 HUD UI를 제공합니다.
• HUD(시각적 워크벤치) – 브라우저 UI(:3000 → HUD API :3001)는 채팅 창, 분기 조사를 위한 Canvas, RAG, 토큰 사용량, 보안 모드, 전문가 "Jev" 보기 패널을 제공합니다. HUD는 macOS, Ubuntu(WSL2) 및 Linux에서 작동합니다.
• 상호 작용 채널 – HUD, VS Code 확장, 모바일 Flutter 클라이언트(iOS/Android) 또는 Zoom Realtime Media Streams 앱에서 채팅할 수 있습니다. 각 채널은 동일한 승인 및 감사 정책을 따릅니다.
• RAG(검색 증강 생성) – PDF, Markdown, HTML, Office 문서 또는 URL을 업로드합니다. NetClaw는 로컬 의미론적 키워드 인덱스를 구축하고 결과를 재순위화하며 문서, 섹션 및 페이지 번호가 포함된 인용 구절을 반환합니다. 지식은 LLM의 메모리와 분리되어 유지됩니다.
• GCF(컴팩트 네트워크 증거) – 도구 출력(테이블, 토폴로지 그래프, 델타)을 더 작은 토큰 표현으로 압축하는 직렬 변환기로, LLM 호출의 컨텍스트 크기를 줄입니다.
• 모바일 및 Zoom – Flutter 앱을 사용하면 엔지니어가 휴대폰에서 변경 사항을 승인할 수 있습니다. Zoom 사이드 패널은 회의 기록에서 조사를 트리거할 수 있습니다.
• VS Code 확장 – VS Code 내에 NetClaw 활동 표시줄을 추가하여 채팅, RAG 탐색, 테스트베드 인벤토리 편집, MCP 구성, 시각적 BGP 토폴로지를 제공합니다.

주요 기능

• 실시간 네트워크 조사 – 장치 쿼리, nmap 실행, BGP 상태 가져오기, 업로드된 설계 가이드와 비교.
• 안전 장치가 있는 변경 자동화 – 구성 편집을 제안하고, 기준선을 통해 실행하고, 결과를 검증하고, 불변 감사 추적을 기록합니다.
• 전문 "NetClaws" – 위험 분할 작업을 위해 단일 Border 뒤에 여러 집중 에이전트를 배포합니다.
• 확장 가능한 스킬 카탈로그 – 237개의 사전 작성 스킬(예: pyATS, NetBox, ServiceNow, AWS, Azure, FortiManager 등). 설치별로 활성화/비활성화할 수 있습니다.
• 보안 및 규정 준수 – 모든 작업에는 명시적 승인이 필요합니다. 감사 로그, 토큰 경제학, "보안 모드" 패널은 LLM이 무엇을 할 수 있는지 명확히 합니다.

대상 – 네트워크 운영 팀, NOC 엔지니어, 보안 분석가. LLM 기반 어시스턴트가 자체 환경 내에서 작동하고, 원시 네트워크 데이터를 클라우드로 보내지 않으며, 이미 사용 중인 도구와 통합되기를 원하는 사람들.

시작하기 – 저장소를 클론하고 ./scripts/install.sh를 실행하고(프로필 선택), OpenClaw 또는 Hermes를 선택하고, http://localhost:3000을 열어 HUD를 시작합니다. README에는 각 구성 요소(RAG 파이프라인, GCF 직렬 변환기, 모바일 빌드, Zoom 통합, VS Code 확장, 안전 사양)에 대한 자세한 문서 링크가 있습니다.