快速开始💻#

本节及后续文档默认您有独立搭建过 Nonebot 服务的相关经验。

建议环境：

• 安装好 nb-cli 环境的 Python 3.10 及以上 Python 版本

如果您计划在本地与大语言模型交互，我们强烈建议您创建一个虚拟环境。

安装插件⚙️#

由于此插件还在开发早期，因此请通过 git clone 等方式安装插件：

git clone https://github.com/Moemu/MuiceBot

然后安装依赖：

如果只使用在线模型服务，请执行：

pip install .
pip install nonebot2[fastapi]

如果想同时使用本地运行的模型服务，请执行：

pip install .[local]
pip install nonebot2[fastapi]

如果想为本项目做出贡献，请执行：

pip install .[local,dev]
pip install nonebot2[fastapi]

这将安装 pre-commit 和其他必须项用于代码检查

适配器配置🔧#

如一切顺利，我们可以开始 Nonebot 适配器的配置：

在项目中创建 .env 文件并写入：

DRIVER=~fastapi+~websockets+~httpx

这只是 NoneBot 运行的必需项，接下来我们将配置适配器。

如果你使用 OneBot 适配器，则无需另行配置，在平台实现中配置连接即可。除非你想配置访问权限 。

如果你使用 Telegram 适配器，请写入 Bot 密钥，如需要，也可写入代理配置：

telegram_bots = [{"token": "1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHI"}]
telegram_proxy = "http://127.0.0.1:10809"

如果你使用 QQ 适配器，请参考文档示例填写信息。下面给出了私域频道机器人（审核未通过沙盒版）的示例配置：

QQ_IS_SANDBOX=true
QQ_BOTS='[{"id": "11451419", "token": "KFCvivo50MuxueYYDS", "secret": "GiveAStarToMuice5Q", "intent": {"guild_messages": true,"at_messages": true}, "use_websocket": true}]'

响应昵称配置🧸#

正常情况下，MuiceBot 只会处理 at_event 事件或者是指令事件，对于某些客户端来说 @bot 的操作还是太麻烦了，有没有更加简单的方法？

有的兄弟，有的。我们可以定义一个响应前缀来让沐雪响应消息事件。

在 .env 文件中配置：

MUICE_NICKNAMES=["沐雪", "muice", "雪"]

这将响应前缀为“沐雪”、“muice”、“雪”的消息事件，且无需在响应前缀后面加入空格分隔符，比如下列的消息将被沐雪响应：

雪，我只会对你动心你知道吗

唔...真的嘛？（脸红）

超级用户#

超级用户可以执行例如 .load 之类改变机器人运行方式的指令，在配置文件中设置用户ID可以将其设为超级用户：

SUPERUSERS=["123456789"]

至此，NoneBot 的本身的配置部分到此结束