Integrations & Debugging
Connect your favorite messaging platforms and troubleshoot issues.
Telegram 机器人设置
步骤 1：通过 BotFather 创建您的机器人
- 打开 Telegram 并搜索 '<'code'>'@BotFather'<'/code'>'
- 发送 '<'code'>'/newbot'<'/code'>' 并按照提示操作
- 选择一个名称（例如 "My OpenClaw"）和用户名（必须以 "bot" 结尾）
- BotFather 将会给您一个令牌，如：'<'code'>'123456789:ABC-DEF1234ghIkl-zyx57W2v1u123ew11'<'/code'>'
任何拥有此令牌的人都可以控制您的机器人。如果泄露，请使用 '<'code'>'/revoke'<'/code'>' 生成新的令牌。
步骤 2：添加令牌到 OpenClaw
使用 CLI 注册提供商：
moltbot providers add --provider telegram --token YOUR_BOT_TOKEN或者直接添加到配置文件：
// ~/.clawdbot/config.json
{
"channels": {
"telegram": {
"enabled": true,
"botToken": "123456789:ABC-DEF1234ghIkl-zyx57W2v1u123ew11",
"dmPolicy": "allowlist",
"allowFrom": ["YOUR_TELEGRAM_USER_ID"],
"groupPolicy": "allowlist",
"streamMode": "partial"
}
}
}步骤 3：配置 DM 策略
默认情况下，'<'code'>'dmPolicy'<'/code'>' 设置为 '<'code'>'"pairing"'<'/code'>'：
- '<'strong'>'pairing：'<'/strong'>' 未知发送者会收到配对码（1小时后过期）
- '<'strong'>'allowlist：'<'/strong'>' 只允许特定的用户 ID
- '<'strong'>'open：'<'/strong'>' 允许任何人（不推荐！）
批准配对请求：
moltbot pairing list telegram
moltbot pairing approve telegram <CODE>步骤 4：群组配置
Telegram 机器人默认使用隐私模式——它们只能看到提及它们的消息。要查看所有消息，请将机器人添加为'<'strong'>'群组管理员'<'/strong'>'。
步骤 5：重启网关
moltbot gateway restartGA4 高意图集成分流
如果你是从搜索或 direct 流量进来，先选最快路径，再决定是否改 token 或重启 Gateway。
正在接入新频道
先完成 Telegram 设置，再验证 DM policy 和 pairing，最后再把 bot 拉进群。
某个频道静默了
先查 channel status、日志、IPv6 或 intent 设置，不要第一步就轮换凭据。
需要重启 Gateway
重启前先记录频道、最后一次成功消息和准确报错，避免事故失去可复盘证据。
准备升级给维护者
带上 config shape、频道名、provider 版本，以及一次可复现的收发失败。
重启前先选对集成故障层
集成页流量多半来自接入或事故现场。先用这个分流判断，避免改错层。
Bot token 或 provider 凭据变了
只有平台后台显示凭据被撤销、泄露或绑错 bot 账号时，才优先轮换 token。
用户或群里完全收不到 bot 响应
先查 DM policy、pairing 状态、allowlist、群隐私模式和平台 intents，不要直接当成宕机。
频道原本可用，重启后才失效
再次重启前先保存 gateway logs、provider 版本、配置 diff 和最后一条成功消息。
集成接入证据包
重启或升级前先留住这 4 个事实，把集成页流量转成已解决的频道，而不是又一张模糊事故单。
配置形状
记录 provider 名称、启用频道、DM policy、allowlist 或 pairing 模式，以及 bot 是在群里还是私聊里运行。
发送者身份
保存 user ID、group ID、bot username，以及应该被允许和 OpenClaw 对话的准确账号。
收发闭环证据
改 token 前先保留一次 outbound test、一次 inbound reply、时间戳和最后一条成功消息。
回滚路径
写清旧 token 或频道配置位置、谁能轮换，以及恢复服务需要执行的重启命令。
调试诊所
常见问题及其解决方案。点击展开。
