arlo-health

OpenClaw plugin for Arlo Health. Talk to a licensed healthcare providers — right from your AI agent.

What is Arlo Health?

Arlo Health provides virtual consultations with licensed healthcare providers who can diagnose, treat, and prescribe medications for common conditions. All via text messaging, $30 per visit.

Can help with: Infections (UTI, sinus, skin), allergies, cold/flu, birth control, prescription renewals, travel health, minor injuries.

Cannot help with: Emergencies (call 911), mental health crises, controlled substances, conditions needing physical exam.

Install

npm install arlo-health

How It Works

Once installed, your OpenClaw agent gets 21 tools. The agent automatically detects when a user describes health symptoms and guides them through the full telemedicine flow:

1. Connect — User authenticates via a link (arlo_connect)
2. Describe — Agent gathers symptoms conversationally, then starts consultation (arlo_start_consultation)
3. Triage — AI triage asks follow-up questions, agent relays responses (arlo_send_message)
4. Pay — Agent handles the payment gate ($30 per visit or subscription)
5. Provider — Licensed provider connects, diagnoses, and may prescribe
6. Pharmacy — Agent helps select a pharmacy for prescriptions (arlo_select_pharmacy)

Real-time notifications keep the user informed when providers respond — no polling needed.

Tools

Authentication

| Tool | Description | |------|-------------| | arlo_connect | Connect user's Arlo Health account (OAuth) | | arlo_auth_status | Check if user is connected | | arlo_disconnect | Disconnect Arlo account |

Consultations

| Tool | Description | |------|-------------| | arlo_list_consultations | List past/active consultations | | arlo_start_consultation | Start new consultation with symptom narrative | | arlo_get_consultation | Get consultation status and messages | | arlo_cancel_consultation | Cancel before provider connects | | arlo_get_notes | Get clinical notes from completed consultation |

Messaging

| Tool | Description | |------|-------------| | arlo_send_message | Send message in consultation (waits for AI during triage) | | arlo_get_media | Get download URL for photos/videos/files |

Profile

| Tool | Description | |------|-------------| | arlo_get_profile | Get user profile and onboarding status | | arlo_update_profile | Update patient info (name, DOB, province, medical history) |

Prescriptions

| Tool | Description | |------|-------------| | arlo_list_prescriptions | List prescription history | | arlo_get_prescription | Get prescription details | | arlo_search_pharmacies | Find pharmacies by name/location | | arlo_select_pharmacy | Send prescription to pharmacy |

Billing

| Tool | Description | |------|-------------| | arlo_get_billing | Get subscription/billing status | | arlo_setup_payment | Create Stripe payment setup | | arlo_subscribe | Activate subscription | | arlo_confirm_connection | Confirm pay-per-use ($30) | | arlo_cancel_subscription | Cancel subscription |

Configuration

The plugin works out of the box with sensible defaults. Optional configuration:

# Environment variables
ARLO_API_URL=https://mcp.arlohealth.ai

Real-Time Notifications

How it works

When Arlo has something to tell the user (provider message, triage complete, prescription ready, etc.), it sends a POST to your registered webhook URL. OpenClaw receives this and wakes the agent session, delivering the payload as a system message.

The agent is then responsible for deciding what to do. It fetches the latest message, uses judgment, and proactively delivers to the user via the appropriate channel messaging tool. This is intentional — the agent can summarize, add context, and filter noise rather than blindly forwarding raw API events.

Recommended setup: hooks/wake

Register with OpenClaw's built-in /hooks/wake endpoint (the default). This wakes the agent's main session, which then runs with the notification in context.

For this to work, configure your agent with prompting like:

When you receive an [Arlo] webhook notification:

1. Call arlo_get_consultation to get the latest message
2. Decide if it needs the user's attention
3. If yes, push via the appropriate messaging tool (message, channel post, etc.) using the channel/to from the registered deliveryContext
4. Summarize — don't copy verbatim
5. Do NOT just reply in session — that reply won't reach the user

For OpenClaw agents, add this to your HEARTBEAT.md or system prompt equivalent. The arlo_register_webhook tool description already includes this guidance for the agent at runtime.

Alternative: custom endpoint

If you need custom processing (filtering, formatting, multi-channel fan-out), stand up your own webhook endpoint and register that URL instead. The plugin makes no assumptions about delivery — it calls whatever URL you register.

Webhook payload

Arlo sends a POST with a human-readable message field. That text is what OpenClaw injects into the agent session as the system message trigger.

How Sessions Work

Auth tokens are stored in the session. After a user completes login or signup via the OAuth flow, the agent must fetch the tokens from the session to make authenticated requests. Each user gets a deterministic session key based on their OpenClaw identity.

Service Availability

Arlo Health is currently available in Canada only. Patients must be located in a Canadian province.

Support

• Website: https://www.arlohealth.ai
• Email: [email protected]