SemibotSemibot
帮助中心

Bot 配置详细教程(重点)

适用于 Telegram、Feishu、Discord、WhatsApp 和 iMessage 接入。按顺序做,一般最省事。

打开配置中心(先完成本地安装)

Bot 配置教程

1. 先把接入信息备齐

先准备好 bot token、webhook 地址、默认智能体,以及允许接入的 chatId 清单。

2. 新建 Bot 实例

在配置中心里选对应平台,把基础连接信息填好,再保存实例。

3. 把触发规则设清楚

把 addressingPolicy、proactivePolicy 和 contextPolicy 这些规则先设好,避免误触发和打扰过多。

4. 先做一次连通性测试

点一下"测试",先确认 Bot 能正常发出去,再看状态是否变成 ready。

5. 再配平台回调地址

把 Telegram 或 Feishu 这边的回调 URL 指到 Semibot 对应接口上。

6. 最后发条真消息验证

发一条真实消息后,到事件中心和会话详情里看有没有成功进来、跑起来、再回出去。

安全建议

如果准备长期使用,建议把审批打开,并定期更换 token 和 secret。

Bot 常见问题

群里发消息后机器人无响应怎么办?

优先检查 webhook 是否生效、实例是否启用、Bot 隐私模式与审批是否阻塞。

为什么某些群聊消息没有触发?

通常是 bot 绑定未正确配置,或该实例没有可用 agent。

提示 token/secret 无效怎么办?

重新签发凭据后更新 Bot 配置,并执行一次连通性测试。

任务一直等待审批如何处理?

前往审批中心通过/拒绝,或在工具配置中下调该工具风险级别与审批策略。

Bot 配置