Demerzels-lab Telegram 配对消息持续响应技能
概述
此技能描述如何修改 OpenClaw 的 Telegram 配对逻辑，使未批准的用户在配对被批准前，每次发送 /start 消息时都能收到配对码回复。
何时使用此技能
- 需要让未批准的用户每次发送
/start都收到配对消息（而非仅首次） - 用户可能错过首次配对消息，需要重新获取配对码
- 提升用户体验，确保用户始终能获得配对指引
执行步骤
方法 1: 使用自动化脚本（推荐）
运行提供的脚本来自动执行修改：
bash /root/.openclaw/workspace/skills/telegram-pairing-customization/scripts/apply-pairing-fix.sh
脚本将自动完成以下操作：
- 备份原始文件
- 修改条件判断从
if (created)为if (code) - 显示操作摘要
方法 2: 手动修改
如果需要手动修改，请按以下步骤操作：
1. 备份原始文件
在进行任何修改之前，备份原始文件：
cp /usr/lib/node_modules/openclaw/dist/telegram/bot-message-context.js /usr/lib/node_modules/openclaw/dist/telegram/bot-message-context.js.backup
2. 修改配对消息触发逻辑
文件路径：/usr/lib/node_modules/openclaw/dist/telegram/bot-message-context.js
找到以下原始代码段：
if (dmPolicy === "pairing") {
try {
const from = msg.from;
const telegramUserId = from?.id ? String(from.id) : candidate;
const { code, created } = await upsertTelegramPairingRequest({
chatId: candidate,
username: from?.username,
firstName: from?.first_name,
lastName: from?.last_name,
});
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")),
});
}
}
catch (err) {
logVerbose(`telegram pairing reply failed for chat ${chatId}: ${String(err)}`);
}
}
将条件判断从 if (created) 修改为 if (code)：
if (dmPolicy === "pairing") {
try {
const from = msg.from;
const telegramUserId = from?.id ? String(from.id) : candidate;
const { code, created } = await upsertTelegramPairingRequest({
chatId: candidate,
username: from?.username,
firstName: from?.first_name,
lastName: from?.last_name,
});
if (code) { // Send pairing message if we have a valid code (either newly created or previously 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")),
});
}
}
catch (err) {
logVerbose(`telegram pairing reply failed for chat ${chatId}: ${String(err)}`);
}
}
3. 重启服务
修改完成后需要重启 OpenClaw 服务以使更改生效：
openclaw gateway restart
工作原理
upsertTelegramPairingRequest函数返回{code, created}对象- 当用户首次请求配对时：
created: true，有配对码 - 当用户再次请求配对时：
created: false，但仍有相同的配对码（只要配对请求未过期或未被批准） - 通过检查
if (code)而不是if (created)，确保用户每次请求都能收到有效的配对码
验证修改
- 让未配对的用户发送
/start命令 - 确认用户收到配对码消息
- 再次发送
/start命令，确认用户再次收到相同的配对码
注意事项
- 修改系统文件前务必备份原始文件
- 修改后的文件在 OpenClaw 更新时可能会被覆盖，需要重新应用修改
- 需要适当的文件系统权限来修改 OpenClaw 的安装文件
- 修改后应测试以确保功能正常
故障排除
- 如果修改不生效，请确认是否正确重启了 OpenClaw 服务
- 如果找不到文件路径，请确认 OpenClaw 的实际安装路径
- 如果权限不足，请使用适当的权限提升方法（如 sudo）
- 如需回滚，请使用备份文件替换修改后的文件