https://api.tokios.com/v1을 가리키도록 사용자 정의 OpenAI 호환 제공자를 추가하고 sk-tok-… API 키를 입력하면 사용자의 하드웨어에서 모델이 실행됩니다.
사전 요구 사항
커넥터가 연결됨
OpenClaw가 접속할 모델과 함께
tokios-connector을 설치하고 연결합니다.모델이 등록됨
해당 모델에 대한 배포 정보(공개 이름)를 등록합니다.
API 키가 생성됨
Create an
sk-tok-… key, optionally scoped to that deployment.지원되는 백엔드
로컬 백엔드(Ollama, llama.cpp, vLLM, LM Studio)가 정상적으로 실행 중인지 확인하세요.
Tokios를 모델 제공자로 추가합니다.
1
OpenClaw 설정 파일을 엽니다.
OpenClaw의 설정을 수정하는데, 업스트림 모델 ID가 정의된 곳은
models.providers입니다. 정확한 파일 경로는 설치 환경에 따라 다르므로 OpenClaw 설정 내용을 확인해 주세요.2
Tokios 제공자를 추가합니다.
Add a provider entry with The
api set to openai-completions, baseUrl pointed at Tokios, and your deployment listed under models:id under models is your public deployment name from the Models tab, not your backend’s local model id.3
해당 모델을 에이전트가 사용할 모델로 지정합니다.
방금 추가한 제공자를 에이전트의 기본 모델으로 설정하려면
<provider>/<model-id> 형식을 활용하세요.4
API 키를 입력합니다.
실제 API 키 내용을 설정 파일에 직접 기재하는 대신 환경 변수
TOKIOS_API_KEY에 sk-tok-… 값을 저장한 뒤 OpenClaw를 재시작하여 제공자 정보가 갱신되도록 합니다.Replace
gemma-tunnel with the deployment name you registered, and set TOKIOS_API_KEY to your own sk-tok-… key. Never commit a real key into the config file. OpenClaw can also speak the Anthropic surface — set api: "anthropic-messages" with baseUrl: "https://api.tokios.com" (no /v1) if you prefer it.당신의 비서이자 모델
OpenClaw는 휴대폰에서 명령을 보내는 에이전트입니다. Tokios는 사용자가 실행 중인 어떤 모델이든 안정적이고 인증된 엔드포인트를 제공합니다. 해당 모델 옆에 있는 커넥터가 Tokios에 연결되며, OpenClaw는 사용자의 API 키를 이용해https://api.tokios.com/v1을 호출합니다. 이로써 개인 비서가 인바운드 포트나 VPN 없이도 사용자가 호스팅한 모델 위에서 작동하게 됩니다.
문제 해결
401 오류
401 오류
OpenClaw가 전송한 API 키가 누락되었거나 형식이 올바르지 않거나 이미 취소된 상태입니다.
TOKIOS_API_KEY에 공백 없이 완전한 sk-tok-… 키가 저장되어 있는지 확인하고, Keys 탭에서 해당 키의 상태도 점검해 보세요.404 오류
404 오류
업스트림 모델 ID가 등록된 배포 정보과 일치하지 않거나
baseUrl에 /v1 정보가 누락되었습니다. models ID가 Models 탭에 표시된 공식 명칭과 일치하는지, 그리고 baseUrl 값이 https://api.tokios.com/v1인지 확인해 주세요.503 오류
503 오류
해당 배포용 커넥터가 오프라인 상태이거나 동시 접속 한도에 도달한 상태입니다. Connectors 탭을 확인해 보세요. 커넥터 상태가 Online로 표시되어야 하며, 커넥터가 실행 중인 머신도 정상적으로 작동하고 접근 가능한 상태여야 합니다.
다음 단계
호환되는 클라이언트
다른 OpenAI 및 Anthropic 호환 클라이언트들을 위한 기본 URL 및 키 설정 방법도 참고해 주세요.
API 키
팀원들과 에이전트들을 위해
sk-tok-… API 키를 생성하고 범위를 설정하며 주기적으로 교체할 수 있습니다.