NoneBot Plugin Alconna

✨ Alconna Usage For NoneBot2 ✨

✨ All Receive in One, And One Send All ✨

python

该插件提供了 Alconna 的 NoneBot2 适配版本与工具

特性

完整的 Alconna 特性支持
自动回复命令帮助信息选项
跨平台的接收与发送消息(被动+主动)
对22种适配器的收发消息支持
比 got-reject 更强大的补全会话机制
多种内置插件 (echo，help，lang)
i18n 支持

讨论

QQ 交流群: 链接

使用方法

NoneBot 文档: 📖这里仓库内介绍: 📦这里

跨平台消息

from nonebot import get_driver
from nonebot_plugin_alconna import Target, UniMessage, SupportScope, on_alconna, message_recall

driver = get_driver()
test = on_alconna("test")

@test.handle()
async def handle_test():
    r = await UniMessage.image(path="path/to/img").send()
    if r.recallable:
        await r.reply("图片已发送，10秒后撤回")
        await r.recall(delay=10, index=0)

@test.got("foo", prompt=UniMessage.template("{:Reply($message_id)}请输入图片"))
async def handle_foo():
    await test.send("图片已收到, 即将撤回")
    await message_recall()

@driver.on_startup
async def _():
    await Target.group("123456789", SupportScope.qq_client).send(UniMessage.image(path="test.png"))

支持情况

支持的适配器

协议名称	路径
OneBot 协议	adapters.onebot11, adapters.onebot12
Telegram	adapters.telegram
飞书	adapters.feishu
GitHub	adapters.github
QQ bot	adapters.qq
钉钉	adapters.ding
Console	adapters.console
开黑啦	adapters.kook
Mirai	adapters.mirai
Ntchat	adapters.ntchat
MineCraft	adapters.minecraft
Walle-Q	adapters.onebot12
Discord	adapters.discord
Red 协议	adapters.red
Satori	adapters.satori
Dodo IM	adapters.dodo
Kritor	adapters.kritor
Tailchat	adapters.tailchat
Mail	adapters.mail
微信公众号	adapters.wxmp
黑盒语音	adapters.heybox
Milky	adapters.milky
EFChat	adapters.efchat
B站直播间	adapters.bililive
云湖	adapters.yunhu
VoceChat	adapters.vocechat

支持的消息元素

✅: 支持(接收和发送)
⬇️: 支持接收
⬆️: 支持发送
➖: 情况不存在
❌: 插件/适配器未支持
🚫: 协议未支持
(🚧): 计划中或部分支持或为实验性支持

