@openclaw/potato

Potato Bot channel plugin for OpenClaw.

Connect your OpenClaw assistant to Potato — a Telegram-compatible messaging platform popular in Asia.

Install

openclaw plugins install @openclaw/potato

Or from source:

openclaw plugins install -l ./openclaw-channel-potato

Configure

Add to ~/.openclaw/openclaw.json:

{
  "channels": {
    "potato": {
      "botToken": "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
    }
  }
}

Then restart the gateway:

openclaw gateway

Allow all users (open access)

{
  "channels": {
    "potato": {
      "botToken": "...",
      "dmPolicy": "open",
      "allowFrom": ["*"],
      "groupPolicy": "open",
      "groupAllowFrom": ["*"],
      "groups": {
        "*": { "requireMention": false }
      }
    }
  }
}

Pairing (default — private use)

By default only approved users can send messages. Unknown senders receive a code:

openclaw pairing list potato
openclaw pairing approve potato <CODE>

Full Config Reference

| Key | Default | Description | |---|---|---| | botToken | — | Bot token from @BotFather in Potato | | dmPolicy | "pairing" | pairing / allowlist / open | | allowFrom | [] | Allowed user IDs. Use ["*"] for everyone | | groupPolicy | "allowlist" | allowlist / open / disabled | | groups | {} | Group allowlist. "*" matches all groups | | groupAllowFrom | (inherits allowFrom) | Allowed sender IDs in groups | | streaming | "off" | off / partial / block / progress | | markdown | true | Enable Markdown rendering | | typingIndicator | true | Show typing action while processing | | pollTimeout | 30 | Long-poll timeout in seconds | | webhookUrl | — | Enable webhook mode (Active Mode) | | webhookSecret | — | Secret path component for webhook URL |

Potato API Differences from Telegram

• API base: https://api.rct2008.com:8443/<token>/METHOD
• Every send call requires chat_type (1=DM, 2=Group, 3=SuperGroup)
• Send method: sendTextMessage (not sendMessage)
• Markdown flag: markdown: true (not parse_mode)
• Delete webhook: delWebhook (not deleteWebhook)
• No reactions, no forum topics

License

MIT