Neoclaw

neoclaw

**100% free, 100% local, 100% C++ — 개인 AI 어시스턴트 인프라**. [OpenClaw](https://github.com/openclaw/openclaw) / [NullClaw](https://github.com/nullclaw/nullclaw) 와 같은 컨셉을 NeoGraph 오케스트레이션 위에 C++ 로. 채널 (CLI, HTTP webhook, …), 스킬 (echo, 일상 대화, 코딩 에이전트, …), LLM 공급자 (인-프로세스 GGUF / 외부 OpenAI-호환 HTTP), 메모리 엔진 (SQLite 대화 이력), 도구 (fs 4 종 + 외부 MCP 자동 머지), 샌드박스 (bubblewrap) 까지 모두 가상함수 한 장으로 갈아끼우는 vtable 모델.

빠른 시작 (v0.6)

# 스트리밍 일상 대화 (영속 메모리 옵션):
./build/neoclaw --model path/to/model.gguf --skill daily_chat \
                --memory ~/.cache/neoclaw/transcripts.db

# 코딩 에이전트 (도구 + 샌드박스):
./build/neoclaw --model path/to/model.gguf --skill coding_agent \
                --project-root /path/to/your/project

# 웹 리서처 (인터넷 검색 + 본문 가져오기 → 요약):
./build/neoclaw --model path/to/model.gguf --skill researcher
# 예: ❯ 오늘자 한국 뉴스 헤드라인 3개만 짧게 요약해줘.

# HTTP webhook 모드 (Discord/Telegram 봇 webhook 패턴과 동일):
./build/neoclaw --skill echo --http-only --http-port 8765
# 그리고: curl -X POST localhost:8765/message -d '{"user":"a","text":"hi"}'

# 외부 MCP 서버의 도구를 자동 머지:
./build/neoclaw --model ... --skill coding_agent --project-root . \
                --mcp-stdio "uvx mcp-server-fetch"

CLI 안에서 `/help`, `/skills`, `/mode NAME` 으로 스킬을 런타임 교체 가능.

v0.5 코딩 에이전트 (legacy 보존)

`neoclaw-legacy` 라는 별도 바이너리로 동일 빌드에서 함께 만들어집니다. v0.5 까지의 단일 목적 코딩 에이전트 (YAML 설정 + FTXUI 토폴로지 픽커 + HF 모델 자동 다운로드 + bwrap) 그대로. 회귀 검증 + 기존 워크플로 보존용.

./build/neoclaw-legacy --project-root /path/to/your/project

소스는 [`src/legacy/v0_5/`](src/legacy/v0_5/README.md) 에. 새 골격의 coding_agent 스킬이 도구·샌드박스 측면에서 legacy 와 동등해지면 한 release 동안 deprecation 알림 띄운 뒤 제거 검토.

골격 디렉터리 (v0.6)

디렉터리	책임
include/neoclaw/	공개 인터페이스 헤더 (types, channel, skill, runtime, tool, sandbox, memory)
src/core/	Runtime + ToolRegistry — 라우팅과 등록부
src/channels/	CliChannel + HttpWebhookChannel — 입출력 채널
src/skills/	ec