# Send Android SMS Gateway to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "android-sms-gateway", "name": "Android SMS Gateway", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/NadjiHamid/android-sms-gateway", "canonicalUrl": "https://clawhub.ai/NadjiHamid/android-sms-gateway", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/android-sms-gateway", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=android-sms-gateway", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "package.json", "references/api_reference.md", "references/capcom6_reference.md", "scripts/bulk_sms.sh", "scripts/bulk_sms_capcom6.sh" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "android-sms-gateway", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T00:45:13.324Z", "expiresAt": "2026-05-07T00:45:13.324Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=android-sms-gateway", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=android-sms-gateway", "contentDisposition": "attachment; filename=\"android-sms-gateway-2.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "android-sms-gateway" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/android-sms-gateway" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/android-sms-gateway", "downloadUrl": "https://openagent3.xyz/downloads/android-sms-gateway", "agentUrl": "https://openagent3.xyz/skills/android-sms-gateway/agent", "manifestUrl": "https://openagent3.xyz/skills/android-sms-gateway/agent.json", "briefUrl": "https://openagent3.xyz/skills/android-sms-gateway/agent.md" } } ``` ## Documentation ### Android SMS Gateway Self-hosted SMS gateway using an Android phone with HTTP API integration. Full control, no third-party dependencies. ### Overview This skill enables sending and receiving SMS messages through an Android phone running an SMS Gateway app. The phone exposes a local HTTP API that this skill uses to send messages and check received messages. ### Supported Apps Primary (Original Scripts) SMS Gateway API (⭐ Recommended) - https://github.com/itsmeichigo/SMSGateway SMSGate - https://github.com/iamsmgate/smsgate SMS Forwarder - https://github.com/pppscn/SmsForwarder capcom6/android-sms-gateway (New Scripts) SMS Gateway for Android - https://github.com/capcom6/android-sms-gateway ✅ End-to-end encryption ✅ Local + Cloud + Private server modes ✅ Multi-device support ✅ Webhooks for incoming messages ✅ Multi-recipient bulk sends ### Prerequisites Android phone with SMS capability Install SMS Gateway app on the phone Phone and OpenClaw host on same network (or port forwarding) Configure app with API access enabled ### Setup (Once) # 1. Install SMS Gateway API app on Android # Download from: https://github.com/itsmeichigo/SMSGateway/releases # 2. Configure the app: # - Enable HTTP API server # - Set API token/password # - Note the phone's IP address and port (default: 8080) # 3. Test connectivity curl http://PHONE_IP:8080/api/v1/status -H "Authorization: Bearer YOUR_TOKEN" # 4. Save configuration to TOOLS.md (see Configuration section) ### Send SMS # Basic send ./scripts/send_sms.sh --to "+1234567890" --message "Hello from OpenClaw" # With config file ./scripts/send_sms.sh --config ~/.openclaw/sms-gateway.json \\ --to "+1234567890" \\ --message "Alert: Security scan complete" # Via environment variables export SMS_GATEWAY_URL="http://192.168.1.100:8080" export SMS_GATEWAY_TOKEN="your-api-token" ./scripts/send_sms.sh --to "+1234567890" --message "Test message" ### Check Received Messages # List recent received messages ./scripts/receive_sms.sh --limit 10 # Check for new messages since timestamp ./scripts/receive_sms.sh --since "2026-02-22T00:00:00Z" ### Check Gateway Status # Verify gateway is online ./scripts/check_status.sh ### Bulk SMS # Send to multiple recipients ./scripts/bulk_sms.sh --recipients "+1234567890,+0987654321" --message "Broadcast message" # From file (one number per line) ./scripts/bulk_sms.sh --recipients-file ./contacts.txt --message "Alert" ### Option 1: Environment Variables export SMS_GATEWAY_URL="http://192.168.1.100:8080" export SMS_GATEWAY_TOKEN="your-api-token" export SMS_GATEWAY_TIMEOUT="30" ### Option 2: Config File Create ~/.openclaw/sms-gateway.json: { "gateway_url": "http://192.168.1.100:8080", "api_token": "your-api-token", "timeout_seconds": 30, "default_sender": "+1234567890", "retry_count": 3 } ### Option 3: Command Line Args All scripts support --url and --token flags: ./scripts/send_sms.sh --url "http://192.168.1.100:8080" --token "token" --to "+1234567890" --message "Hi" ### Environment Variables export SMS_GATEWAY_URL="http://192.168.1.100:8080" # Local server # export SMS_GATEWAY_URL="https://api.sms-gate.app/3rdparty/v1" # Cloud export SMS_GATEWAY_USER="your-username" export SMS_GATEWAY_PASS="your-password" export SMS_GATEWAY_TIMEOUT="30" ### Config File Create ~/.openclaw/sms-gateway-capcom6.json: { "gateway_url": "http://192.168.1.100:8080", "gateway_user": "your-username", "gateway_pass": "your-password", "server_mode": "local", "timeout_seconds": 30 } ### Usage Examples # Send SMS ./scripts/send_sms_capcom6.sh --to "+1234567890" --message "Hello" # Cloud mode ./scripts/send_sms_capcom6.sh --mode cloud --to "+1234567890" --message "Hello" # Register webhook for incoming SMS ./scripts/register_webhook_capcom6.sh --url "https://your-server.com/webhook" # Bulk send (multi-recipient in single API call) ./scripts/bulk_sms_capcom6.sh --multi --recipients "+1234567890,+0987654321" --message "Alert" # Check status ./scripts/check_status_capcom6.sh ### Save to TOOLS.md Add your configuration to TOOLS.md for reference: ### Android SMS Gateway - **App:** SMS Gateway API (itsmeichigo/SMSGateway) - **Phone:** Samsung Galaxy, IP: 192.168.1.100 - **Port:** 8080 - **Token:** Stored in ~/.openclaw/sms-gateway.json (chmod 600) ### API Reference See references/api_reference.md for detailed API endpoints for each supported app. ### Network Security LAN only: Keep gateway on local network when possible Firewall: Restrict access to gateway port HTTPS: Use HTTPS if exposing externally (requires app support) VPN: Use VPN for remote access instead of port forwarding ### capcom6-Specific Security FeatureBenefitE2E EncryptionMessage content encrypted before API transitPrivate ServerDeploy your own backend (no cloud dependency)Basic AuthStandard HTTP authenticationWebhooksIncoming messages pushed directly from device Recommendation: Use capcom6's private server mode for maximum security: https://docs.sms-gate.app/getting-started/private-server/ ### Authentication Strong tokens: Use random API tokens (32+ chars) Token rotation: Rotate tokens periodically File permissions: chmod 600 ~/.openclaw/sms-gateway.json ### Rate Limiting Avoid spam: Implement sending limits in your workflows Carrier limits: Respect SMS carrier rate limits (~1 msg/sec) Queue system: Use queue for bulk sends ### Gateway Not Responding # Check phone connectivity ping PHONE_IP # Check API endpoint curl -v http://PHONE_IP:8080/api/v1/status # Check app is running (on phone) # - Open SMS Gateway app # - Verify server is started # - Check logs in app ### Authentication Failed # Verify token curl -v http://PHONE_IP:8080/api/v1/status -H "Authorization: Bearer YOUR_TOKEN" # Check token format (some apps use different auth headers) # See references/api_reference.md for app-specific auth ### Message Not Sent # Check phone signal # Check SMS balance/plan # Check app logs # Verify recipient number format (include country code) ### Security Alert System # Send alert when scan detects issues ./scripts/send_sms.sh --to "+1234567890" \\ --message "🛡️ ALERT: Vulnerability found on 192.168.1.50" ### Two-Factor Auth Codes # Send 2FA code (integrate with your auth system) CODE=$(openssl rand -base64 6 | tr -d '/+=' | head -c 6) ./scripts/send_sms.sh --to "$USER_PHONE" \\ --message "Your verification code: $CODE" ### Scheduled Reminders # Cron job for daily security reminder # crontab -e 0 9 * * * /path/to/send_sms.sh --to "+1234567890" --message "Daily security check: Review logs" ### Monitoring Integration # Nagios/Zabbix alert script #!/bin/bash STATUS=$1 if [ "$STATUS" != "OK" ]; then ./scripts/send_sms.sh --to "+1234567890" --message "MONITOR ALERT: $STATUS" fi ### Original (itsmeichigo/SMSGateway) scripts/send_sms.sh - Send single SMS scripts/receive_sms.sh - Fetch received messages scripts/check_status.sh - Check gateway health scripts/bulk_sms.sh - Send to multiple recipients ### capcom6/android-sms-gateway scripts/send_sms_capcom6.sh - Send single SMS scripts/register_webhook_capcom6.sh - Register webhook for incoming SMS scripts/check_status_capcom6.sh - Check gateway health scripts/bulk_sms_capcom6.sh - Send to multiple recipients (supports multi-recipient API) ### References API Reference - Detailed API docs for each app SMS Gateway API - Primary supported app SMSGate - Alternative app SMS Forwarder - Alternative with forwarding ### Notes Message encoding: Scripts handle UTF-8 for international characters Long messages: Automatically split for messages > 160 chars (GSM) or > 70 chars (Unicode) Delivery reports: Some apps support delivery callbacks (see api_reference.md) Dual SIM: Specify SIM slot if phone has dual SIM (app-dependent) ## Trust - Source: tencent - Verification: Indexed source record - Publisher: NadjiHamid - Version: 2.0.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-30T00:45:13.324Z - Expires at: 2026-05-07T00:45:13.324Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/android-sms-gateway) - [Send to Agent page](https://openagent3.xyz/skills/android-sms-gateway/agent) - [JSON manifest](https://openagent3.xyz/skills/android-sms-gateway/agent.json) - [Markdown brief](https://openagent3.xyz/skills/android-sms-gateway/agent.md) - [Download page](https://openagent3.xyz/downloads/android-sms-gateway)