메인 콘텐츠로 건너뛰기
경량 AI 에이전트 CLI. 공식 저장소: https://github.com/HKUDS/nanobot
프로토콜: OpenAI 호환
  • Base URL: https://api.orcarouter.ai/v1 (/v1이 반드시 포함되어야 합니다)

​
설치

먼저 uv가 필요하며, 그런 다음 nanobot 명령을 설치하세요: 
uv tool install nanobot-ai

​
구성

~/.nanobot/config.json을 편집하세요: 
{
  "agents": {
    "defaults": {
      "model": "orcarouter/auto",
      "provider": "custom",
      "maxTokens": 4096,
      "temperature": 0.1
    }
  },
  "providers": {
    "custom": {
      "apiKey": "sk-orca-...",
      "apiBase": "https://api.orcarouter.ai/v1"
    }
  }
}

​
실행

nanobot agent -m "Reply with exactly: OK" --no-logs --no-markdown
OK 응답을 기대하세요.

​
참고 사항

  • 사전 정의된 custom provider를 사용하세요 — 본인만의 provider 이름을 만들지 마세요. 커스텀 이름은 무시되며 provider 'None' 오류가 발생합니다.
  • custom provider에 apiType 필드를 추가하지 마세요. 내장 openai provider만 apiType을 지원하며, custom에 추가하면 유효성 검사에 실패합니다.
  • base URL은 후행 /v1을 유지하며, agents.defaults.provider는 반드시 custom으로 설정해야 합니다.
  • 모델 이름은 vendor/model 형식을 사용합니다. orcarouter/auto를 anthropic/claude-opus-4.8 또는 google/gemini-2.5-flash 같은 특정 모델로 바꾸세요.

​
thinking / reasoning 활성화

agents.defaults 아래(또는 modelPresets 항목)에 reasoningEffort를 설정하세요. 유효한 값: none / low / medium / high / max. 생략하면(또는 null) 모델의 기본값을 따릅니다. 
{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-sonnet-4.6",
      "provider": "custom",
      "maxTokens": 16000,
      "reasoningEffort": "high"
    }
  },
  "providers": { "custom": { "apiKey": "sk-orca-...", "apiBase": "https://api.orcarouter.ai/v1" } }
}
maxTokens는 thinking 예산보다 커야 합니다. nanobot은 reasoningEffort: high를 Anthropic의 thinking.budget_tokens로 변환합니다. maxTokens(예: 기본값 4096)가 더 작으면 업스트림이 400 max_tokens must be greater than thinking.budget_tokens를 반환합니다. maxTokens를 ~16000으로 올리면 해결됩니다. (검증됨: ✻ 391을 반환.)