42 lines
1.7 KiB
Markdown
42 lines
1.7 KiB
Markdown
# 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.
|