元素\适配器	OneBot V11	OneBot V12	Telegram	飞书	Github	QQ-API	⚠️钉钉	Console	开黑啦	⚠️Mirai	⚠️Ntchat	Minecraft	Discord	⚠️Red	Satori	Dodo IM	⚠️Kritor	Tailchat	Mail	微信公众号	黑盒语音	Milky	EFChat	B站直播间	云湖	VoceChat
文本 Text	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
样式文本 Styled Text	🚫	🚫	✅	❌	✅	✅	❌	✅	✅	🚫	🚫	✅	🚫	🚫	✅	🚫	🚫	✅	✅	🚫	🚫	🚫	❌	🚫	✅	✅
提及用户 At(user)	✅	✅	✅	✅	⬆️	✅	✅	🚫	✅	✅	❌	🚫	✅	✅	✅	✅	✅	✅	⬆️	🚫	⬆️	✅	✅	✅	✅	✅
提及角色 At(role)	🚫	🚫	🚫	🚫	🚫	🚫	🚫	🚫	✅	🚫	🚫	🚫	✅	🚫	✅	✅	🚫	🚫	🚫	🚫	🚫	🚫	🚫	🚫	🚫	🚫
提及频道 At(channel)	🚫	🚫	🚫	🚫	🚫	✅	🚫	🚫	✅	🚫	🚫	🚫	✅	🚫	✅	✅	🚫	✅	⬆️	🚫	🚫	🚫	🚫	🚫	🚫	🚫
提及全体 AtAll	✅	✅	🚫	✅	🚫	✅	✅	🚫	✅	✅	🚫	🚫	✅	✅	✅	✅	✅	🚫	🚫	🚫	🚫	✅	🚫	🚫	🚫	🚫
表情 Emoji	✅	🚫	✅	🚫	🚫	✅	🚫	✅	✅	✅	🚫	🚫	✅	✅	✅	🚫	✅	✅	🚫	✅	🚫	✅	🚫	✅	✅	🚫
图片 Image	✅	✅	✅	✅	⬆️	✅	✅	🚫	✅	✅	✅	❌	✅	✅	✅	✅	✅	✅	✅	✅	⬆️	✅	✅	🚫	✅	✅
音频 Audio	⬆️	✅	✅	✅	🚫	✅	🚫	🚫	✅	⬆️	⬇️	🚫	⬆️	⬆️	✅	🚫	⬆️	🚫	✅	✅	🚫	⬆️	⬆️	🚫	⬇️	✅
语音 Voice	✅	✅	✅	⬆️	🚫	⬆️	🚫	🚫	⬆️	✅	⬇️	🚫	⬆️	✅	⬆️	🚫	✅	🚫	✅	✅	🚫	✅	✅	🚫	🚫	⬆️
视频 Video	✅	✅	✅	✅	🚫	✅	🚫	🚫	✅	✅	✅	🚫	⬆️	✅	✅	✅	✅	🚫	✅	✅	🚫	✅	🚫	🚫	✅	✅
文件 File	⬇️,⬆️(🚧)	✅	✅	✅	🚫	✅	🚫	🚫	✅	✅	✅	🚫	⬆️	✅	✅	⬇️	⬇️	✅	✅	🚫	🚫	⬆️	🚫	🚫	✅	✅
回复 Reply	✅	✅	✅	✅	🚫	✅	🚫	🚫	✅	✅	✅	🚫	✅	✅	✅	✅	✅	✅	✅	🚫	⬆️	✅	⬆️	⬆️	✅	✅
引用转发 Reference	✅	🚫	🚫	❌	🚫	🚫	🚫	🚫	🚫	✅	🚫	🚫	🚫	✅	✅	🚫	✅	🚫	🚫	🚫	🚫	✅	🚫	🚫	🚫	🚫
超级消息 Hyper	✅	🚫	🚫	⬇️	🚫	✅	🚫	🚫	✅	✅	✅	🚫	🚫	✅	🚫	🚫	✅	🚫	🚫	✅	🚫	⬇️	🚫	🚫	❌	🚫
按钮 Button	🚫	🚫	⬆️	🚫	🚫	✅	🚫	🚫	🚫	🚫	🚫	⬆️	✅	🚫	✅	🚫	✅	🚫	🚫	🚫	🚫	🚫	🚫	🚫	✅	🚫
其余 Other	✅	✅	✅	✅	➖	✅	✅	➖	✅	✅	✅	➖	✅	✅	✅	✅	✅	✅	➖	✅	➖	✅	➖	➖	❌	➖

支持的消息操作

✅: 支持
❌: 插件/适配器未支持
🚫: 协议未支持
(🚧): 计划中或部分支持或为实验性支持

操作\适配器	OneBot V11	OneBot V12	Telegram	飞书	Github	QQ-API	⚠️钉钉	Console	开黑啦	⚠️Mirai	⚠️Ntchat	Minecraft	Discord	⚠️Red	Satori	Dodo IM	⚠️Kritor	Tailchat	Mail	微信公众号	黑盒语音	Milky	EFChat	B站直播间	云湖	VoceChat
发送 Send	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
撤回 Recall	✅	✅	✅	✅	❌	✅	❌	🚫	✅	✅	❌	🚫	✅	✅	✅	✅	✅	✅	🚫	🚫	🚫	✅	🚫	🚫	✅	✅
编辑 Edit	🚫	🚫	✅	✅	❌	🚫	❌	🚫	✅	🚫	🚫	🚫	✅	🚫	✅	✅	🚫	🚫	❌	🚫	🚫	🚫	🚫	🚫	✅	✅
表情响应 Reaction	✅(🚧)	🚫	✅	✅	❌	✅	🚫	🚫	✅	🚫	🚫	🚫	✅	🚫	✅	✅	✅	❌	🚫	🚫	🚫	✅	🚫	🚫	🚫	🚫

