메인 콘텐츠로 건너뛰기
NanoClaw는 경량형 컨테이너 기반의 개인용 AI 에이전트로, OpenClaw의 소형 대체품입니다. WhatsApp, Telegram, Slack, Discord, 이메일과 연동되며 메모리 및 예약 작업 기능도 갖추고 있습니다. 이 에이전트는 Anthropic의 Claude Agent SDK를 기반으로 작동하므로 Anthropic 호환 인터페이스를 통해 Tokios에 연결됩니다. ANTHROPIC_BASE_URL 값을 https://api.tokios.com로 설정하면 NanoClaw 에이전트가 사용자 하드웨어에 설치된 모델 위에서 실행됩니다.
NanoClaw uses the Anthropic API surface, so the base URL is the bare host https://api.tokios.com with no /v1 — the same shape as Claude Code. This is the opposite of the OpenAI-style clients that need /v1.

​
사전 요구 사항

커넥터가 연동됨

NanoClaw가 접속할 모델 옆에 tokios-connector을 설치하고 연동해주세요.

모델이 등록됨

해당 모델에 대한 배포 항목(공개 명칭)을 등록하세요.

API 키가 생성됨

Create an sk-tok-… key, optionally scoped to that deployment.

지원되는 백엔드 목록

사용 중인 로컬 백엔드(Ollama, llama.cpp, vLLM, LM Studio)가 정상적으로 작동하는지 확인하세요.

​
NanoClaw의 백엔드 설정을 Tokios로 지정합니다.

1

NanoClaw의 .env 파일을 엽니다.

NanoClaw 설치 폴더 내에 있는 .env 파일을 수정합니다.
2

Anthropic의 기본 URL과 API 키를 설정합니다.

Claude Agent SDK의 백엔드 역시 Tokios로 지정합니다.
.env
사용자의 sk-tok-… API 키는 ANTHROPIC_AUTH_TOKEN에 입력해야 합니다. 이 키는 SDK가 전송하는 베어러 토큰 역할을 합니다. 기본 URL에는 어떠한 /v1도 포함시키지 마세요.
3

배포된 모델을 사용하도록 설정합니다.

Set the agent’s model to the public deployment name you registered in the Models tab — for example, gemma-tunnel. NanoClaw defaults to Claude model names; when it points at Tokios, the model it requests must be your deployment name. The exact per-agent-group model setting varies by NanoClaw version — check yours.
4

NanoClaw를 재시작합니다.

NanoClaw(또는 해당 컨테이너)를 재시작하면 .env 설정이 다시 적용됩니다. 이제 에이전트는 Tokios를 통해 지정된 모델을 사용하게 됩니다.
NanoClaw는 선택형 스킬을 통해 OpenAI와 호환되는 백엔드나 로컬 백엔드도 활용할 수 있습니다. 예를 들어 OpenAI/OpenRouter용으로는 /add-opencode이나 /add-ollama-provider을 사용할 수 있습니다. 이러한 경우에는 OpenAI 기본 https://api.tokios.com/v1을 사용하시기 바랍니다. 절대로 실제 sk-tok-… API 키를 버전 관리 시스템에 저장해서는 안 됩니다.

​
프라이빗 모델을 활용하는 프라이빗 에이전트

NanoClaw는 사용자 컴퓨터 내부에 Claude 에이전트들을 격리된 컨테이너에 보관합니다. Tokios는 사용자가 실행 중인 모델에 안정적이고 인증된 엔드포인트를 제공합니다. 해당 모델 옆에 위치한 커넥터가 Tokios에 연결되며, NanoClaw는 사용자의 토큰을 이용해 https://api.tokios.com 주소에 접근합니다. 이로써 인바운드 포트나 VPN 없이도 자체 호스팅된 모델과 자체 호스팅된 어시스턴트가 작동하게 됩니다.

​
문제 해결

NanoClaw가 전송한 토큰이 누락되었거나 형식이 올바르지 않거나 이미 취소된 상태입니다. ANTHROPIC_AUTH_TOKEN에 불필요한 공백 없이 정확한 sk-tok-… API 키가 포함되어 있는지 확인하고, Keys 탭에서 해당 토큰의 상태도 점검하시기 바랍니다.
해당 모델이 등록된 배포 항목과 일치하지 않거나, 기본 URL 내에 /v1 문자열이 잘못 포함되었습니다. Models 탭에 명시된 공개 배포 이름과 일치하는지, 그리고 ANTHROPIC_BASE_URL 값이 https://api.tokios.com 형식만을 가지며 /v1이 포함되지 않았는지 확인하시기 바랍니다.
해당 배포에 사용되는 커넥터가 오프라인 상태이거나 동시 접속 한도에 도달했습니다. Connectors 탭을 확인해보세요. 커넥터 상태가 Online으로 표시되어야 하며, 커넥터가 실행 중인 머신도 정상적으로 작동하고 접근 가능한 상태여야 합니다.

​
다음 단계

Claude Code 활용하기

Claude Code CLI를 위해 Anthropic과 호환되는 동일한 기본 URL 및 키 패턴을 사용합니다.

API 키

팀원들과 에이전트들을 위해 sk-tok-… API 키를 생성하고 권한 범위를 설정하며 주기적으로 교체할 수 있습니다.