帮助
故障排查
修复最常见的问题——连接器无法上线、渠道连接断开、沙箱启动缓慢——并找到求助途径。
大多数问题归结为三件事之一：连接器失去联系、渠道会话断开，或沙箱正从休眠中唤醒。下面教你如何识别每一种情况并快速恢复工作。
连接器无法上线
连接器只有在持续发送心跳时才会报告为在线。如果心跳停止超过约 30 秒，Buda 会把它标记为过期（stale），随后标记为离线（offline）。
确认连接器进程正在其宿主机上运行。 如果进程已退出或机器进入休眠，心跳就会停止，状态会在约 30 秒内翻转为过期。
检查网络出站。 连接器需要出站访问才能连上 Buda Cloud。防火墙或代理阻断该连接，看起来和进程已死完全一样——先过期，再离线。
重启连接器。 全新启动会重新注册设备并恢复心跳；状态几乎会立即回到在线。
核对 API 密钥和目标空间。 连接器使用一个绑定到某个空间的密钥进行鉴权——被吊销或错误的密钥会让它无法上线。
过期 vs 离线： 过期 指 Buda 近期没收到连接器的消息，但还没放弃；离线 指它已经断开。两者都会在下一次成功心跳时清除。
渠道二维码 / 连接断开
基于二维码的渠道（WhatsApp、飞书、企业微信、微信、钉钉）通过扫码完成关联，随后保持一条实时网关连接。
- 你还没扫，二维码就过期了。 二维码有效期很短。重新打开渠道的连接界面生成一个新的，并尽快扫描。
- 关联后连接断开。 网关会以退避策略自动重连。手动重连前先稍等片刻——反复手动重启可能会与自动重试相互干扰。
- 扫了码但没反应。 确认你用的是正确的账号扫码（例如正确的 WhatsApp 号码或飞书工作区）。从一个新生成的二维码重新扫描。
- 消息没有路由到智能体。 确认渠道的默认空间就是承载你预期的那个智能体所在的空间。渠道按用户限定，并把任务投递到其默认空间。
沙箱启动缓慢
沙箱会空闲时休眠以避免无人值守地运行，并在有新任务时按需唤醒。休眠后的第一个任务会感觉慢一些，因为沙箱正在被唤醒。
- 暂停后的第一条消息慢，之后的就快了。 那就是唤醒。一旦运行起来，沙箱会保持热态以应对后续工作。
- 繁重任务持续缓慢。 CPU 和内存按你空间的套餐限定。如果大任务被卡了瓶颈，更高的套餐会为每个智能体配给更多资源。
- 任务似乎卡在启动阶段。 发一条简短的追问推它一下，或打开会话详情，实时观察文件、终端和浏览器中的进展。
在哪里求助
如果以上都没能解决，找真人：
- 邮箱： hi@buda.im——我们在 24 小时内回复
- 社区： Discord
- 文档： 浏览常见问题以获取常见问题的解答