Misskey API

向Misskey/Fediverse实例发布帖子和上传图片。

配置

设置环境变量或创建配置文件：

bash

Misskey实例URL

export MISSKEY_HOST=https://your-instance.misskey.io

API令牌（从设置 > API获取）

export MISSKEY_TOKEN=your-token-here

获取令牌：

1. 1. 登录您的Misskey实例
2. 前往设置 > API > 访问令牌
3. 使用所需权限创建新令牌

热门Misskey实例

实例	URL	描述
maid.lat	https://maid.lat	メイド情報局 - 面向女仆爱好者的Misskey实例
misskey.io

https://misskey.io | 官方Misskey实例 | | misskey.design | https://misskey.design | 面向设计师 |

发布

发送文本

bash
MISSKEYHOST=https://maid.lat MISSKEYTOKEN=xxx \
bash ~/.openclaw/workspace/skills/misskey/scripts/post.sh 你好，Fediverse！

发送带图片

bash
MISSKEYHOST=https://maid.lat MISSKEYTOKEN=xxx \
bash ~/.openclaw/workspace/skills/misskey/scripts/post.sh 图片说明 /path/to/image.png

发送多张图片

bash
MISSKEYHOST=https://maid.lat MISSKEYTOKEN=xxx \
bash ~/.openclaw/workspace/skills/misskey/scripts/post.sh 多张图片 /path/to/img1.png /path/to/img2.png

上传图片

单独上传图片到云端硬盘：

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

可见性选项

在文本后添加可见性参数：

bash

公开（默认）

bash post.sh 内容 --visibility public

仅首页时间线

bash post.sh 内容 --visibility home

仅关注者

bash post.sh 内容 --visibility followers

指定用户

bash post.sh 内容 --visibility specified --visible-user-ids 用户ID

内容警告（CW）

bash
bash post.sh 隐藏内容 --cw 内容警告标题

删除笔记

bash
MISSKEYHOST=https://maid.lat MISSKEYTOKEN=xxx \
bash ~/.openclaw/workspace/skills/misskey/scripts/delete.sh 笔记ID

从URL获取笔记ID：https://maid.lat/notes/ak4lrcfalen102bc → ID为ak4lrcfalen102bc

API端点

端点	方法	描述
/api/notes/create	POST	创建笔记
/api/notes/delete

POST | 删除笔记 | | /api/drive/files/create | POST | 上传文件 | | /api/i | POST | 获取当前用户信息 |

错误处理

状态码	含义
401	令牌无效或已过期
400

参数无效 | | 429 | 请求频率受限 |

脚本

脚本	描述
post.sh	创建笔记，可选附带图片
delete.sh

按ID删除笔记 | | upload.sh | 上传文件到云端硬盘 | | whoami.sh | 显示当前用户信息 |