FastClaw

개요

FastClaw는 Go로 작성된 경량 AI Agent 런타임으로, “에이전트 팩토리”로 자리매김합니다. 즉, 각기 고유한 성격(SOUL.md), 메모리, 스킬, 도구를 가진 여러 AI agent를 생성, 관리, 실행합니다. FastClaw는 LLM 통신, 도구 실행, 샌드박스 격리, 세션 관리를 기본 제공하며, 단일 바이너리로 배포되고 내장 Web 대시보드를 갖추고 있습니다. APIYI를 통합하면 다음과 같은 이점을 얻습니다:

🚀 단일 바이너리 배포

한 줄 설치, 번들된 SQLite, 로컬 또는 클라우드에서 실행

🤖 다중 Agent 관리

각 agent는 고유한 성격, 모델, 스킬, 세션을 가집니다

📱 다중 채널 IM

내장된 Telegram / Discord / Slack 채널 바인딩

🛡️ 샌드박스 격리

안전한 도구 실행을 위한 Docker / E2B 샌드박스 지원

프로젝트 정보: FastClaw는 FastClaw Community License(Apache 2.0 + 추가 조항) 아래에서 소스 공개됩니다. 저장소: github.com/fastclaw-ai/fastclaw.

설치 및 시작

공식 원라인으로 FastClaw를 설치합니다 — ~/.local/bin에 단일 바이너리를 배치합니다:

curl -fsSL https://raw.githubusercontent.com/fastclaw-ai/fastclaw/main/install.sh | bash

첫 실행 시 설정 마법사가 시작됩니다. LLM 제공자를 설정하면 기본 에이전트가 자동으로 생성됩니다:

fastclaw                    # Foreground (Ctrl+C to stop)
fastclaw daemon start       # Background (logs at ~/.fastclaw/daemon.log)
fastclaw daemon install     # Register as a launchd / systemd service

그다음 http://localhost:18953에서 대시보드를 엽니다(기본 포트 18953).

APIYI에 연결하기(권장)

APIYI는 OpenAI 및 Anthropic API 프로토콜과 모두 호환됩니다. FastClaw는 OpenAI 호환 프로바이더 또는 Anthropic 호환 프로바이더 중 어느 쪽이든 사용할 수 있으며 — 단일 APIYI 키로 동일한 전체 모델 매트릭스에 도달할 수 있습니다.

옵션 1: 대시보드로 설정하기(권장)

http://localhost:18953을 열고 첫 실행 시 생성된 관리자 계정으로 로그인합니다
모델 / 프로바이더로 이동하여 새 프로바이더 항목을 추가합니다:

항목	권장 값
프로바이더 유형	`OpenAI` 호환
기본 URL	`https://api.apiyi.com/v1`
API Key	APIYI 키(`sk-...`)
모델	필요에 따라 추가합니다. 예: `gpt-5.4`, `claude-sonnet-4-6`, `deepseek-v3.2`, `gemini-3.1-pro-preview`

에이전트의 모델 패널로 이동하여 기본 모델로 설정합니다

옵션 2: CLI로 설정하기

# 1. Create a new agent, initially bound to APIYI (OpenAI-compatible)
fastclaw agents init alpha \
  --provider openai \
  --model openai/gpt-5.4 \
  --api-key-env APIYI_API_KEY

# 2. Point the OpenAI provider's Base URL at APIYI
fastclaw agents config alpha set provider.openai.apiBase https://api.apiyi.com/v1
fastclaw agents config alpha set provider.openai.apiKeyEnv APIYI_API_KEY

# 3. Add the models you want (append, idempotent)
fastclaw agents config alpha set provider.openai.model gpt-5.4
fastclaw agents config alpha set provider.openai.model claude-sonnet-4-6
fastclaw agents config alpha set provider.openai.model deepseek-v3.2

APIYI_API_KEY 환경 변수는 먼저 셸에 내보내야 합니다(export APIYI_API_KEY=sk-...) — FastClaw는 데이터베이스에 키를 평문으로 저장하지 않습니다.

