Token Plan (Team Edition)
하나 이상의 할당된 사용자가 정기적인 코딩 및 에이전트 세션 전반에서 Coding Plan의 롤링 호출 창 없이 Credits-기반 접근 권한이 필요한 경우 최적의 선택입니다.
도구 + 모델 연계
OpenClaw과 알리바바 코딩 계획 및 크레딧 계획 (Token Plan)
오픈소스이며 자체 호스팅 개인 AI 어시스턴트로 코딩 및 로컬 에이전트 워크플로우에 적합합니다.
OpenClaw는 저장소, 터미널, 브라우저 및 연결된 채널 전반에서 작동하는 자체 호스팅 어시스턴트가 필요한 경우에 적합한 솔루션입니다. 알리바바는 pay-as-you-go, Coding Plan, Token Plan 접근 방식에 대한 직접 지원을 문서화하고 있습니다.
올바른 액세스 경로 선택
올바른 액세스 경로 선택
단일 사용자의 인터랙티브 개발 세션에는 Coding Plan를 선택하세요. 혼자 일하는 창업자나 팀이 Credits-기반 사용, 다중 계정, 또는 안정적인 일상적 에이전트 활용이 필요할 경우 Token Plan를 선택하세요. 게이트웨이를 사용하지 않을 때는 실행을 중지하여 하트비트 호출로 인한 요금제 사용량 소모를 방지하세요.
추천지속적인 에이전트 사용에는 Token Plan가 적합하며, 단일 대화형 개발자 작업에는 Coding Plan가 적합합니다.
Coding Plan
OpenClaw를 대화형으로 사용하는 개발자 한 명에게 가장 적합하며, 고정된 월간 요청 할당량을 선호할 경우 추천합니다.
Pay-as-you-go Model Studio API
백엔드, 예약 자동화, 공유 서비스 또는 할당된 사용자의 대화형 도구 세션이 아닌 모든 워크로드에 사용하세요.
안전한 구성 패턴
알리바바 공급자 등록 및 기본 모델로 선택
예시는 의도적으로 마스킹되어 있습니다. 플레이스홀더는 사용자의 기기에서만 교체하고, 실제 API 키를 Nfero에 붙여넣지 마세요.
시작하기 전에
- 최신 버전의 OpenClaw를 설치하고 `openclaw --version` 명령어가 정상 작동함을 확인합니다.
- 해당 알리바바 구독 페이지에서 전용 Coding Plan 또는 Token Plan API 키를 확보합니다.
- `~/.openclaw/openclaw.json` 파일을 수정하기 전에 정확히 지원되는 모델 ID를 선택하세요.
- 기존 OpenClaw 구성 파일을 백업하세요. 실제 키는 공개 이슈, 채팅 또는 웹사이트에 절대 입력하지 마세요.
안전한 구성 패턴
- 프로토콜
- OpenAI-compatible
- 구성 경로
~/.openclaw/openclaw.json
- 모델 접두사와 공급자 기록이 일치하도록 `bailian` 공급자를 생성합니다.
- 아래에 표시된 Token Plan 엔드포인트를 사용하거나, 이를 Coding Plan 엔드포인트 `https://coding-intl.dashscope.aliyuncs.com/v1`로 대체합니다.
- 로컬에서 자리표시자를 해당 요금제 전용 키로 교체합니다.
- 게이트웨이를 재시작한 후 `/model` 또는 `/status` 명령어를 사용하여 활성 공급자 및 모델을 확인합니다.
{
"models": {
"providers": {
"bailian": {
"baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
"apiKey": "YOUR_TOKEN_PLAN_API_KEY",
"api": "openai-completions",
"models": [{ "id": "qwen3.7-plus", "name": "Qwen3.7 Plus" }]
}
}
},
"agents": {
"defaults": { "model": { "primary": "bailian/qwen3.7-plus" } }
}
}연결 확인
- `openclaw gateway restart` 명령을 실행한 후 `openclaw tui`를 엽니다.
- `/status` 명령을 실행하고, 선택된 모델이 `bailian/`으로 시작하는지 확인합니다.
- 채널, 스킬 또는 예약 작업을 활성화하기 전에 간단한 저장소 관련 질문을 먼저 전송해 보십시오.
- 사용량이 유휴 상태에서도 증가할 경우, 세션 로그에서 `[OpenClaw heartbeat poll]`을 확인하십시오.
모델 연계
추천 시작 모델
이 도구을 사용하여 각 모델과 함께 대화형 코딩, 추론, 검토 및 문서 작업을 수행하세요. 생산 환경에서 최종 모델 가용성과 정확한 계획 지원은 Alibaba Cloud에서 확인하십시오.
Qwenqwen3.7-plus
텍스트 생성추론시각적 이해
최적의 조합 각도
추론 능력, 비전 이해, 도구 중심 워크플로우를 모두 갖춘 균형 잡힌 기본 모델입니다.
Qwenqwen3.7-max
텍스트 생성추론
최적의 조합 각도
알리바바에서는 대규모 코드베이스 및 장문맥 에이전트 작업에 이 모델을 권장합니다.
Qwenqwen3.6-flash
텍스트 생성추론시각적 이해
최적의 조합 각도
경량 라우팅, 요약 생성, 간단한 저장소 질문 등에 적합한 저소비 옵션입니다.
자주 발생하는 문제
자주 발생하는 문제
증상
HTTP 401, 유효하지 않은 액세스 토큰, 또는 invalid_iam_token 오류
가능한 원인
키가 불완전하거나, 폐기되었거나, 다른 요금제에서 발급된 키이거나, 잘못된 요금제/리전 엔드포인트와 연결되어 있습니다.
해결 방법
전용 키를 다시 복사하여 문서화된 기본 URL과만 정확히 연결하십시오. 앞뒤 공백을 제거하고 게이트웨이를 재시작하십시오.
증상
알 수 없는 모델
가능한 원인
프로바이더 키, `bailian/` 모델 접두사 및 모델 목록이 일치하지 않거나, 해당 모델이 현재 허용 목록에 포함되어 있지 않습니다.
해결 방법
`models.providers.bailian` 설정이 존재하는지 확인하고, 기본 모델이 `bailian/<model-id>` 형식을 사용하며, 정확한 모델 ID가 해당 프로바이더 하위에 명시적으로 나열되어 있는지 확인하십시오.
증상
OAuth 토큰 갱신 실패
가능한 원인
OpenClaw이 이전 버전의 OAuth 공급자 또는 캐시된 모델 구성으로 계속 라우팅되고 있습니다.
해결 방법
파일을 백업한 후, 사용되지 않는 OAuth/공급자 기록을 제거하고 오래된 모델 캐시를 지운 다음 알리바바 FAQ에 설명된 대로 OpenClaw를 재시작합니다.
증상
대화 중인 사용자가 없음에도 불구하고 사용량이 지속됨
가능한 원인
OpenClaw 게이트웨이의 하트비트가 구성된 모델을 주기적으로 호출할 수 있습니다.
해결 방법
유휴 상태일 때 게이트웨이를 중지하거나 `agents.defaults.heartbeat.every` 값을 증가시킵니다. 변경 사항은 세션 로그에서 확인하세요.
주요 제한 사항
- API 전용 키와 기준 URL은 반드시 동일한 알리바바 청구 요금제에서 가져와야 합니다. Coding Plan, Token Plan, 일반적인 Model Studio 자격 증명은 상호 교환할 수 없습니다.
- 요금제 키는 인터랙티브 코딩 또는 에이전트 도구에서 지정된 사용자만을 위해 할당됩니다. 이를 공유하거나 저장소에 커밋하거나 스크린샷에 노출해서는 안 됩니다.
- 자동화된 스크립트, 배치 작업, 애플리케이션 백엔드, 공용 서비스 또는 기타 비인터랙티브 API 워크로드에는 Coding Plan 또는 Token Plan 키를 사용하지 마세요. 이러한 워크로드에는 pay-as-you-go Model Studio API 접근 권한을 사용하세요.
- 모델 가용성은 정확한 문자열 허용 목록이며 변경될 수 있습니다. 작동 중인 설정을 편집하기 전에 현재 알리바바 요금제 문서에서 모델 ID를 반드시 확인하세요.