zh platform misskey
Warning
- 我们建议您在非您参与管理的 Misskey 实例上部署 Bot 前请先查看实例规则或征求实例管理组或检察组的同意，并在部署后为机器人账号开启
Bot标识。 - 本项目严禁用于任何违反法律法规的用途。若您意图将 AstrBot 应用于非法产业或活动，我们明确反对并拒绝您使用本项目。
进入消息平台，点击新增适配器，找到 Misskey 并单击进入 Misskey 配置页。
在 AstrBot Misskey 的平台适配器配置页，我们需要填写 Misskey 的接入信息和配置适配器的部分行为。
::: tip 注意
别忘了退出保存前先点击启用以启用 Misskey 平台配置器！
:::
获取 Misskey 接入信息的方式见下文介绍。
就是你的 Bot 所处账号的 Misskey 实例前端地址，格式为标准域名。例如https://misskey.example。
- 首先打开 Misskey Web 前端页面，在前端页面侧边栏找到并打开
设置 > 连接服务页面。
- 单击“生成访问令牌”以生成账号接入访问令牌。
-
在弹出的访问令牌配置页面，我们为令牌起一个名字，比如
AstrBot。 -
然后我们需要为令牌配置相关权限让 Bot 能够与 Misskey 实例交互。
::: tip 注意 如果你使用的 AstrBot 第三方插件需要额外权限，请参考其文档增加相应权限。若你完全信任 Bot 的部署环境，也可以临时开启全部权限以简化调试，但仍建议您在生产环境使用时限制 Bot 的相关权限。 :::
默认需要开启的权限
| 权限名称 | 说明 | 用途 |
|---|---|---|
| 读取账户信息 | 查看账户的基本信息 | 获取 Bot 自身的用户信息和账号 ID |
| 撰写或删除帖子 | 创建、编辑和删除笔记内容 | 发送消息回复和发布内容 |
| 撰写或删除消息 | 创建、编辑和删除私信内容 | 处理私信对话 |
| 查看通知 | 接收系统通知和提醒 | 获取提及、回复等通知信息 |
| 查看消息 | 读取私信和聊天记录 | 接收和处理用户私信 |
| 查看回应 | 查看帖子的回复和反应 | 处理用户对 Bot 消息的回应 |
- 权限配置完成后，单击“完成”以查看账号访问令牌。把获取到的令牌复制并粘贴到 AstrBot 配置页面 Access Token 输入框内。
修改机器人发帖时的默认可见性
| 名称 | 说明 |
|---|---|
| public | 任何人都可以看到 Bot 的帖文 |
| home | 公开 Bot 帖文于实例主页时间线 |
| followers | 只有关注了 Bot 账号的用户才能在主页时间线看到 Bot 帖文 |
开启后，Bot 发送的所有帖文都不会参与 Fediverse 联合，非常适用于仅想在自己实例使用和传播 Bot 的帖子的需求。
::: tip 注意 Misskey 的“聊天”组件特性并不受所有 Misskey Fork 版本支持！无法跨实例互联。
Misskey 在v2025.4.0及以后的版本中为加入“聊天”组件支持，且仅受其 Web 前端支持，并未受到第三方 App 良好的支持。
:::
默认开启，开启后 Bot 会响应 Misskey 聊天内用户发送的私聊内容并进行回复。
聊天和贴文单个用户的对话历史在 AstrBot 的 WebUI 控制台“对话历史”会以chat:UserID的 id 记录，传统贴文则是以note:UserID的 id 记录。
::: tip Misskey 用户的 UserID 在哪里？
位于用户个人页面部分的Raw页面内可以查询，UserID 是单个实例中 Misskey 用户唯一的关键身份标识。
:::
配置完成并启用后，前往 Misskey 新建帖文并在发送中引用 Bot （@mention）测试效果。如果 Bot 账号能够成功触发回复，说明配置成功。
我们建议您为 Bot 账号开启 Misskey Bot 标识以尊重 Misskey 各实例的相关规定和速率限制等，也能有效帮助 Misskey 实例管理员管理和识别 Bot 的使用情况。
开启方式
在 Bot 账号个人资料页面的高级设置中开启“这是一个机器人账号”即可。
