# PRD: OpenClaw Copilot Workstation Setup

## Purpose
Provide a repeatable, low-risk setup for a Copilot-only OpenClaw workstation with cost controls and schedule-based model routing.

## Goals
- Enforce `github-copilot/*` as the only provider/model family.
- Use paid profile during work hours (`08:00-18:00` local).
- Use free/low-cost profile off-hours (`18:00-08:00` local).
- Auto-heal routing/policy drift via launchd guardrails.
- Keep installation easy for AI-assisted and human-assisted setup.

## Scope
- Config-driven profile routing (`config/model-profiles.config.json`).
- Schedule guard (`scripts/model_schedule_guard.sh` + launchd).
- Budget guard, policy guard, auth watchdog.
- Staged launchd runtime under:
  - `~/Library/Application Support/openclaw-copilot-guard`

## Non-Goals
- Supporting non-Copilot providers in normal operation.
- Cross-platform install workflows (target is macOS).
- Billing automation outside model/provider selection.

## Required Outcomes
- `scripts/install_copilot_guardrails.sh` installs all 4 guards:
  - `ai.openclaw.model-budget-guard`
  - `ai.openclaw.copilot-policy-guard`
  - `ai.openclaw.copilot-auth-watchdog`
  - `ai.openclaw.copilot-model-schedule-guard`
- Off-hours traffic defaults to free/low-cost profile.
- Work-hours defaults return to paid profile.
- Docs clearly describe setup, verification, troubleshooting.

## Success Criteria
- Fresh machine setup succeeds using:
  - `setup/setup_openclaw_copilot.sh`
  - `copilot auth login`
  - `bash ./scripts/install_copilot_guardrails.sh`
- `openclaw models status` reflects expected profile by local time window.
- Launchd checks/logs show healthy runs and no repeated hard failures.