agent-wake_skill

Overview

This skill wakes an OpenClaw agent session from any external script or process so the agent can immediately react in the correct Discord channel. It injects a system-level event into the agent session so background tasks (CLI jobs, cron jobs, webhooks, alerts) can notify the agent and trigger an automatic response. Setup is minimal and uses a small Python script that calls the gateway HTTP API.

How this skill works

The included Python script posts to the gateway /tools/invoke endpoint using the cron tool, sending a wake event into the agent session. The event text is delivered as a system message, and the agent reads that message and posts its response to the specified Discord channel (or the default channel if none is given). The script has no external dependencies beyond the Python standard library.

When to use it

• After a background process completes so the agent can report results automatically.
• From cron jobs, CI pipelines, or scheduled backups to notify an agent of status changes.
• In automation flows where an external task needs the agent to take follow-up actions in Discord.
• From CLI tools (e.g., Claude Code CLI) to trigger the agent when a run finishes.
• For price alerts, webhooks, or any script-driven events that the agent must acknowledge.

Best practices

• Compose concise, specific system messages; the agent acts on the text it receives.
• Include the target Discord channel ID in the wake call when you want a specific channel response.
• Keep the script local to where tasks run and ensure GATEWAY_TOKEN and cron tool access are configured.
• Limit sensitive data in the wake message; treat the system message like a command input.
• Test with the default channel omitted to confirm the main session wake behavior before targeting channels.

Example use cases

• Notify an agent that an overnight backup finished and include a brief summary of file counts and errors.
• Trigger the agent when a scheduled test suite completes so it posts results and next steps to a team channel.
• Send a price-alert summary from a monitoring script that asks the agent to post a formatted alert in Discord.
• Have a Claude Code CLI job call the script at the end to wake the agent with the job summary and artifacts link.
• Use a webhook handler to call the script and wake the agent when an external service changes state.