🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Misskey
πŸ¦€ ClawHub

Misskey

by @kasuganosora

Misskey API integration for posting notes and uploading media to Misskey/Fediverse instances. Use when users want to post to Misskey, upload images, or inter...

Versionv1.0.2
Downloads561
#clawhub
TERMINAL
clawhub install misskey

πŸ“– About This Skill

name: misskey description: | Misskey API integration for posting notes and uploading media to Misskey/Fediverse instances. Use when users want to post to Misskey, upload images, or interact with Fediverse. Triggers: "post to misskey", "misskey upload", "fediverse post", "misskey note". metadata: version: "1.0.1"

Misskey API

Post notes and upload images to Misskey/Fediverse instances.

Configuration

Set environment variables or create a config file:

# Misskey instance URL
export MISSKEY_HOST="https://your-instance.misskey.io"

API Token (get from Settings > API)

export MISSKEY_TOKEN="your-token-here"

Getting a Token: 1. Login to your Misskey instance 2. Go to Settings > API > Access Tokens 3. Create a new token with required permissions

Popular Misskey Instances

| Instance | URL | Description | |----------|-----|-------------| | maid.lat | https://maid.lat | パむド情報局 - A Misskey instance for maid lovers | | misskey.io | https://misskey.io | Official Misskey instance | | misskey.design | https://misskey.design | For designers |

Posting

Send Text

MISSKEY_HOST="https://maid.lat" MISSKEY_TOKEN="xxx" \
  bash ~/.openclaw/workspace/skills/misskey/scripts/post.sh "Hello, Fediverse!"

Send with Image

MISSKEY_HOST="https://maid.lat" MISSKEY_TOKEN="xxx" \
  bash ~/.openclaw/workspace/skills/misskey/scripts/post.sh "Image caption" "/path/to/image.png"

Send Multiple Images

MISSKEY_HOST="https://maid.lat" MISSKEY_TOKEN="xxx" \
  bash ~/.openclaw/workspace/skills/misskey/scripts/post.sh "Multiple images" "/path/to/img1.png" "/path/to/img2.png"

Upload Image

Upload image to drive separately:

MISSKEY_HOST="https://maid.lat" MISSKEY_TOKEN="xxx" \
  bash ~/.openclaw/workspace/skills/misskey/scripts/upload.sh "/path/to/image.png"

Visibility Options

Add visibility parameter after text:

# Public (default)
bash post.sh "Content" --visibility public
Home timeline only

bash post.sh "Content" --visibility home
Followers only

bash post.sh "Content" --visibility followers
Specified users

bash post.sh "Content" --visibility specified --visible-user-ids "user-id"

Content Warning (CW)

bash post.sh "Hidden content" --cw "Content warning title"

Delete Note

MISSKEY_HOST="https://maid.lat" MISSKEY_TOKEN="xxx" \
  bash ~/.openclaw/workspace/skills/misskey/scripts/delete.sh "note-id"

Get note ID from URL: https://maid.lat/notes/ak4lrcfalen102bc β†’ ID is ak4lrcfalen102bc

API Endpoints

| Endpoint | Method | Description | |----------|--------|-------------| | /api/notes/create | POST | Create note | | /api/notes/delete | POST | Delete note | | /api/drive/files/create | POST | Upload file | | /api/i | POST | Get current user info |

Error Handling

| Status | Meaning | |--------|---------| | 401 | Invalid or expired token | | 400 | Invalid parameters | | 429 | Rate limited |

Scripts

| Script | Description | |--------|-------------| | post.sh | Create notes with optional images | | delete.sh | Delete notes by ID | | upload.sh | Upload files to drive | | whoami.sh | Display current user info |

βš™οΈ Configuration

Set environment variables or create a config file:

# Misskey instance URL
export MISSKEY_HOST="https://your-instance.misskey.io"

API Token (get from Settings > API)

export MISSKEY_TOKEN="your-token-here"

Getting a Token: 1. Login to your Misskey instance 2. Go to Settings > API > Access Tokens 3. Create a new token with required permissions