配置项

ALCONNA_AUTO_SEND_OUTPUT : 是否全局启用输出信息自动发送
ALCONNA_USE_COMMAND_START : 是否将 COMMAND_START 作为全局命令前缀
ALCONNA_GLOBAL_COMPLETION: 全局的补全会话配置 (不代表全局启用补全会话)
ALCONNA_USE_ORIGIN: 是否全局使用原始消息 (即未经过 to_me 等处理的)
ALCONNA_USE_PARAM: 是否使用特制的 Param 提供更好的依赖注入
ALCONNA_USE_CMD_SEP: 是否将 COMMAND_SEP 作为全局命令分隔符
ALCONNA_GLOBAL_EXTENSIONS: 全局加载的扩展, 路径以 . 分隔, 如 foo.bar.baz:DemoExtension
ALCONNA_CONTEXT_STYLE: 全局命令上下文插值的风格，None 为关闭，bracket 为 {...}，parentheses 为 $(...)
ALCONNA_ENABLE_SAA_PATCH: 是否启用 SAA 补丁
ALCONNA_APPLY_FILEHOST: 是否启用文件托管
ALCONNA_APPLY_FETCH_TARGETS: 是否启动时拉取一次发送对象列表
ALCONNA_BUILTIN_PLUGINS: 需要加载的alc内置插件集合
ALCONNA_CONFLICT_RESOLVER: 命令冲突解决策略，default 为保留两个命令，raise 为抛出异常，ignore 为忽略新命令，replace 为替换旧命令
ALCONNA_RESPONSE_SELF: 是否允许响应自己的消息
ALCONNA_CACHE_MESSAGE: 是否缓存消息

插件示例

demo bot

# echo 插件
from nonebot_plugin_alconna import UniMessage, Command

@Command("echo <...content>").build(auto_send_output=True).handle()
async def _(content: UniMessage):
    await content.finish()

Release files for nonebot-plugin-alconna 0.62.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nonebot-plugin-alconna 0.62.1
File	Size	Uploaded
nonebot_plugin_alconna-0.62.1.tar.gz	163.5 kB	Jul 10, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for nonebot-plugin-alconna 0.62.1
File	Interpreter	ABI	Platform	Reset
nonebot_plugin_alconna-0.62.1-py3-none-any.whl 226.1 kB Jul 10, 2026	Python 3	none	any	Details

Total release size: 389.6 kB

Release files / nonebot_plugin_alconna-0.62.1.tar.gz

Download URL	nonebot_plugin_alconna-0.62.1.tar.gz
Size	163.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`09d57f94a2d391dbd0f4231ff3de22d616cf24085ce889cb4c03fd173a29fb2a`
BLAKE2b-256 checksum How to use checksums	`bdc31698155ff82f35d4a58dec00ba56beb68f83cc726de4769e56faff0db7e6`
Upload date	Jul 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`pdm/2.28.0 CPython/3.12.3 Linux/6.17.0-1018-azure`

Release files / nonebot_plugin_alconna-0.62.1-py3-none-any.whl

Download URL	nonebot_plugin_alconna-0.62.1-py3-none-any.whl
Size	226.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`5258eb215e778e5bb8e85aa3932752f91b7c8721e03a590e0d8f307d078b8e27`
BLAKE2b-256 checksum How to use checksums	`e7dda4da18c97246d7c66e5c7dda53a1c01abbebb0fa140ec486799c173f0cc9`
Upload date	Jul 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`pdm/2.28.0 CPython/3.12.3 Linux/6.17.0-1018-azure`