OpenClaw / ClawBot

OpenClaw (also called ClawBot) is a self-hosted AI agent with a built-in MCP client. Point it at Pingram’s hosted MCP server, sign in once, and the agent can use your Pingram account as tools.

General MCP setup for Claude, ChatGPT, and Cursor lives in the MCP guide. This page covers OpenClaw specifically.

The server lives at:

https://mcp.pingram.io

Other regions (use the same region as your account):

https://mcp.ca.pingram.io   # Canada
https://mcp.eu.pingram.io   # EU

Prerequisites

  1. Install the OpenClaw macOS app (or Gateway) and finish onboarding so you have a working chat + model.
  2. Put the CLI on your PATH if commands fail with command not found:
Terminal window
export PATH="$HOME/.openclaw/bin:$PATH"

Use a model that handles tool calls reliably (for example Google Gemini Flash). Small local models often drop required fields like type.

Connect Pingram MCP

Option A — CLI (recommended)

Terminal window
openclaw mcp add pingram \
  --url https://mcp.pingram.io \
  --transport streamable-http \
  --auth oauth


openclaw mcp login pingram

Sign in with the same Pingram account you use in the dashboard. When OAuth finishes:

Terminal window
openclaw mcp doctor pingram --probe

You should see Pingram tools (OpenClaw prefixes them, for example pingram__email_send and pingram__sms_send).

Option B — Control UI

  1. Open Settings → MCP → Add server.
  2. Name: pingram
  3. Transport: Streamable HTTP
  4. URL: https://mcp.pingram.io (or your region’s URL)
  5. Save, then run openclaw mcp login pingram if the UI does not start OAuth.

Smoke test

Ask the agent in natural language, or call tools directly:

Email

Send an email via Pingram to you@example.com with subject “OpenClaw test” and a short HTML body. Use notification type openclaw_test.

Required args for pingram__email_send:

{
  "type": "openclaw_test",
  "to": "you@example.com",
  "subject": "OpenClaw test",
  "html": "<p>OpenClaw MCP test</p>"
}

SMS

Send an SMS via Pingram to +15551234567 saying “OpenClaw SMS test”. Use notification type openclaw_test.

Required args for pingram__sms_send:

{
  "type": "openclaw_test",
  "to": "+15551234567",
  "message": "OpenClaw SMS test"
}

type is any non-empty label used to group the send in Logs and Insights. Check the dashboard Logs for delivery status.

ClawHub skill (optional)

Install the Pingram skill so the agent has concise instructions for connecting and calling tools:

Terminal window
openclaw skills install pingram

Or search ClawHub for Pingram and install from the UI. The skill does not replace MCP — it teaches the agent how to use the connected Pingram tools.

Troubleshooting

Symptom What to try
command not found: openclaw export PATH="$HOME/.openclaw/bin:$PATH"
Probe connects but sends fail with missing type Switch to a stronger model (Gemini Flash-Lite worked in our tests)
Tools missing after reconnect openclaw mcp doctor pingram --probe, then openclaw mcp login pingram again
Auth expired Re-run openclaw mcp login pingram

Security notes

  • The agent acts as you, with access limited to your Pingram account.
  • To disconnect, remove the pingram MCP server in Settings or via the CLI, or revoke the MCP session from your Pingram account.