文档首页 / 用户中心设置 / KOOK 机器人推送教程

KOOK 机器人推送教程

2026-10-13 …

KOOK(原开黑啦)是国内直连的中文语音/社群 App,与游戏、二次元、兴趣社群受众重合度高。它的机器人接口是标准 REST API,Token 直接放在请求头即可发消息,配置非常简单。这个能干什么:把线报推到 KOOK 服务器里的指定频道。需要什么:KOOK 账号、机器人 Bot Token、目标频道 ID,以及把机器人邀请进服务器的权限。

第一步:创建机器人并拿 Token

  1. 打开 developer.kookapp.cn(KOOK 开发者中心),用 KOOK 账号登录;
  2. 「创建应用」→ 填名称与简介;
  3. 进入应用的「机器人」页,点击「开启」,然后复制 Bot Token。

第二步:把机器人邀请进服务器

  1. 在开发者中心同一页找到「邀请链接」(或机器人卡片上的「添加到服务器」);
  2. 打开链接,选择你的服务器,把机器人拉进去;
  3. 确认机器人在目标频道有发言权限(频道权限设置里勾选)。

第三步:拿到频道 ID

  1. 在 KOOK 里进入目标频道,右键频道名 → 「复制频道 ID」(有的客户端需先在设置里开启「开发者模式」);
  2. 如果只拿到消息链接,形如 https://kookapp.cn/channels/服务器ID/频道ID/消息ID,取中间那一段频道 ID——不是最后一段消息 ID。

第四步:本站填写

  1. 推送渠道 → 「新增推送渠道」→ 类型选「KOOK 机器人」;
  2. 填入 Bot Token 与频道 ID;
  3. 保存 → 「发送测试」→ 频道里收到消息即成功。
字段必填说明
Bot Token✅KOOK 开发者中心 → 机器人 → Token
频道 ID✅频道名右键「复制频道 ID」;多个用 # 分隔

推送方式:云端与设备托管都可以

与 QQ 频道机器人一样,KOOK 也属于「Token 直接进请求头」的零步鉴权渠道,云端与设备托管两种模式任选:云端走每日额度(注册会员 10 条/天、VIP 100 条/天,可叠签到积分),设备托管不占云端额度、不扣积分(需保持浏览器扩展的推送开关打开;注册会员每渠道 300 条/天,VIP 不限量)。

消息格式说明

本站用 KOOK 的 KMarkdown 格式发送,正文里的原文链接是可点击的。若你的规则里自定义了推送格式,注意 KMarkdown 的语法与普通 Markdown 略有差异。

常见问题

返回 40100 / 40101?

Token 无效或机器人权限不足。请在开发者中心确认机器人已「开启」,并重新复制 Token。

机器人进了服务器但发不出消息?

多半是频道权限问题:在 KOOK 频道设置 → 权限 → 找到该机器人,勾选「发送消息」。

能同时推到多个频道吗?

可以,频道 ID 用 # 分隔即可(如 123456#789012)。

最近更新

  • 2026-10:新增 KOOK 机器人渠道(零步鉴权,云端 / 设备托管双模式)。