怎么把它装起来

去 q.qq.com 建一个机器人，在「开发设置」里抄下三样东西：AppID、Token、AppSecret。填到客户端「QQ」页对应的三个框里，保存后重启一次 NoneBot（页面上有按钮）。

沙箱环境下只有你加进「测试成员」的 QQ 号能用它，别人 @ 它没反应是正常的。要对外用就得提交审核走正式环境，这一步平台会看你的机器人做什么、有没有 AIGC 资质。

默认它只收得到「被 @ 」的消息。想让它看到群里所有聊天（能自己判断要不要接话、能记上下文），要去 q.qq.com 打开「接收所有消息」。开完回到客户端「QQ」页看状态卡上的「群消息」那一行：显示全量模式才算成功，还写着「仅 @ 消息」就是没生效（保存后要重启一次机器人）。

在群里 @ 它一次，它会回。之后默认 30 秒内不用再 @，接着说它就接着答；超过 30 秒或连着几句没提它，就自动断开，下次要重新 @。这个时间可以在插件商店的「连续对话能力包」里改（30 秒 ~ 5 分钟），也能改成「每条都让 AI 看一眼要不要接」或者干脆关掉。

① 机器人主动发消息有条数和时间窗限制，私聊、群聊各不相同，所以"定时喊我起床"这类在官方通道上不一定发得出去；② 官方会对机器人发的内容做审核，被拦下时消息就发不出去；③ 群里只有 @ 它、或者你开了「接收所有消息」之后，它才看得到内容。

客户端「QQ」页有一颗「官方通道体检」按钮：凭证、环境（沙箱/正式）、机器人进程、平台连接、群消息模式、AI 开关逐条给结论。哪一条是 ✗ 就按它下面写的那句人话去处理。

客户端、微信通道、Linux 无头端和全部插件都开源免费（Apache-2.0），没有要付费才能开的功能。要花钱的只有两处：模型 API 的账付给模型服务商；你不想自己折腾，让我做微信通道接入、部署和维护，这项按次报价。

存在你自己的机器上。装在哪台机器，数据就在哪台机器的安装目录里，可以看、可以改、可以整包导出换机器。我这边收不到你的聊天内容。手机上的星聊 App 同理，记忆只在手机里。

插件跑在沙箱里，这些做不到：装第三方库、开长连接（WebSocket、MQTT、直连数据库都不行）、常驻后台进程、随便读写文件、执行系统命令。想做这些事只能改主程序，改主程序要自己编译一份。

联网请求由主程序代发：只允许公网 http / https，单次请求 20 秒内必须返回，返回内容不超过 2 万字。内网地址（127.0.0.1、192.168.x.x 这类）不行。所以想写个采集大任务、长时间轮询的插件，做不了。

单次工具调用的总时长上限是 15 秒，超了就被掐断。所以插件里别写耗时长的循环或者串行请求一串接口的逻辑，要做就拆成多次调用。

能，但只能在 30 分钟内主动发。这是微信通道本身的限制，不是软件抠门。所以"每天定时喊我起床""隔两小时提醒一次"这类需求，得做成站内定时任务，不能指望它随时戳你。

能。装「群管理能力包」即可：禁言、全员禁言、撤回，走 QQ 官方接口，上限 30 天。入群欢迎、关键词回复目前没有现成包。

因为机器人跑在你自己机器上，不是跑在我服务器上。电脑关机、软件退出，机器人就不在线了。想 24 小时在线，用 Linux 无头端挂在服务器上，或者拿一台不关机的机器专门跑。

去模型服务商官网注册，在控制台里生成一个 Key，复制粘贴到星巢里。便宜不便宜看你聊多少，国内几家都有按量计费的便宜模型，先用小模型试手感，觉得不够聪明再换。本地模型也支持，只要能提供接口地址。

先把报错截图，然后告诉我三件事：系统版本、装的是哪个包、报错前一步做了什么。发邮箱 liguangxu17@163.com，或者进 QQ 群 768272849 问。我这边能复现的问题，一般当天给答复。