Ping·claw · v1.0 · iOS + Android

Location context
for any AI agent.

A quiet iOS and Android app that shares your location with the AI tools you already use — Claude Code, Cursor, OpenClaw, or anything that speaks MCP. Open source. Self-hostable. Your location is never persisted.

Phone-first sign-in · no SMS 24-hour TTL, Redis only MIT licensed

Download for iOS Download for Android GitHub

location live

39.9043° N −75.3505° W

acc ± 7m src gps age 4s ttl 24h

§ 01 / AGENTS

Works with the agent you already run.

PingClaw is a location source, not an agent companion. Any agent that speaks MCP or accepts a webhook can consume your location — configuration snippets for all of them are one tap away in the dashboard.

GPT · One-tap ChatGPT Open the PingClaw GPT. The easiest path in.

MCP · Pull Claude Code Ask "where am I" — gets coords in the loop.

MCP · Pull Claude Desktop Via mcp-remote. Paste the snippet, done.

MCP · Pull Cursor Add to MCP settings. Works in chat and agent mode.

MCP · Pull Zed Context servers. One line in settings.

MCP · Pull VS Code MCP extension support. Shared with Copilot.

Push · Native OpenClaw Direct gateway delivery. No polling needed.

Webhook · Push Anything else POST with a bearer secret. Roll your own agent.

$ terminal

# register a webhook with your API key curl -X PUT https://pingclaw.me/pingclaw/webhook \ -H "Authorization: Bearer ak_…" \ -H "Content-Type: application/json" \ -d '{"url":"https://your-receiver/location","secret":"your-secret"}'

§ 02 / SETUP

Three steps. The app comes first.

Install the app, sign in on the phone, then open the web dashboard with a code the app hands you. No phone number, no SMS, no account to recover.

STEP 01

Install the app

iOS or Android. Sign in with Apple or Google inside the app, grant background location, and you're done with the phone.

STEP 02

Open the dashboard

From the app, generate a one-time code and paste it below. That's how the site knows it's you — no separate login.

STEP 03

Connect your agent

In the dashboard, mint an API key and copy a one-line config for your client. Or register a webhook for anything else.

§ 03 / IN USE

A quiet utility,
not an app you stare at.

PingClaw runs in the background. When your AI assistant needs your location, it gets the coordinates — accurate, current, scoped to the one API key that asked.

Coordinates only. Current only. Nothing is ever written to Postgres.

Coordinates lat · lon · accuracy

Cache lifetime 24h · Redis only

Persisted history none

Map rendered none

Notifications none

Scope one key, one user

§ 04 / OPENCLAW

Native push for OpenClaw users.

For OpenClaw, PingClaw goes a step further and pushes each location update directly to your gateway. Your agent gets your position as context automatically — no polling, no manual queries.

Two ways in.

Install the PingClaw skill to let your agent fetch your location on demand, or configure gateway push delivery from the dashboard for real-time updates.

Push mode supports two actions: Wake, which injects location as context silently, and Agent, which triggers a full agent run on every update.

push flow

phone pingclaw gateway

pull flow (skill)

agent skill pingclaw

§ 05 / SELF-HOSTING

Run your own server.

PingClaw is open source and self-hostable. One binary, no dependencies — SQLite, in-memory cache. No Redis, no Postgres, no outbound calls you didn't configure yourself.

Install the app as usual. On the sign-in screen, pick Self-Hosted Server, enter your server URL, and paste the pairing token your server printed on first run. No Apple or Google account needed — your location never leaves the machine you chose.

See the server repo for details.

$ terminal

# install go install github.com/pingclaw-me/pingclaw-server/cmd/pingclaw-server@latest # run — your location never leaves this machine pingclaw-server --local # listening on :8080 # dashboard at http://localhost:8080 # pairing token printed here — paste into the app

Give your agent a sense of place.

Install the app, pair your agent, and the next thing it answers about "near me" will actually mean something.

Download for iOS Download for Android

Dashboard · signed in

Your configuration.

Location

Live

location live

Locating…

API key

Active

Used by your AI agent. Shown only at creation and rotation — the server stores only a hash. Rotating breaks any agent using the previous key.

ChatGPT

Not connected

The simplest way to use PingClaw. Open the PingClaw GPT once — ChatGPT will ask you to connect your PingClaw account. After that, just use ChatGPT normally.

Once connected, ask ChatGPT anything location-aware — Where am I?, What's near me?, How far am I from the office? — and it will check your live location automatically.

Open PingClaw GPT ↗︎

MCP clients

Any agent that speaks MCP

Drop the snippet into your client's MCP config. Works with Claude Code, Claude Desktop, Cursor, Zed, and VS Code.

OpenClaw gateway

Not connected

Push your GPS position directly to your OpenClaw gateway every time your phone reports a new location. No polling, no manual queries.

Full setup guide (4 steps) ›

1. Enable hooks on your gateway

Add to your ~/.openclaw/openclaw.json and restart the gateway:

{
  "hooks": {
    "enabled": true,
    "token": "pick-a-strong-random-secret",
    "path": "/hooks"
  }
}

Generate a good token with openssl rand -hex 24.

2. Make your gateway reachable

PingClaw's server needs to POST to your gateway over the internet:

Tailscale Funnel — tailscale funnel 18789
ngrok — ngrok http 18789
Cloudflare Tunnel
VPS with a public IP

3. Connect PingClaw

Enter your gateway URL and token in the form below. PingClaw will send a test message before saving.

4. Verify

Check your OpenClaw session for the test message. Then move around — your agent has your location as context from then on.

Wake vs Agent mode

In wake mode (default), location is injected as context silently — no tokens, no reply triggered. Your next location-aware question just works. Agent mode triggers a full agent run on every update. Use for standing instructions like "remind me when I'm near a pharmacy." Costs tokens per update.

Gateway URL

Must be reachable from the internet — use Tailscale Funnel or a public deployment.

Hook token

The hooks.token value from your openclaw.json.

Hook path

Updates are sent to /hooks/{path} on your gateway.

Action

Wake injects location as context silently. Agent triggers a full agent run on every update.

Add to your ~/.openclaw/openclaw.json:

Webhook

Not registered

For any service that accepts a POST. PingClaw sends each location update to a URL you control, signed with a bearer secret.

1Export your API key

Generate or rotate your API key above, copy it, then set it in your shell:

2Pick a webhook secret

Any string works. PingClaw will replay it on every outbound POST so your receiver can verify:

3Register the webhook

Replace the URL with your receiver, then run:

Your data

Visible

Every record the server stores about your account. Nothing hidden, nothing retrospective.

Delete account

Irreversible

Permanently delete your account and all stored data. This cannot be undone.

Location context for any AI agent.