FreeToken openclaw: 2026년 제로 토큰 설정 가이드

FreeToken openclaw는 통합 게이트웨이를 통해 여러 AI 웹 서비스에 연결하도록 설계된 브라우저 인증 기반 OpenClaw 설정입니다. 모든 제공업체에 대해 별도의 API 키를 구매하는 대신, 브라우저에 로그인하고 필요한 세션 자격 증명을 로컬에 저장한 뒤 OpenClaw 인터페이스를 통해 구성된 모델을 사용할 수 있습니다.

이 방식은 실험, 모델 비교 및 개인 에이전트 워크플로에 유용합니다. 그러나 공식적인 무제한 API 서비스와는 다릅니다. 웹 세션은 만료될 수 있고 웹 엔드포인트에는 요청 제한이 적용될 수 있으며, 각 제공업체의 이용 약관도 계속 적용됩니다.

제로 토큰 구성에서 OpenClaw를 사용하는 가장 큰 이유는 제공업체 계층입니다. 여러 웹 제공업체가 테스트된 대상으로 나열되어 있으며, Manus는 API 기반 무료 할당량을 제공하는 별도 항목으로 설명됩니다. 지원 세부 사항은 제공업체마다 다를 수 있으므로 실제로 필요한 서비스만 구성하세요.

모델을 전환하려면 채팅 상자에서 /model 명령어를 사용하세요. 제공업체에 여러 변형 모델이 있는 경우 정확한 모델 식별자를 사용하는 것이 좋습니다. 예를 들어 Claude 구성에서는 더 짧은 제공업체 전용 명령어보다 /model claude-web/claude-sonnet-4-6이 더 안정적으로 인식될 수 있습니다.

권장 설치 경로는 Node.js, pnpm, Chrome 디버그 세션, 웹 인증 마법사 및 게이트웨이 서버를 사용합니다. 온보딩을 완료하는 동안 브라우저와 터미널 세션을 계속 열어 두세요.

게이트웨이가 실행되면 Web UI가 구성된 모델을 테스트하기에 가장 간단한 장소입니다. CLI/TUI는 node openclaw.mjs tui로 사용할 수 있으며, 로컬 통합 기능은 구성에 정의된 게이트웨이 토큰을 사용해 HTTP 엔드포인트로 요청을 보낼 수 있습니다.

기본 예시 구성은 포트 3001과 토큰 기반 게이트웨이 인증을 사용합니다. 이 게이트웨이 토큰은 제공업체 쿠키 및 bearer 자격 증명과 분리해 보관하세요. 각각 보호하는 경계가 다릅니다. 게이트웨이 토큰은 로컬 API 액세스를 제어하고, 제공업체 자격 증명은 웹 세션을 인증합니다.

curl \
  -H "Authorization: Bearer YOUR_GATEWAY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-web/deepseek-chat",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

도구 호출은 프롬프트가 검색, 가져오기, 읽기, 쓰기, 메시지 전송 또는 로컬 명령어 실행과 같은 작업을 제안할 때 활성화되도록 설계되었습니다. 워크스페이스 제한은 구성된 에이전트 워크스페이스를 통해 제어되므로 해당 디렉터리의 범위를 좁게 유지하세요.

브라우저 인증 자동화에는 자격 증명을 신중하게 관리해야 합니다. 쿠키와 bearer 토큰은 프로젝트의 로컬 상태 영역을 포함한 로컬 인증 파일에 저장됩니다. 이러한 파일을 저장소에 커밋하거나, 공개 이슈 보고서에 붙여 넣거나, 스크린샷으로 공유하지 마세요.

웹 세션은 만료될 수 있으며 제공업체는 요청 제한을 적용할 수 있습니다. 따라서 이 설정은 대규모 프로덕션 트래픽보다 개인 테스트와 중간 수준의 작업량에 더 적합합니다. 제공업체가 응답하지 않거나 로컬 세션이 유효하지 않게 되면 브라우저에서 다시 인증하세요.

클린 빌드는 다음 순서로 진행합니다.

rm -rf dist dist-runtime node_modules pnpm install pnpm build pnpm ui:build ./server.sh restart

새 웹 제공업체를 추가할 때 프로젝트 구조는 인증, API 클라이언트 및 스트림 처리를 분리합니다. 일반적으로 제공업체에는 인증 모듈, 웹 클라이언트, 스트림 핸들러 및 스트림 팩토리 등록이 필요합니다. 이러한 분리를 통해 제공업체별 동작을 더욱 쉽게 유지 관리할 수 있습니다.