Telegram Pairing Send Code To Every Start

Telegram 配对消息持续响应技能

概述

此技能描述如何修改 OpenClaw 的 Telegram 配对逻辑，使未批准的用户在配对被批准前，每次发送 /start 消息时都能收到配对码回复。

何时使用此技能

• 需要让未批准的用户每次发送 /start 都收到配对消息（而非仅首次）
• 用户可能错过首次配对消息，需要重新获取配对码
• 提升用户体验，确保用户始终能获得配对指引

执行步骤

1. 找到需要修改的文件

在你正在运行的代码中搜索下面的代码段

if (created) {
  logger.info({
    chatId: candidate,
    username: from?.username,
    firstName: from?.first_name,
    lastName: from?.last_name,
    matchKey: allowMatch.matchKey ?? "none",
    matchSource: allowMatch.matchSource ?? "none"
  }, "telegram pairing request");
  await withTelegramApiErrorLogging({
    operation: "sendMessage",
    fn: () => bot.api.sendMessage(chatId, [
      "OpenClaw: access not configured.",
      "",
      `Your Telegram user id: ${telegramUserId}`,
      "",
      `Pairing code: ${code}`,
      "",
      "Ask the bot owner to approve with:",
      formatCliCommand("openclaw pairing approve telegram <code>")
    ].join("\n"))
  });
}

2. 实施修改

将条件判断从 if (created) 修改为 if (code):

if (code) { // <-- 关键修改点
  logger.info({
    chatId: candidate,
    username: from?.username,
    firstName: from?.first_name,
    lastName: from?.last_name,
    matchKey: allowMatch.matchKey ?? "none",
    matchSource: allowMatch.matchSource ?? "none"
  }, "telegram pairing request");
  await withTelegramApiErrorLogging({
    operation: "sendMessage",
    fn: () => bot.api.sendMessage(chatId, [
      "OpenClaw: access not configured.",
      "",
      `Your Telegram user id: ${telegramUserId}`,
      "",
      `Pairing code: ${code}`,
      "",
      "Ask the bot owner to approve with:",
      formatCliCommand("openclaw pairing approve telegram <code>")
    ].join("\n"))
  });
}

3. 重启服务

修改完成后需要重启 OpenClaw 服务以使更改生效:

openclaw gateway restart

一些建议

在寻找需要修改的文件时, 建议先搜索 Ask the bot owner to approve with: 可以帮助你先大幅缩小处理范围, 过滤出最有可能的几个文件.

一个建议的起始目录为 /usr/lib/node_modules/openclaw/

工作原理

• upsertTelegramPairingRequest 函数返回 {code, created} 对象
• 当用户首次请求配对时：created: true，有配对码
• 当用户再次请求配对时：created: false，但仍有相同的配对码（只要配对请求未过期或未被批准）
• 通过检查 if (code) 而不是 if (created)，确保用户每次请求都能收到有效的配对码

验证修改

• 让未配对的用户发送 /start 命令
• 确认用户收到配对码消息
• 再次发送 /start 命令，确认用户再次收到相同的配对码

注意事项

• 修改系统文件前务必备份原始文件
• 修改后的文件在 OpenClaw 更新时可能会被覆盖，需要重新应用修改
• 需要适当的文件系统权限来修改 OpenClaw 的安装文件
• 修改后应测试以确保功能正常

故障排除

• 如果修改不生效，请确认是否正确重启了 OpenClaw 服务
• 如果找不到文件路径，请确认 OpenClaw 的实际安装路径
• 如果权限不足，请使用适当的权限提升方法（如 sudo）
• 如需回滚，请使用备份文件替换修改后的文件