@pinchbot/openclaw-channel

OpenClaw channel plugin for Pinch — a companion creature that lives on your Apple Watch and iPhone.

What it does

• Connects your OpenClaw agent to the Pinch app via WebSocket relay
• Receives chat messages and health summaries from the Pinch app
• Sends creature state updates (mood, thought bubbles) to the app in real-time
• Manages creature pairing, pinch acknowledgment, and heartbeat check-ins

Install

openclaw plugins install @pinchbot/openclaw-channel

Restart the gateway after installing.

Setup

1. Ask your agent to set up Pinch — it will generate a 6-digit pairing code
2. Enter the code in the Pinch iPhone app
3. Your creature appears and the WebSocket channel is live

Config

The plugin reads from channels.pinch in your OpenClaw config:

{
  channels: {
    pinch: {
      enabled: true,
      gatewayToken: "<generated during pairing>"
    }
  }
}

The gatewayToken is created automatically when your agent runs the pairing tool for the first time.

Agent Tools

All tools are registered as optional and ownerOnly.

| Tool | Description | |------|-------------| | pinch_pair | Generate a pairing code for the Pinch app | | pinch_creature_state | Read current creature state (mood, stage, metrics) | | pinch_creature_update | Update creature mood and thought bubble | | pinch_pinches_get | List unacknowledged pinches | | pinch_pinches_ack | Acknowledge pinches by ID |

To enable these tools, add pinch to your agent's tool allowlist:

{
  agents: {
    list: [
      {
        id: "main",
        tools: { allow: ["pinch"] }
      }
    ]
  }
}

Requirements

• OpenClaw 2026.3.7 or later
• Pinch iPhone app (TestFlight)
• Apple Watch with Pinch app (optional, for creature on wrist)

Links

• Pinch
• OpenClaw