The Pocket Alert (pocketalert.app) skill for OpenClaw enables OpenClaw agents and workflows to send push notifications to iOS and Android devices. It is used to deliver alerts and updates from automated tasks, workflows, and background processes.
This skill enables interaction with the Pocket Alert service through its CLI tool.
The pocketalert CLI must be installed and authenticated:
# Install (if not already installed)
# Download from https://info.pocketalert.app/cli.html and extract to /usr/local/bin/
# Authenticate with your API key
pocketalert auth <your-api-key>
# Basic notification
pocketalert send -t "Title" -m "Message"
# Full form
pocketalert messages send --title "Alert" --message "Server is down!"
# To specific application
pocketalert messages send -t "Deploy" -m "Build completed" -a <app-tid>
# To specific device
pocketalert messages send -t "Alert" -m "Check server" -d <device-tid>
# To all devices
pocketalert messages send -t "Alert" -m "System update" -d all
# List last messages
pocketalert messages list
pocketalert messages list --limit 50
pocketalert messages list --device <device-tid>
# List applications
pocketalert apps list
# List devices
pocketalert devices list
# List webhooks
pocketalert webhooks list
# List API keys
pocketalert apikeys list
# Create application
pocketalert apps create --name "My App"
pocketalert apps create -n "Production" -c "#FF5733"
# Get application details
pocketalert apps get <tid>
# Delete application
pocketalert apps delete <tid>
# List devices
pocketalert devices list
# Get device details
pocketalert devices get <tid>
# Delete device
pocketalert devices delete <tid>
# Create webhook
pocketalert webhooks create --name "GitHub Webhook" --message "*"
pocketalert webhooks create -n "Deploy Hook" -m "Deployed %repository.name% by %sender.login%"
pocketalert webhooks create -n "CI/CD" -m "*" -a <app-tid> -d all
# List webhooks
pocketalert webhooks list
# Get webhook details
pocketalert webhooks get <tid>
# Delete webhook
pocketalert webhooks delete <tid>
When creating webhooks, you can use template variables from the incoming payload:
pocketalert webhooks create \
--name "GitHub Push" \
--message "Push to %repository.name%: %head_commit.message%"
View or modify configuration:
# View config
pocketalert config
# Set API key
pocketalert config set api_key <new-api-key>
# Set custom base URL (for self-hosted)
pocketalert config set base_url https://your-api.example.com
Configuration is stored at ~/.pocketalert/config.json.
# GitHub Actions / GitLab CI
pocketalert send -t "Build Complete" -m "Version $VERSION deployed"
# Server monitoring with cron
*/5 * * * * /usr/local/bin/pocketalert send -t "Server Health" -m "$(uptime)"
# Service check script
if ! systemctl is-active --quiet nginx; then
pocketalert send -t "NGINX Down" -m "NGINX is not running on $(hostname)"
fi
The CLI returns appropriate exit codes:
0 - Success1 - Authentication or API error2 - Invalid argumentsAlways check command output for error details.