What makes android-sms-gateway-local notable?

2.9K downloads. Trust evidence available

How should android-sms-gateway-local be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

Claim this agent

agentCLAWHUBUnverified

android-sms-gateway-local

Send and receive SMS/MMS via SMS Gateway for Android (android-sms-gateway / sms-gate) using Local Server mode with Basic Auth, including webhooks, inbox export, and message status checks.

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

2.9k

Updated

Oct 9, 2026

Version

0.1.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 2.9K downloads reported by the source. Last updated 10/9/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 9, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 9, 2026
Adoption signal: 2.9K downloadsadoption · observed Oct 9, 2026
Latest release: 0.1.0release · observed Jul 25, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17dmjpd250973tjtpk2e7fdmx885wc8:android-sms-gateway-local

Install using `clawhub skill install s17dmjpd250973tjtpk2e7fdmx885wc8:android-sms-gateway-local` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/hajekt2/android-sms-gateway-local before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-hajekt2-android-sms-gateway-local/snapshot"

Documentation

CLAWHUB

11,006 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: android-sms-gateway-local
description: Send and receive SMS/MMS via SMS Gateway for Android (android-sms-gateway / sms-gate) using Local Server mode with Basic Auth, including webhooks, inbox export, and message status checks.
---

# Android SMS Gateway (Local)

Use this skill when working with the Android SMS Gateway app in Local Server mode. Keep the flow minimal and confirm missing inputs before calling the API.

## Gather Inputs

Ask for any missing details:
- Device local IP and port (default port is 8080)
- Local Server username and password
- Action: send SMS, receive SMS (webhook), export inbox, or check status
- For sending: phone numbers, message text, optional `deviceId` and `simNumber`
- For receiving: webhook URL and whether HTTPS is available
- For exporting inbox: `deviceId` and a time window (`since`, `until`)

## Connect and Validate

- Base URL for Local Server is `http://<device_ip>:<port>`.
- Local Server supports Basic Auth only; include credentials in every request.
- Validate connectivity first with `GET /health`, then list devices with `GET /devices`.

## Send SMS

- Use `POST /messages` with `phoneNumbers` and `textMessage.text` (preferred) or `dataMessage` if requested.
- Include `deviceId` or `simNumber` when the user wants to target a specific device or SIM.
- Use `withDeliveryReport: true` if the user needs delivery confirmation.

## Receive SMS

- Register a webhook with `POST /webhooks` and `event: "sms:received"` (optionally scope to a `deviceId`).
- The webhook receiver must support HTTPS for private IPs unless it is `http://127.0.0.1`.
- To fetch historical inbox messages, call `POST /messages/inbox/export` after the webhook is registered.

## Status Tracking

- Use `GET /messages/{id}` to read the message `state` and other fields.
- Consider also registering `sms:sent`, `sms:delivered`, and `sms:failed` webhooks for near-real-time status updates.

## References

- Use `{baseDir}/references/api.md` for endpoint summaries, payload shapes, and event names.

## Scripts

- Use `{baseDir}/scripts/health.sh` and `{baseDir}/scripts/list_devices.sh` to verify connectivity.
- Use `{baseDir}/scripts/send_sms.sh` to send a text message.
- Use `{baseDir}/scripts/get_message.sh` and `{baseDir}/scripts/list_messages.sh` to check status.
- Use `{baseDir}/scripts/register_webhook.sh`, `{baseDir}/scripts/list_webhooks.sh`, and `{baseDir}/scripts/delete_webhook.sh` to manage webhooks.
- Use `{baseDir}/scripts/export_inbox.sh` to replay inbox messages.

README.md

# Android SMS Gateway Local Skill

This repo contains a skill for OpenClaw that sends and receives SMS via the Android SMS Gateway app in Local Server mode with Basic Auth.

**Contents**
- `SKILL.md`
- `references/api.md`
- `scripts/*.sh`

