claw: POSIX sh로 작성된 경량 LLM 에이전트

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

claw는 리눅스 환경에서 별도의 설치 과정 없이 즉시 실행 가능한 단일 파일 구성의 LLM 에이전트입니다. POSIX sh 표준을 준수하여 Alpine 컨테이너나 저사양 VPS에서도 curl과 jq만 있으면 OpenAI 및 Anthropic 모델을 활용할 수 있습니다. 스트리밍 채팅, 자동화된 쉘 도구 호출, 대화 내용을 압축하여 유지하는 롤링 메모리 기능을 제공합니다. 특히 멘토 모드를 통해 답변의 품질을 스스로 검토하고 수정하는 고도화된 에이전트 기능을 구현했습니다.

배경

기본적인 리눅스 쉘(sh/bash) 사용법, OpenAI 또는 Anthropic API 키, 시스템에 설치된 curl 및 jq

대상 독자

리눅스 서버 관리자 및 경량 LLM 에이전트 구현에 관심 있는 개발자

의미 / 영향

이 도구는 AI 에이전트 구축에 반드시 무거운 프레임워크가 필요하지 않음을 증명합니다. 특히 임베디드 시스템이나 컨테이너 환경에서 최소한의 자원으로 강력한 AI 자동화를 구현할 수 있는 가능성을 보여줍니다.

섹션별 상세

복잡한 런타임 없이 POSIX sh와 curl, jq만으로 구동되는 극도의 이식성을 지향합니다. 별도의 Node.js나 Python 설치 없이 단일 스크립트 파일만 다운로드하면 즉시 에이전트 환경을 구축할 수 있습니다. 이를 통해 Alpine 리눅스나 v86 가상 머신 같은 제한된 환경에서도 AI 기능을 활용하게 됩니다.

LLM이 생성한 쉘 명령어를 직접 실행하고 결과를 다시 입력으로 받는 도구 호출 기능을 지원합니다. 사용자가 요청하면 모델이 적절한 명령어를 생성하고 claw가 이를 실행하여 파일 시스템 조사나 로그 분석 등의 작업을 수행합니다. --confirm 플래그를 통해 명령어 실행 전 사용자의 승인을 받도록 설정하여 안전성을 확보할 수 있습니다.

대화 기록을 JSONL 형식으로 저장하고 컨텍스트가 넘칠 경우 자동으로 압축하는 롤링 메모리 시스템을 갖췄습니다. 이전 대화 내용을 세션 규칙과 마크다운 저널로 요약하여 긴 대화에서도 핵심 맥락을 잃지 않도록 관리합니다. 각 세션은 독립된 히스토리와 규칙을 가지며 /load 명령으로 즉시 전환이 가능합니다.

bash

wget -qO /usr/local/bin/claw https://getclaw.site/claw && chmod +x /usr/local/bin/claw

claw 에이전트를 다운로드하고 실행 권한을 부여하여 설치하는 명령어

bash

export OPENAI_API_KEY=sk-...
export ANTHROPIC_API_KEY=sk-ant-...

OpenAI 또는 Anthropic API 키를 환경 변수로 설정하는 방법

두 번째 어시스턴트가 첫 번째 답변을 비판적으로 검토하고 수정하는 멘토 모드를 제공합니다. --mentor 플래그를 활성화하면 모델이 사용자의 원래 요청에 비추어 자신의 답변을 스스로 검정하고 개선합니다. 이는 복잡한 논리적 추론이나 정확한 코드 작성이 필요한 작업에서 답변의 신뢰도를 높이는 역할을 합니다.

실무 Takeaway

인프라 제약이 심한 환경에서 LLM 에이전트를 배포해야 할 때 Python/Node 대신 claw와 같은 쉘 기반 도구를 사용하여 배포 복잡성을 제거할 수 있습니다.
반복적인 시스템 관리 작업에 claw의 도구 호출 기능을 결합하여 자연어로 서버 상태를 진단하고 즉각적인 조치를 취하는 인터페이스를 구축할 수 있습니다.
~/.config/clawlite/instructions/ 경로에 마크다운 파일을 추가하는 것만으로 별도의 재시작 없이 에이전트에 새로운 도메인 지식이나 프로젝트 컨텍스트를 주입할 수 있습니다.

언급된 리소스

문서claw 공식 사이트

Demo브라우저 내 리눅스 체험