OpenClaw 컨텍스트 창과 속도 제한(rate limit) 문제 해결

먼저 오류 유형을 판단하세요

OpenClaw 설정 페이지의 Model Window 위치. 구체적인 필드 이름은 버전에 따라 달라질 수 있으므로 현재 페이지와…

세 필드가 각각 의미하는 것

• contextWindow: 모델 원래 컨텍스트 창의 메타데이터.
• contextTokens: OpenClaw 실제로 입력에 허용되는 상한으로, 원래 창보다 작을 수 있습니다.
• maxTokens: 단일 응답의 최대 출력 Token 상한이며, 전체 컨텍스트 크기가 아닙니다.

“더 큰 컨텍스트를 얻기 위해” 1M 를 임의로 채우지 마세요. 입력 값은 모델 성능, LLM API Gateway의 현재 라우팅 제한, 클라이언트 버전을 모두 충족해야 합니다.

구성 위치

주 구성은 일반적으로 다음 위치에 있습니다.

~/.openclaw/openclaw.json

Agent별로 별도 구성할 때는 일반적으로 다음 위치에 있습니다.

~/.openclaw/agents/<agentId>/agent/models.json

OPENCLAW_AGENT_DIR 가 설정되어 있다면 해당 디렉터리에서 해당 Agent 구성을 찾으세요.

안전하게 수정하는 예시

아래 수치는 필드 간의 관계를 보여줄 뿐, 모든 모델의 실제 상한을 의미하지 않습니다. 먼저 이 사이트의 모델 목록과 현재 라우팅 설명에서 수치를 확인하세요.

{
  models: {
    mode: "merge",
    providers: {
      guishu: {
        baseUrl: "https://api.llm-token.cn/v1",
        apiKey: "YOUR_API_KEY",
        api: "openai-completions",
        models: [
          {
            id: "YOUR_MODEL_ID",
            name: "YOUR_MODEL_ID",
            contextWindow: 128000,
            contextTokens: 96000,
            maxTokens: 8192,
            input: ["text"]
          }
        ]
      }
    }
  }
}

시스템 프롬프트, 도구 결과, 모델 출력을 위해 창 일부를 남겨 두세요. 업스트림이 더 작은 입력 또는 출력만 허용한다면 계속 값을 낮춰야 하며, 모델 제조사의 홍보 수치만 그대로 입력하면 안 됩니다.

수정 및 검증 순서

1. 현재 구성 파일을 백업하고, 유일한 복사본을 덮어쓰지 마세요.
2. 현재 provider와 모델 항목만 수정하고 나머지 구성은 유지하세요.
3. openclaw models list 를 실행해 모델이 인식되는지 확인하세요.
4. openclaw models set guishu/YOUR_MODEL_ID 를 실행해 선택된 provider/model이 올바른지 확인하세요.
5. 게이트웨이를 재시작하세요: openclaw gateway restart.
6. 먼저 아주 짧은 테스트 요청을 보낸 뒤, 컨텍스트를 점차 늘리세요.

짧은 요청에서도 429 가 반환된다면 컨텍스트 창을 더 키우는 것은 도움이 되지 않습니다. 동시성, 계정 할당량, 업스트림 상태를 확인하는 쪽으로 전환하세요. 긴 요청만 실패한다면 입력 길이, 압축 정책, 세 개의 컨텍스트 필드를 확인하세요.