SemibotSemibot
帮助中心

Bot 配置详细教程(重点)

适用于 Telegram / Feishu / Discord / WhatsApp / iMessage Bot 接入,建议按顺序完成以下步骤。

打开配置中心

Bot 配置教程

1. 准备接入参数

提前准备 bot token、webhook 回调地址、默认 agent 以及允许接入的 chatId 清单。

2. 新建 Bot 实例

在配置中心选择 Telegram 或 Feishu,填写基础连接参数并保存 Bot 实例。

3. 配置寻址与主动策略

设置 addressingPolicy、proactivePolicy 与 contextPolicy,避免误触发和过度打扰。

4. 执行连通性测试

点击"测试"确认 Bot 出站链路可达,并观察状态是否为 ready。

5. 配置第三方平台回调

将 Telegram/Feishu 平台回调 URL 指向 Semibot Runtime 对应接口。

6. 在事件中心与会话页验证

发送真实消息后,在事件中心确认已入站,在通道会话详情查看执行与回传结果。

安全建议

生产环境建议启用审批策略,并定期轮换 token/secret。

Bot 常见问题

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

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

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

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

提示 token/secret 无效怎么办?

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

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

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

Bot 配置