왜 APIYI인가?

하나의 키, 많은 모델: OpenAI / Anthropic / Google / DeepSeek / Zhipu 등 — 각 프로바이더를 따로 신청할 필요가 없습니다
가격 우위: 보통 공식 과금보다 5%-20% 저렴하며, 일부 모델에는 충전 보너스가 있습니다
중국 내 직접 접속: VPN 없이 해외 LLM에 접근할 수 있습니다
이중 프로토콜 호환성: FastClaw의 두 프로바이더 유형을 모두 지원합니다

옵션 3: Anthropic 네이티브 프로토콜(Claude 중심 워크로드에 가장 적합)

주로 Claude 모델을 사용한다면 Anthropic 프로바이더를 APIYI로 직접 지정합니다:

항목	권장 값
프로바이더 유형	`Anthropic`
기본 URL	`https://api.apiyi.com`
API Key	APIYI 키
모델	`claude-sonnet-4-6`, `claude-opus-4-7` 등

동등한 CLI:

fastclaw agents config alpha set provider.anthropic.apiBase https://api.apiyi.com
fastclaw agents config alpha set provider.anthropic.apiKeyEnv APIYI_API_KEY
fastclaw agents config alpha set provider.anthropic.model claude-sonnet-4-6
fastclaw agents config alpha set model claude-sonnet-4-6

기능 요약표

에이전트 관리

대시보드 → 에이전트: 에이전트를 생성 / 편집하고, SOUL.md(성격), IDENTITY.md, MEMORY.md(장기 메모리)를 정의합니다.

스킬

기본 제공: code-runner, image-gen, data-analysis, web-search, skill-creator. ClawHub / GitHub에서 더 설치할 수 있습니다.

IM 채널 바인딩

에이전트 → 채널: Telegram / Discord / Slack 봇 token을 붙여 넣으면 저장 시 자동으로 검증됩니다.

OpenAI 호환 API

/v1/chat/completions streaming 엔드포인트는 별도 설정 없이 모든 OpenAI SDK와 함께 작동합니다.

샌드박스 실행

Docker / E2B 샌드박스를 전환하려면 설정 → 런타임을 사용하며, tools 호출 후 아티팩트가 자동으로 동기화됩니다.

스케줄러

에이전트 → 스케줄러: 에이전트가 create_cron_job을 통해 cron 기반 리마인더를 만들 수 있게 합니다.

배포 모드

모드	사용 사례	주요 설정
Local	개인용	`fastclaw daemon start`, 기본 SQLite 저장소
Docker	단일 호스트 서비스	`cd deploy/docker && ./start.sh`
Kubernetes	다중 복제본 운영 환경	`FASTCLAW_STORAGE_TYPE=postgres` + S3 오브젝트 스토어

다중 복제본 배포에는 다음이 필요합니다:

FASTCLAW_STORAGE_TYPE=postgres, FASTCLAW_STORAGE_DSN=postgres://...
S3 호환 스토리지를 가리키는 FASTCLAW_OBJECT_STORE_* 변수 세트(포드 간에 skills와 workspaces를 동기화하는 데 사용됨)
FASTCLAW_BIND=all(0.0.0.0에서 수신)

전체 K8s 매니페스트는 저장소의 deploy/k8s/ 폴더에 있습니다.

FAQ

FastClaw와 OpenClaw의 차이점은 무엇입니까?

FastClaw: Go 기반의 단일 바이너리로, “Agent Factory” 사용 사례를 겨냥합니다. 멀티 에이전트 관리, IM 채널 전달, 샌드박스 격리를 지원합니다. 에이전트를 서비스로 배포하고 싶을 때 가장 적합합니다.
OpenClaw: Node.js 기반으로, 개인 로컬 어시스턴트 사용 사례에 초점을 맞춥니다. 로컬 프라이버시 + 멀티 IM 플랫폼 간 연동을 지원합니다.
둘 다 APIYI의 전체 모델 매트릭스에 접근할 수 있습니다. 배포 형태에 맞는 것을 선택하시면 됩니다.