**Install**
1. Clone this repo.
2. Copy the skill folder into your OpenClaw skills directory.

Example:
```bash
# Replace $OPENCLAW_SKILLS with your configured skills directory
cp -R . "$OPENCLAW_SKILLS/android-sms-gateway-local"
```

**Usage**
```bash
chmod +x scripts/*.sh
export SMS_GATE_BASE_URL="http://192.168.1.10:8080"
export SMS_GATE_USER="your-user"
export SMS_GATE_PASS="your-pass"
export PHONE_NUMBERS="+15551234567"
export MESSAGE_TEXT="Hello from Local Server"
./scripts/send_sms.sh
```

**Security**
Never commit credentials. Use environment variables or a local `.env` file that is ignored by git.

**License**
See `LICENSE`.

_meta.json

{
  "ownerId": "kn79sz4h2hzc5wxxtarf1zr47980m8bj",
  "slug": "android-sms-gateway-local",
  "version": "0.1.0",
  "publishedAt": 1785018284737
}

references/api.md

# API Reference (Local Mode)

Use this as a compact reminder. For full details, consult the official docs.

## Base URL and Auth

- Local Server base: `http://<device_ip>:<port>` (default `8080`).
- Local Server supports Basic Auth only.

Note: The Local Server quickstart shows `POST /message`, while the OpenAPI spec lists `/messages`. Prefer `/messages`; if you see 404 on Local Server, try `/message`.

## Health and Devices

- `GET /health`
- `GET /devices`

## Send SMS (Text)

- `POST /messages`
- Required: `phoneNumbers` (array)
- Preferred payload: `textMessage: { "text": "..." }`
- Optional fields: `deviceId`, `simNumber`, `priority`, `ttl`, `validUntil`, `withDeliveryReport`
- Query params: `skipPhoneValidation` (bool), `deviceActiveWithin` (hours)

Example (text message):
```json
{
  "phoneNumbers": ["+15551234567"],
  "textMessage": { "text": "Hello from Local Server" },
  "withDeliveryReport": true
}
```

## Message Status

- `GET /messages/{id}`
- `GET /messages` with query params: `from`, `to`, `state`, `deviceId`, `limit`, `offset`
- States: `Pending`, `Processed`, `Sent`, `Delivered`, `Failed`
- `Delivered` is only available if `withDeliveryReport` was enabled at send time.

## Receive SMS (Webhooks)

- `POST /webhooks` with body `{ "url": "https://...", "event": "sms:received", "deviceId": "..." }`
- Events: `sms:received`, `sms:data-received`, `mms:received`, `sms:sent`, `sms:delivered`, `sms:failed`, `system:ping`
- HTTPS is required for private IPs; only `http://127.0.0.1` can be used without TLS.

## Inbox Export (Historical Receive)

- `POST /messages/inbox/export` with `deviceId`, `since`, `until`
- Requires a registered `sms:received` webhook; the device will replay inbox messages to the webhook URL.

## Webhooks Management

- `GET /webhooks`
- `DELETE /webhooks/{id}`

## Test Scripts (Bash + curl)

All scripts live in `{baseDir}/scripts/` and use `curl.exe`.

Required env vars for all scripts:
- `SMS_GATE_BASE_URL` (example: `http://192.168.1.10:8080`)
- `SMS_GATE_USER`
- `SMS_GATE_PASS`

Linux tip: `chmod +x {baseDir}/scripts/*.sh` before running.

Per-script env vars:
- `send_sms`: `PHONE_NUMBERS` (comma-separated), `MESSAGE_TEXT`, optional `DEVICE_ID`, `SIM_NUMBER`, `WITH_DELIVERY_REPORT`
- `get_message`: `MESSAGE_ID`
- `list_messages`: optional `MSG_FROM`, `MSG_TO`, `MSG_STATE`, `DEVICE_ID`, `MSG_LIMIT`, `MSG_OFFSET`
- `register_webhook`: `WEBHOOK_URL`, optional `WEBHOOK_EVENT`, `DEVICE_ID`
- `delete_webhook`: `WEBHOOK_ID`
- `export_inbox`: `DEVICE_ID`, `INBOX_SINCE`, `INBOX_UNTIL`

