telegram-pairing-customization

Telegram 配对消息持续响应技能

概述

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

何时使用此技能

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

执行步骤

1. 找到需要修改的文件

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

async function issuePairingChallenge(params) {
  const { code, created } = await params.upsertPairingRequest({
    id: params.senderId,
    meta: params.meta
  });
  if (!created) return { created: false };
  params.onCreated?.({ code });
  const replyText = params.buildReplyText?.({
    code,
    senderIdLine: params.senderIdLine
  }) ?? buildPairingReply({
    channel: params.channel,
    idLine: params.senderIdLine,
    code
  });
  try {
    await params.sendPairingReply(replyText);
  } catch (err) {
    params.onReplyError?.(err);
  }
  return {
    created: true,
    code
  };
}

2. 实施修改

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

async function issuePairingChallenge(params) {
  const { code, created } = await params.upsertPairingRequest({
    id: params.senderId,
    meta: params.meta
  });
  if (!code) return { created: false }; // <-- 关键修改点
  params.onCreated?.({ code });
  const replyText = params.buildReplyText?.({
    code,
    senderIdLine: params.senderIdLine
  }) ?? buildPairingReply({
    channel: params.channel,
    idLine: params.senderIdLine,
    code
  });
  try {
    await params.sendPairingReply(replyText);
  } catch (err) {
    params.onReplyError?.(err);
  }
  return {
    created: true,
    code
  };
}

3. 重启服务

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

openclaw gateway restart

一些建议

在寻找需要修改的文件时, 建议先搜索 async function issuePairingChallenge(params) 可以帮助你先大幅缩小处理范围, 过滤出需要修改的文件.

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

验证修改

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

注意事项

• 修改系统文件前务必备份原始文件
• 修改后的文件在 OpenClaw 更新时可能会被覆盖，需要重新应用修改

故障排除

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