Skip to main content
Astrolabe is configured entirely with environment variables.

​
Required

  • OPENROUTER_API_KEY
  • ASTROLABE_API_KEY

​
Main runtime toggles

VariableDefaultPurpose
ASTROLABE_RESPONSES_ENABLEDtrueEnables POST /v1/responses
ASTROLABE_CHAT_COMPLETIONS_ENABLEDtrueEnables POST /v1/chat/completions
ASTROLABE_DEFAULT_PROFILEdefaultFinal routing posture
ASTROLABE_ROUTING_PROFILEbudgetComplexity adjustment before lane selection
ASTROLABE_COST_EFFICIENCY_MODEstrictLegacy cost guardrail mode

​
Safety controls

VariableDefaultPurpose
ASTROLABE_ENABLE_SAFETY_GATEtrueEnables high-stakes detection
ASTROLABE_HIGH_STAKES_CONFIRM_MODEpromptprompt, strict, or off
ASTROLABE_HIGH_STAKES_CONFIRM_TOKENconfirmConfirmation token used in strict mode
ASTROLABE_RESPONSES_FILES_URL_ALLOWLISTemptyComma-separated hosts/origins for file URLs
ASTROLABE_RESPONSES_IMAGES_URL_ALLOWLISTemptyComma-separated hosts/origins for image URLs
ASTROLABE_RESPONSES_MAX_URL_PARTS12Upper bound for URL-bearing Responses parts

​
Rate limiting

VariableDefault
ASTROLABE_RATE_LIMIT_ENABLEDfalse
ASTROLABE_RATE_LIMIT_WINDOW_MS60000
ASTROLABE_RATE_LIMIT_MAX_REQUESTS120

​
Control-plane model knobs

VariableDefault
ASTROLABE_CLASSIFIER_MODEL_KEYnano
ASTROLABE_SELF_CHECK_MODEL_KEYmini
ASTROLABE_CONTEXT_MESSAGES8
ASTROLABE_CONTEXT_CHARS2500

​
Force mode

ASTROLABE_FORCE_MODEL pins every request to one upstream model ID and bypasses normal routing and verifier escalation. For most OpenClaw users: 
ASTROLABE_RESPONSES_ENABLED=true
ASTROLABE_CHAT_COMPLETIONS_ENABLED=true
ASTROLABE_DEFAULT_PROFILE=default
ASTROLABE_ROUTING_PROFILE=budget
ASTROLABE_ENABLE_SAFETY_GATE=true
ASTROLABE_HIGH_STAKES_CONFIRM_MODE=prompt
For the cheapest possible setup: 
ASTROLABE_DEFAULT_PROFILE=strict-budget
For faster turn latency: 
ASTROLABE_DEFAULT_PROFILE=low-latency
For higher assurance on sensitive automation: 
ASTROLABE_DEFAULT_PROFILE=safe-untrusted
ASTROLABE_HIGH_STAKES_CONFIRM_MODE=strict