DeepSeek Harness Hub
← 返回列表

OneBot 适配器koishijs/koishi-plugin-adapter-onebot

Cordisspec-screenednotify在 GitHub 查看 ↗
✓ 可直接安装

让 Koishi 机器人接入 QQ 等 OneBot 实现收发消息

自动检查通过:npm 包已发布且 engines 声明满足基线;该结论来自程序自动检查,未经人工实机验证。 · 最近上游提交 2026/6/5 · 已提供中文文档

OneBot 适配器

综合分
47.2
GitHub 分
47.2
用户评分
★ Stars
51
周下载量
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add koishi-plugin-adapter-onebot
npm 包 koishi-plugin-adapter-onebot 已校验归属本仓库,走 npm 安装最省事
🟢实装验证通过· 2026/9/19
由 dsh-plugin-verify(GitHub Actions)在真实 dsh 环境安装成功,非静态推断。
数据截至 2026/9/3(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查✓ 自动检查通过

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

npm 包koishi-plugin-adapter-onebot @ 6.9.4
Node 引擎未声明 engines.node
dsh CLI 依赖未声明 dsh 版本约束
入口文件main/exports/bin 已声明

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/18 14:29:54

用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

koishi-plugin-adapter-onebot

适用于 Koishi 的 OneBot 适配器。

OneBot 是一个聊天机器人应用接口标准。

配置项

config.protocol

- 可选值: http, ws, ws-reverse

要使用的协议类型。

config.token

- 类型:string

发送信息时用于验证的字段。

config.endpoint

- 类型:string

如果使用了 HTTP,则该配置将作为发送信息的服务端;如果使用了 WebSocket,则该配置将作为监听事件和发送信息的服务端。

config.proxyAgent

- 类型: string
- 默认值: app.config.request.proxyAgent

请求时默认使用的网络代理。

config.path

- 类型:string
- 默认值:'/onebot'

服务器监听的路径。仅用于 HTTP 或 WS Reverse 通信方式。

config.secret

- 类型:string

接收信息时用于验证的字段,应与 OneBot 的 secret 配置保持一致。

内部 API

你可以通过 bot.internal 或 session.onebot 访问内部 API,参见 访问内部接口。

OneBot v11 标准 API

- onebot.sendPrivateMsg()
- onebot.sendGroupMsg()
- onebot.deleteMsg()
- onebot.getMsg()
- onebot.getForwardMsg()
- onebot.sendLike()
- onebot.setGroupKick()
- onebot.setGroupBan()
- onebot.setGroupAnonymousBan()
- onebot.setGroupWholeBan()
- onebot.setGroupAdmin()
- onebot.setGroupAnonymous()
- onebot.setGroupCard()
- onebot.setGroupName()
- onebot.setGroupLeave()
- onebot.setGroupSpecialTitle()
- onebot.setFriendAddRequest()
- onebot.setGroupAddRequest()
- onebot.getLoginInfo()
- onebot.getStrangerInfo()
- onebot.getFriendList()
- onebot.getGroupInfo()
- onebot.getGroupList()
- onebot.getGroupMemberInfo()
- onebot.getGroupMemberList()
- onebot.getGroupHonorInfo()
- onebot.getCookies()
- onebot.getCsrfToken()
- onebot.getCredentials()
- onebot.getRecord()
- onebot.getImage()
- onebot.canSendImage()
- onebot.canSendRecord()
- onebot.getStatus()
- onebot.getVersionInfo()
- onebot.setRestart()
- onebot.cleanCache()

go-cqhttp 扩展 API

- onebot.sendGroupForwardMsg()
- onebot.markMsgAsRead()
- onebot.sendGroupSign()
- onebot.qidianGetAccountInfo()
- onebot.setQqProfile()
- onebot.getUnidirectionalFriendList()
- onebot.deleteFriend()
- onebot.setGroupPortrait()
- onebot.getWordSlices()
- onebot.ocrImage()
- onebot.getGroupSystemMsg()
- onebot.uploadPrivateFile()
- onebot.uploadGroupFile()
- onebot.getGroupFileSystemInfo()
- onebot.getGroupRootFiles()
- onebot.getGroupFilesByFolder()
- onebot.createGroupFileFolder()
- onebot.deleteGroupFolder()
- onebot.deleteGroupFile()
- onebot.getGroupFileUrl()
- onebot.getGroupAtAllRemain()
- onebot.getVipInfo()
- onebot.sendGroupNotice()
- onebot.getGroupNotice()
- onebot.reloadEventFilter()
- onebot.downloadFile()
- onebot.getOnlineClients()
- onebot.getGroupMsgHistory()
- onebot.setEssenceMsg()
- onebot.deleteEssenceMsg()
- onebot.getEssenceMsgList()
- onebot.checkUrlSafely()
- onebot.getModelShow()
- onebot.setModelShow()
- onebot.delete_unidirectional_friend()
- onebot.send_private_forward_msg()

频道 API

- onebot.getGuildServiceProfile()
- onebot.getGuildList()
- onebot.getGuildMetaByGuest()
- onebot.getGuildChannelList()
- onebot.getGuildMembers()
- onebot.sendGuildChannelMsg()

许可证

使用 MIT 许可证发布。

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
版权持有人对任何索赔、损害或其他责任概不负责,无论是在合同诉讼、侵权行为还是其他方面,由软件或软件的使用或其他交易引起、产生或与之相关。

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

同作者(koishijs)的其他插件

💬 加入 DPharness 群聊

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

点击加入 QQ 群
DPharness 群聊二维码,手机 QQ 扫码进群
扫码进群