brightwheel-login-helper

name: brightwheel-login-helper description: Manages Brightwheel web login including 2FA handling. metadata: openclaw: requires: - binary: "python3"

Brightwheel Login Helper

Handle authentication to Brightwheel's web portal at schools.mybrightwheel.com.

Login Flow

1. Navigate to https://schools.mybrightwheel.com
2. Check session — if already logged in, report success
3. If login needed: a. Enter email from BRIGHTWHEEL_EMAIL env var b. Enter password from BRIGHTWHEEL_PASSWORD env var c. Submit login form
4. Handle 2FA — if a verification code is required: a. Take a screenshot b. Report to ProviderConsole: "Brightwheel requires a 2FA code. Please check your email/phone and reply with the code." c. Wait for provider to supply the code d. Enter the code and complete login
5. Verify success — check that the dashboard loads

Browser Tool Usage

Use the OpenClaw browser tool with the openclaw profile:

Navigate to: https://schools.mybrightwheel.com
Take snapshot after each step for verification

Session Management

• Browser profile persists cookies, so login should persist between sessions
• If session expires (detected by redirect to login page), re-authenticate
• Report session status: "Brightwheel session active" or "Brightwheel login required"

Error Handling

• If login fails 3 times → stop and report to provider
• If 2FA code is invalid → ask provider for new code
• If Brightwheel is down → report and retry in 30 minutes