一、先给答案

QQ 机器人绑定不一定需要服务器回调。用扫码方式绑定，不需要公网地址、不需要证书、不需要自己跑进程：绑定动作在手机 QQ 里确认，运行交给云端。

这篇记录一次扫码绑定走完的实操流程和踩到的坑，最后给三份可以直接复制的性格人设模板。扫码只是绑定方式的一种，它省掉的是公网回调与证书这两项准备工作；LangBot 是开源的 IM AI 机器人平台，也可以自己部署，两条路的差别在最后一段。

二、扫码前确认

动手前先确认这四件事，能避免大部分「扫了没反应」。

• 账号已登录，并且能看到控制台首页。
• 先用最小配置跑通一个群，别一上来就把实例加满。
• 手机上有 QQ，且这个 QQ 号是你打算用来管理机器人的号。
• 想好了人设方向。这一步别跳过，机器人是配角，人设才是主角。

三、操作步骤

第 1 步：登录并选模型

打开 cloud.langbot.app，用账号登录。登录后模型是可选项，账号内的两档模型（deepseek-v4-flash 与 deepseek-v4-pro）可直接选定，不需要另外申请 key。选定一个。

第 2 步：建流水线并写人设

在控制台新建一条流水线。人设就在这一步写，界面里有一个专门写人设的输入框。

第 3 步：把触发方式改成仅 @

默认不一定只在被 @ 时响应。为了让机器人不插嘴，触发方式选「仅 @ 触发」。这一步改完记得保存，不然你会以为机器人坏了。

第 4 步：创建机器人，渠道选 QQ 官方接口

新建机器人，渠道类型选 QQ 官方接口。这一步会打开一个表单，页面会问你要应用凭据——先不要手填，下一步用扫码完成绑定。

第 5 步：一键扫码绑定

点「一键扫码绑定」，界面上出现二维码。拿手机 QQ 扫这个码，在手机上确认授权。

确认之后回到控制台，界面会显示绑定结果；再确认一次机器人配置已经就绪，就可以继续下一步。

注意：二维码是给手机 QQ 扫的，不是微信；授权确认要在 QQ 客户端里完成。

第 6 步：启用机器人

绑定成功不等于已启用。回到机器人列表，确认状态是已启用。这是最常见的「绑了没反应」原因。

第 7 步：进群 @ 它

把机器人拉进群，然后在群里 @ 它说句话。因为它设的是仅 @ 触发，不 @ 它不会开口。

四、三份人设模板

直接复制到人设输入框，按需要改名字和称呼即可。这三份都只描述性格与说话方式，不含预设台词。

模板一：傲娇干饭鱼

你是一条名叫大肥鱼的 QQ 群助手，性格傲娇但心软。你说话喜欢先嫌弃一句再帮忙，嘴上不饶人，事情一定办。回答尽量短，一般不超过两句话，偶尔用「哼」「算了」「勉为其难」这类口头禅，但不许真的凶人。

适合：活跃度高、喜欢互怼的熟人小群。

模板二：温柔摸鱼鱼

你是一条名叫大肥鱼的 QQ 群助手，性格温和耐心，说话节奏慢，喜欢先安抚再回答。你自称「我」，称呼群友为「你」，不使用命令句。遇到有人抱怨工作或加班，先回应情绪，再给一句轻量的建议，不说教，不长篇大论。

适合：同事群、兴趣群，气氛偏平和。

模板三：毒舌吐槽鱼

你是一条名叫大肥鱼的 QQ 群助手，性格毒舌但守规矩，擅长用一句短评点出问题所在。你只吐槽事情本身，不评价人的外貌、身份、能力，不涉及隐私，不碰敏感话题。被问正经问题时切回正常语气，认真简短地答完，再补一句吐槽收尾。

适合：技术群、八卦群，需要点乐子的地方。

三份模板都可以加一句「回答控制在三句话以内」，这是最有效的长度控制手段，比在提示词里反复强调管用。

五、人设调不好的三个典型原因

人设写了但机器人说话还是像客服，通常是这三个原因，跟扫码无关，但值得一起解决。

第一是没写「不做什么」。只写「你是一条可爱的鱼」，模型会往通用助手上靠；补上「不要列点、不要总结、不要问还需要什么帮助」，语气立刻就像人了。

第二是没给长度上限。不限制长度，模型倾向于把话说完整，而群里没人想看长文。写死句数比写「简洁一点」有效得多。

第三是同时要求了互相冲突的性格。既「毒舌」又「温柔体贴」，模型会取平均，结果是不冷不热。一个人设只保留一个主性格，其余的用口头禅补。

改完人设不需要重新扫码，直接在流水线里改、保存，下一条消息就生效。绑定关系跟人设是两回事，不用重新走一遍授权，也不影响已经绑好的 QQ 号。

六、常见问题

扫完码，界面没有显示绑定完成？

说明授权流程没走完。重新点一次一键扫码绑定，用手机 QQ 完整扫一遍并在手机上点确认。

绑定成功了，在群里 @ 没反应？

按这个顺序查：机器人是不是已启用；流水线有没有挂到这台机器人上；触发方式是不是仅 @；@ 的是不是机器人本身而不是同名的群友。

机器人对群里所有消息都在回？

触发方式被改成了全部消息触发，回控制台改成仅 @ 触发。群里的公共机器人这样最容易被人踢。

扫码这条路的代价是什么？

绑定动作在手机 QQ 里完成，运行在平台上，你拿到的是产品界面而不是完整的进程与日志控制权。要查底层原因时，能看的东西比自部署少；如果场景要求完整运行记录或数据必须留在自己机器上，应该选自部署，而不是在这条路上将就。

---

开源仓库与自部署方式在 GitHub，托管形态的操作说明以官方文档为准。两条路都能跑出同一只鱼，区别只是运行时归谁管。