Skip to main content

​
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

SetupURL formatNotes
Same machinehttp://localhost:8091No TLS needed
Local networkhttp://192.168.1.50:8091Use IP or local DNS
Tailscalehttps://chat.your-tailnetBoth hosts on Tailscale
Public domainhttps://chat.example.comNeeds valid TLS cert

​
Troubleshooting

NanoClaw only responds when @mentioned. Make sure you’re tagging the bot’s username in your message.
Tokens have the format BOT_ID.SECRET — ensure you copied the full value. Regenerate if needed: meepachat bots regenerate-token BOT_ID.
Verify the MeepaChat URL is reachable: curl https://your-instance.meepachat.ai/api/health