NanoClaw

Connect NanoClaw to your MeepaChat instance

Overview

NanoClaw is a lightweight AI bot framework. The MeepaChat channel skill connects NanoClaw to the Bot Gateway WebSocket for real-time messaging in channels and DMs.

Big thanks to jinalex for building this skill and being one of MeepaChat’s earliest beta testers.

Step 1: Create a bot in MeepaChat

Go to Server Settings → Bots → Create Bot. Enter a username and display name, then click Create. Copy the bot token immediately — it’s only shown once.

Or use the CLI:

meepachat bots create --username nanoclaw --server <serverID>

Treat bot tokens like passwords. Never commit them to source control.

Step 2: Add the MeepaChat skill

Copy the skill into your NanoClaw project and apply it:

cp -r skills/nanoclaw-add-meepachat .claude/skills/add-meepachat
npx tsx scripts/apply-skill.ts .claude/skills/add-meepachat && npm run build

Step 3: Configure environment

Add to your .env:

MEEPACHAT_BOT_TOKEN=bot-uuid.secret-token
MEEPACHAT_BASE_URL=https://your-instance.meepachat.ai

Step 4: Start the bot

npm run dev

NanoClaw connects via WebSocket, discovers all channels in its servers, and responds to messages when @mentioned. Channel IDs are prefixed with mc: in data/registered_groups.json.

Typing Indicators

NanoClaw can send typing indicators over the WebSocket so users see the bot as “typing” while it generates a response. Send this message on the Bot Gateway connection:

{ "type": "typing", "data": { "channelId": "CHANNEL_ID" } }

The bot must be subscribed to the channel. See the Bot Gateway docs for details.

Self-hosted considerations

Setup	URL format	Notes
Same machine	http://localhost:8091	No TLS needed
Local network	http://192.168.1.50:8091	Use IP or local DNS
Tailscale	https://chat.your-tailnet	Both hosts on Tailscale
Public domain	https://chat.example.com	Needs valid TLS cert

Troubleshooting

Bot connects but doesn't respond

NanoClaw only responds when @mentioned. Make sure you’re tagging the bot’s username in your message.

Bot token invalid

Tokens have the format BOT_ID.SECRET — ensure you copied the full value. Regenerate if needed: meepachat bots regenerate-token BOT_ID.

Connection refused / timeout

Verify the MeepaChat URL is reachable: curl https://your-instance.meepachat.ai/api/health