Show HN: Klaw.sh – AI 에이전트를 위한 Kubernetes

klaw란 무엇인가? (What is klaw?)

klaw는 엔터프라이즈 AI 에이전트 오케스트레이션입니다 — 마치 kubectl 같지만, AI 에이전트를 위한 것입니다.

# 모든 에이전트 보기
$ klaw get agents

...

Slack에서 모든 것을 제어하기

You: @klaw status

klaw: 📊 Agent Status
...

문제점 (The Problem)

프로덕션 환경에서 AI 에이전트를 운영하고 있습니다:

• Lead Scorer — 매시간 CRM 리드를 분석합니다.
• Competitor Watch — 경쟁사 웹사이트를 매일 모니터링합니다.
• Ticket Handler — 지원 티켓에 자동 응답합니다.
• Report Generator — 주간 분석 보고서를 생성합니다.

하지만 이를 관리하는 것은 혼란스럽습니다:

klaw는 AI 에이전트에 Kubernetes 스타일의 운영 기능을 제공합니다. 단일 바이너리. 몇 초 만에 배포됩니다.

빠른 시작 (Quick Start)

1. 설치

⚠️ [IMG:N] 형식 토큰은 이미지 placeholder 입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.

2. 설정 (Configure)

# 제공자(provider)를 하나 선택합니다
export ANTHROPIC_API_KEY=sk-ant-...      # Anthropic 직접 사용
export OPENROUTER_API_KEY=sk-or-...      # OpenRouter (100개 이상의 모델)
...

3. 실행 (Run)

# 대화형 채팅
klaw chat

...

실제 사례 (Real-World Examples)

영업: 리드 점수화 (Sales: Lead Scoring)

# 에이전트 생성
klaw create agent lead-scorer \
  --namespace sales \
...

연구: 경쟁사 정보 분석 (Research: Competitor Intelligence)

klaw create agent competitor-watch \
  --namespace research \
  --model gpt-4o \
...

지원: 티켓 자동화 (Support: Ticket Automation)

klaw create agent ticket-handler \
  --namespace support \
  --model claude-sonnet-4-20250514 \
...

분석: 자동 보고서 생성 (Analytics: Automated Reports)

klaw create agent report-gen \
  --namespace analytics \
  --model claude-sonnet-4-20250514 \
...

Slack 제어 (Slack Control)

klaw를 사용하면 Slack이 AI 명령 센터로 변합니다:

# 에이전트 관리
@klaw status                          # 모든 에이전트 목록 보기
@klaw describe lead-scorer            # 에이전트 상세 정보
...

아키텍처 (Architecture)

┌────────────────────────────────────────────────────────────────────────┐
│                           KLAW CONTROL PLANE                            │
│                                                                          │
...

Kubernetes 병렬 구조 (The Kubernetes Parallel)

배포 모드 (Deployment Modes)

단일 노드 (Single Node) — 개발 및 소규모 팀용

klaw chat              # 대화형 사용
klaw start             # 전체 플랫폼 실행

분산(Distributed) — 프로덕션 및 엔터프라이즈급

# 컨트롤러 (중앙 두뇌)
klaw controller start --port 9090

...

CLI 참고 자료 (CLI Reference)

# 핵심 명령어
klaw chat                        # 대화형 터미널 채팅
klaw start                       # 플랫폼 시작 (Slack + 스케줄러)
...

설정 (Configuration)

Minimal (~/.klaw/config.toml)

[provider.anthropic]
api_key = "${ANTHROPIC_API_KEY}"

Full Example

[defaults]
model = "claude-sonnet-4-20250514"
namespace = "default"
...

사용자 정의 Provider (OpenAI 호환)

base_url과 model을 설정하여 모든 OpenAI 호환 API를 provider로 사용할 수 있습니다. 이는 Ollama, LM Studio, vLLM, GLM, Minimax, Together AI 등에서 작동합니다.

# Ollama (로컬)
[provider.ollama]
base_url = "http://localhost:11434/v1"
...

다음과 같이 사용합니다:

klaw chat -p ollama
klaw chat -p lmstudio
klaw chat -p together

FAQ (자주 묻는 질문)

"OpenClaw와 무엇이 다른가요?"

OpenClaw는 강력하지만 복잡합니다. Node.js 기반이며 여러 서비스, 배포가 어렵고 확장하기 힘듭니다. klaw는 동일한 에이전트 기능을 갖추었지만 kubectl 스타일의 작업을 수행하는 단일 Go 바이너리입니다. 몇 초 만에 배포하고 노드를 추가하여 확장할 수 있습니다.

"LangChain/CrewAI와 무엇이 다른가요?"

그것들은 에이전트를 구축하기 위한 프레임워크입니다. klaw는 에이전트를 운영하기 위한 인프라입니다. LangChain으로 에이전트를 구축하고 klaw에 배포할 수 있습니다.

"에이전트 샌드박싱에 관한 것인가요?"

부분적입니다. 네임스페이스는 논리적 격리를 제공합니다:

• 스코프된 비밀(Scoped secrets) — 영업팀은 지원팀의 API 키에 접근할 수 없습니다.
• 도구 권한(Tool permissions) — 에이전트는 허용된 도구만 얻습니다.
• 리소스 격리(Resource isolation) — 각 네임스페이스는 독립적입니다.

중요: 컨테이너화되지 않은 에이전트는 파일 시스템 샌드박싱 기능이 없습니다. 사용자의 계정으로 실행되므로 접근 가능한 모든 파일에 접근할 수 있습니다. 진정한 프로세스/파일 시스템 격리가 필요하면 klaw run을 사용하여 Podman 컨테이너에서 에이전트를 실행하십시오.

"온프레미스 환경에서 실행할 수 있나요?"

네. 단일 바이너리이며 외부 종속성이 없습니다. 자체 서버, VPC 또는 에어갭(air-gapped) 환경에서 실행할 수 있습니다. 모든 것을 제어할 수 있습니다.

"지원되는 모델은 무엇인가요?"

each::labs 라우터를 통해 300개 이상의 모델을 지원하거나 Anthropic, OpenAI, Google, Azure, Ollama 및 모든 OpenAI 호환 엔드포인트에 직접 연결할 수 있습니다.

설치 (Installation)

빠른 설치 (Quick Install)

curl -fsSL https://klaw.sh/install.sh | sh

소스에서 빌드 (From Source)

git clone https://github.com/klawsh/klaw.sh.git
cd klaw && make build
sudo mv bin/klaw /usr/local/bin/

확인 (Verify)

klaw version
# klaw v1.0.0 (darwin/arm64)

기여하기 (Contributing)

git clone https://github.com/klawsh/klaw.sh.git
cd klaw
make build && make test
...

가이드라인은 CONTRIBUTING.md를 참조하세요.

커뮤니티 (Community)

• 문서 (Documentation) — 전체 문서 및 가이드
• GitHub 이슈 (GitHub Issues) — 버그 보고 및 기능 요청
• Discord — 커뮤니티 채팅
• Twitter — 업데이트 및 공지

라이선스 (License)

klaw는 each::labs License에 따라 소스 사용이 가능합니다.

내부 비즈니스 사용, 개인 프로젝트, 컨설팅 목적: 무료입니다.
멀티테넌트 SaaS 또는 화이트 라벨 배포: 라이선스가 필요합니다.

자세한 내용은 LICENSE를 참조하세요. 엔터프라이즈 라이선스는 [email protected]로 문의하십시오.