APIYI의 전체 모델 라인업을 지원합니까?

예. APIYI는 OpenAI 호환 엔드포인트(https://api.apiyi.com/v1)와 Anthropic 호환 엔드포인트(https://api.apiyi.com)를 모두 제공합니다. FastClaw의 어느 provider 타입이든 사용할 수 있으며, APIYI 문서에 있는 model ID를 그대로 사용하시면 됩니다(예: gpt-5.4, claude-sonnet-4-6, deepseek-v3.2, gemini-3.1-pro-preview).

Telegram / Discord를 통해 에이전트를 노출하려면 어떻게 해야 합니까?

대상 플랫폼에서 bot을 만들고 token을 얻습니다
대시보드 → 에이전트를 선택 → Channels → token을 붙여넣고 저장합니다(getMe / auth.test를 통해 자동 검증됩니다)
IM 플랫폼에서 bot을 검색해 대화를 시작합니다. 세션은 chatID별로 분리됩니다

상용 프로젝트에서 사용할 수 있습니까?

예. FastClaw 커뮤니티 라이선스는 다음을 허용합니다:

✅ 자체 제품의 백엔드로 임베딩하는 것(상업적 사용)
✅ 조직 내부 배포

허용되지 않는 사항(상용 라이선스 없이는):

❌ FastClaw 자체를 관련 없는 조직들을 대상으로 하는 멀티테넌트 SaaS로 호스팅하는 것
❌ 대시보드에서 FastClaw 브랜딩을 제거하거나 수정하는 것

상용 라이선스: [email protected]

프로젝트 저장소

github.com/fastclaw-ai/fastclaw

APIYI API 문서

키와 Base URL 참조를 확인합니다

OpenClaw 대안

개인용 로컬 어시스턴트 사용 사례를 위한 다른 선택지입니다

요금 및 충전

APIYI 요금 및 첫 충전 보너스를 확인합니다

개요

대화형 AI

프로그래밍

커뮤니티 기여

AI 에이전트

엔지니어링

번역

개요

🚀 단일 바이너리 배포

🤖 다중 Agent 관리

📱 다중 채널 IM

🛡️ 샌드박스 격리

설치 및 시작

APIYI에 연결하기(권장)

옵션 1: 대시보드로 설정하기(권장)

옵션 2: CLI로 설정하기

옵션 3: Anthropic 네이티브 프로토콜(Claude 중심 워크로드에 가장 적합)

기능 요약표

에이전트 관리

스킬

IM 채널 바인딩

OpenAI 호환 API

샌드박스 실행

스케줄러

배포 모드

FAQ

관련 리소스

프로젝트 저장소

APIYI API 문서

OpenClaw 대안

요금 및 충전

​개요

🚀 단일 바이너리 배포

🤖 다중 Agent 관리

📱 다중 채널 IM

🛡️ 샌드박스 격리

​설치 및 시작

​APIYI에 연결하기(권장)

​옵션 1: 대시보드로 설정하기(권장)

​옵션 2: CLI로 설정하기

​옵션 3: Anthropic 네이티브 프로토콜(Claude 중심 워크로드에 가장 적합)

​기능 요약표

에이전트 관리

스킬

IM 채널 바인딩

OpenAI 호환 API

샌드박스 실행

스케줄러

​배포 모드

​FAQ

​관련 리소스

프로젝트 저장소

APIYI API 문서

OpenClaw 대안

요금 및 충전

개요

설치 및 시작

APIYI에 연결하기(권장)

옵션 1: 대시보드로 설정하기(권장)

옵션 2: CLI로 설정하기

옵션 3: Anthropic 네이티브 프로토콜(Claude 중심 워크로드에 가장 적합)

기능 요약표

배포 모드

FAQ

관련 리소스