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

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

Error Handling

Scripts