Publora Mastodon OpenClaw Plugin & Skill | ClawHub
Looking to integrate Publora Mastodon into your AI workflows? This free OpenClaw plugin from ClawHub helps you automate productivity & tasks tasks instantly, without having to write custom tools from scratch.
What this skill does
Post or schedule content to Mastodon using the Publora API. Use this skill when the user wants to publish or schedule Mastodon posts via Publora.
Install
openclaw skills install @sergebulaev/publora-mastodonnpx clawhub@latest install publora-mastodonFull SKILL.md
Open original| name | description |
|---|---|
| publora-mastodon | Post or schedule content to Mastodon using the Publora API. Use this skill when the user wants to publish or schedule Mastodon posts via Publora. |
SKILL.md content below is scrollable.
Publora — Mastodon
Mastodon / Fediverse platform skill for the Publora API. For auth, core scheduling, media upload, and workspace/webhook docs, see the publora core skill.
Base URL: https://api.publora.com/api/v1
Header: x-publora-key: sk_YOUR_KEY
Platform ID format: mastodon-{accountId}
Note: Publora currently posts to the mastodon.social instance. Other instances are not supported at this time.
Platform Limits (API)
| Property | Limit | Notes |
|---|---|---|
| Text (toot) | 500 characters | Instance-configurable; some allow 5,000+ |
| Images | Up to 4 × 16 MB | JPEG, PNG, GIF, WebP |
| Video | ~99 MB | MP4, MOV, WebM; no duration limit, capped by size |
| Text only | ✅ Yes | — |
| Rate limit | 30 media uploads/30 min | 300 requests/5 min per account |
Post a Toot (text)
await fetch('https://api.publora.com/api/v1/create-post', {
method: 'POST',
headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
body: JSON.stringify({
content: 'Hello Fediverse! Building open, decentralized tools for everyone. #fediverse #opensource',
platforms: ['mastodon-123456789']
})
});
Schedule a Toot
body: JSON.stringify({
content: 'Your Mastodon post here',
platforms: ['mastodon-123456789'],
scheduledTime: '2026-03-20T10:00:00.000Z'
})
Post with Image
import requests
HEADERS = { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' }
# Step 1: Create post
post = requests.post('https://api.publora.com/api/v1/create-post', headers=HEADERS, json={
'content': 'Here is a photo from our event 📷 #community',
'platforms': ['mastodon-123456789']
}).json()
# Step 2: Get upload URL (up to 16 MB, JPEG/PNG/GIF/WebP)
upload = requests.post('https://api.publora.com/api/v1/get-upload-url', headers=HEADERS, json={
'postGroupId': post['postGroupId'],
'fileName': 'photo.jpg',
'contentType': 'image/jpeg',
'type': 'image'
}).json()
# Step 3: Upload
with open('photo.jpg', 'rb') as f:
requests.put(upload['uploadUrl'], headers={'Content-Type': 'image/jpeg'}, data=f)
Platform Quirks
- mastodon.social only — Publora currently supports this instance
- Generous image limit: 16 MB per image, much more than most platforms
- Video capped by size (~99 MB default) — no explicit duration limit
- WebP supported — unlike Instagram, Mastodon accepts WebP natively
- Federation: Posts federate automatically to the broader Fediverse
- Hashtags: Important for discoverability on Mastodon — use them in posts
- Content warnings: Not directly supported via Publora API yet; use text conventions if needed