Messaging Official

Webex

Add Cisco Webex as a messaging channel. Works in spaces and 1:1 direct messages.

What it does

Connects NanoClaw to Cisco Webex via the Chat SDK bridge
Spaces (group conversations) and 1:1 DMs
Threaded replies
Bot-token authentication via developer.webex.com
Webhook signature verification

What you'll need

NanoClaw installed and running
A Webex developer account
A publicly reachable HTTPS endpoint for the webhook

Install

/add-webex

How it works

The /add-webex skill connects NanoClaw to Cisco Webex via the Chat SDK bridge. A bot you create at developer.webex.com receives space and DM events through a webhook, and NanoClaw replies via the Webex REST API.

Setup

Go to developer.webex.com/my-apps/new/bot and create a new bot.
Copy the Bot Access Token.
Create a webhook (via the Developer Portal or REST API) pointing to https://your-domain/webhook/webex. Set a webhook secret for signature verification.

Add to .env:

WEBEX_BOT_TOKEN=your-bot-token
WEBEX_WEBHOOK_SECRET=your-webhook-secret

The skill copies the Webex adapter from the channels branch, installs @bitbasti/chat-adapter-webex, and rebuilds.

What you get

Spaces — Webex’s group conversations. The bot responds when added or @-mentioned.
1:1 DMs — direct messages with the bot.
Threaded replies — Webex threads are native and the bot stays in-thread.
Webhook signature verification to reject forged events.

Tips

Find a space ID by opening the space and clicking the name → Settings, or by calling GET /rooms from the Webex API.
Same agent group is fine for spaces where you’re the primary user. Use a separate agent group for team spaces or sensitive contexts.
The webhook URL must be publicly reachable. For local dev, expose port 3000 with ngrok http 3000.