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

섹션별 상세

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

근거

claw는 Pure POSIX sh + curl + jq만으로 구성되어 의존성이 없습니다. — Zero dependencies 섹션
OpenAI와 Anthropic 모델을 플래그 하나로 전환하여 사용할 수 있습니다. — Multi-provider 섹션

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 플래그를 활성화하면 모델이 사용자의 원래 요청에 비추어 자신의 답변을 스스로 검정하고 개선합니다. 이는 복잡한 논리적 추론이나 정확한 코드 작성이 필요한 작업에서 답변의 신뢰도를 높이는 역할을 합니다.

용어 해설

POSIX 쉘(POSIX sh): — 유닉스 계열 운영체제에서 표준으로 정의된 명령어 인터프리터 규격입니다. 특정 배포판에 의존하지 않고 리눅스, 유닉스, macOS 등 다양한 환경에서 동일하게 동작하는 스크립트를 작성할 수 있게 해줍니다.
도구 호출(Tool Calling): — LLM이 외부 도구나 함수를 실행해야 한다고 판단하면 특정 형식의 명령을 생성하고, 시스템이 이를 실행한 결과를 다시 모델에 전달하는 메커니즘입니다. 이를 통해 AI가 직접 파일 시스템을 조회하거나 명령어를 실행할 수 있습니다.
롤링 메모리(Rolling Memory): — 대화 내용이 길어져 모델의 컨텍스트 창을 초과할 때, 이전 내용을 요약하거나 압축하여 핵심 정보만 유지하는 메모리 관리 기법입니다. claw에서는 JSONL 파일에 기록된 대화를 세션 규칙과 저널로 압축하여 효율을 높입니다.

기술

POSIX sh
curl
jq
OpenAI API
Anthropic API

활용 사례

서버 로그 분석 및 자동 조치
경량 컨테이너 내 AI 어시스턴트
자연어 기반의 쉘 명령어 실행

언급된 리소스

문서claw 공식 사이트

Demo브라우저 내 리눅스 체험