OpenClaw-Setup/openclaw-setup-copilot/PRD.md

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.