skill-card.md

## Description:

Send and receive SMS/MMS via SMS Gateway for Android (android-sms-gateway / sms-gate) using Local Server mode with Basic Auth, including webhooks, inbox export, and message status checks.

This skill is ready for commercial/non-commercial use.

## Publisher:

[hajekt2](https://clawhub.ai/user/hajekt2)

### License/Terms of Use:

MIT

## Use Case:

Developers and operators use this skill to help an agent configure and call an Android SMS Gateway device in Local Server mode for sending SMS/MMS, checking message status, managing webhooks, and exporting inbox messages.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill can send SMS, access message status, register webhooks, and replay inbox messages when given gateway credentials.

Mitigation: Confirm the intended action, destination numbers, webhook URL, device scope, and inbox export time window before running commands.

Risk: Gateway credentials and SMS contents may be exposed if Local Server traffic crosses an untrusted network.

Mitigation: Use the skill only on a trusted network or behind TLS, VPN, or loopback protection, avoid shared Wi-Fi, and rotate credentials if they may have been sent over an untrusted network.

Risk: Webhook registration can forward received SMS/MMS content to an unintended endpoint.

Mitigation: Verify webhook ownership and HTTPS support before registration, and remove webhooks that are no longer needed.

## Reference(s):

- [API Reference (Local Mode)](references/api.md)
- [Server-resolved GitHub source](https://github.com/hajekt2/android-sms-gateway-local)

## Skill Output:

**Output Type(s):** [text, markdown, shell commands, configuration, guidance]

**Output Format:** [Markdown guidance with inline shell commands and JSON payload examples]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Uses environment variables for gateway URL, Basic Auth credentials, phone numbers, message text, webhook URLs, device identifiers, and time windows.]

## Skill Version(s):

0.1.0 (source: ClawHub release metadata)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/hajekt2/skills/android-sms-gateway-local",
      "sourceUrl": "https://clawhub.ai/hajekt2/skills/android-sms-gateway-local",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T10:39:47.024Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-hajekt2-android-sms-gateway-local/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-hajekt2-android-sms-gateway-local/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-09T10:39:47.024Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "2.9K downloads",
      "href": "https://clawhub.ai/hajekt2/android-sms-gateway-local",
      "sourceUrl": "https://clawhub.ai/hajekt2/android-sms-gateway-local",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T10:39:47.024Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "0.1.0",
      "href": "https://clawhub.ai/hajekt2/android-sms-gateway-local",
      "sourceUrl": "https://clawhub.ai/hajekt2/android-sms-gateway-local",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-07-25T22:24:44.737Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-hajekt2-android-sms-gateway-local/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-hajekt2-android-sms-gateway-local/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 0.1.0",
      "description": "android-sms-gateway-local v0.1.0 - Initial release. - Enables sending and receiving SMS/MMS using the Android SMS Gateway app in Local Server mode via Basic Auth. - Supports actions: send SMS, receive SMS via webhook, export inbox, and check message status. - Includes instructions for gathering required inputs and validating connection to the gateway device. - Provides script references for core actions, including message sending, webhook management, and inbox export.",
      "href": "https://clawhub.ai/hajekt2/android-sms-gateway-local",
      "sourceUrl": "https://clawhub.ai/hajekt2/android-sms-gateway-local",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-07-25T22:24:44.737Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 9, 2026.

About

Avoid when

Public facts

Install and run

Documentation

Extracted files

SKILL.md

README.md

_meta.json

references/api.md

skill-card.md

Related agents

activepieces

cherry-studio

AionUi

CopilotKit

Machine-readable data