메인 콘텐츠로 건너뛰기
오픈소스 셀프 호스팅 개인 AI 어시스턴트. 사이트: https://openclaw.ai (문서: https://docs.openclaw.ai, 저장소: https://github.com/openclaw/openclaw).
프로토콜: OpenAI 호환
  • Base URL: https://api.orcarouter.ai/v1 (/v1이 반드시 포함되어야 합니다)

​
설치

Node 22+가 필요합니다. openclaw 명령을 설치합니다: 
npm install -g openclaw
또는 macOS/Linux에서: 
curl -fsSL https://openclaw.ai/install.sh | bash

​
구성

~/.openclaw/openclaw.json을 편집하세요: 
{
  "models": {
    "mode": "merge",
    "providers": {
      "orcarouter": {
        "baseUrl": "https://api.orcarouter.ai/v1",
        "apiKey": "sk-orca-...",
        "api": "openai-completions",
        "models": [ { "id": "orcarouter/auto", "name": "OrcaRouter Auto" } ]
      }
    }
  },
  "agents": { "defaults": { "model": { "primary": "orcarouter/orcarouter/auto" } } },
  "gateway": { "mode": "local" }
}

​
실행

openclaw agent --local --agent main --session-id s1 -m "Reply with exactly: OK"
OK 응답을 기대하세요.

​
참고 사항

  • baseUrl은 각 모델 항목 안이 아니라 models.providers.<name> 아래에 있어야 합니다. 모델에 두면 Unrecognized key: "baseUrl"이 발생합니다.
  • base URL은 후행 /v1을 유지합니다. 모델 참조는 provider/model을 사용하므로 auto 라우터는 orcarouter/orcarouter/auto입니다.
  • 기본 에이전트 이름은 default가 아니라 main입니다. 비대화형 실행에는 --local과 --session-id를 사용하세요.
  • 모델 이름은 vendor/model 형식을 사용합니다. orcarouter/auto를 anthropic/claude-opus-4.8 또는 google/gemini-2.5-flash 같은 특정 모델로 바꾸세요(그리고 primary 참조도 그에 맞게 업데이트하세요).

​
thinking / reasoning

OpenClaw는 표준 OpenAI 호환 API(api: "openai-completions")를 통해 OrcaRouter와 통신하므로, reasoning은 모델 자체의 동작을 따릅니다 — reasoning 가능 모델 (예: anthropic/claude-* reasoning 모델)을 선택하면 업스트림에서 구성된 대로 사고합니다.