Hey summon - provider
/install heysummon-provider
HeySummon Provider Skill
You are a human-help provider for AI agents via HeySummon.
Setup
Step 1: Configure .env
Check if .env exists in {baseDir}. If not, copy from .env.example:
cp {baseDir}/.env.example {baseDir}/.env
Required variables:
HEYSUMMON_BASE_URL— Platform URL (cloud:https://cloud.heysummon.ai, self-hosted: user provides)HEYSUMMON_API_KEY— Provider key (hs_prov_...) from the dashboardHEYSUMMON_NOTIFY_TARGET— Chat ID for notifications
Step 2: Validate key
The API key MUST start with hs_prov_. Reject keys with hs_cli_ prefix — those are client keys.
Step 3: Start the watcher
bash {baseDir}/scripts/setup.sh
To stop: bash {baseDir}/scripts/teardown.sh
Architecture
AI Agent → HeySummon Platform → SSE → Watcher → OpenClaw → Notification
All communication flows through the platform. No direct infrastructure access.
Scripts
| Script | Purpose |
|---|---|
scripts/setup.sh |
Start the event watcher |
scripts/teardown.sh |
Stop the watcher |
scripts/mercure-watcher.sh |
SSE listener → notifications via OpenClaw |
scripts/reply-handler.sh |
Reply by refCode: reply-handler.sh HS-XXXX "response" |
scripts/respond.sh |
Reply by request ID: respond.sh \x3Cid> "response" |
Reply-to-Respond
When the user replies to a 🦞 notification, parse the refCode (HS-XXXX) from the quoted message and use reply-handler.sh. Always forward immediately — no AI processing, no confirmation.
Statuses
| Status | Meaning |
|---|---|
pending |
Waiting for provider |
active |
Conversation in progress |
responded |
Provider sent a response |
closed |
Closed by either party |
expired |
No response within 72 hours |
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install heysummon-provider - After installation, invoke the skill by name or use
/heysummon-provider - Provide required inputs per the skill's parameter spec and get structured output
What is Hey summon - provider?
Provides human-help support to AI agents via HeySummon by monitoring requests, sending notifications, and handling provider replies through a secure platform. It is an AI Agent Skill for Claude Code / OpenClaw, with 402 downloads so far.
How do I install Hey summon - provider?
Run "/install heysummon-provider" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Hey summon - provider free?
Yes, Hey summon - provider is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Hey summon - provider support?
Hey summon - provider is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Hey summon - provider?
It is built and maintained by thomasansems (@thomasansems); the current version is v0.1.0-beta.