telegram-pairing-customization

# Telegram 配对消息持续响应技能

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

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

## 执行步骤

### 方法 1: 使用自动化脚本（推荐）
运行提供的脚本来自动执行修改：

```bash
bash /root/.openclaw/workspace/skills/telegram-pairing-customization/scripts/apply-pairing-fix.sh
```

脚本将自动完成以下操作：
- 备份原始文件
- 修改条件判断从 `if (created)` 为 `if (code)`
- 显示操作摘要

### 方法 2: 手动修改
如果需要手动修改，请按以下步骤操作：

#### 1. 备份原始文件
在进行任何修改之前，备份原始文件：
```bash
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`

找到以下原始代码段：
```javascript
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)`：
```javascript
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 服务以使更改生效：
```bash
openclaw gateway restart
```

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

## 验证修改
- 让未配对的用户发送 `/start` 命令
- 确认用户收到配对码消息
- 再次发送 `/start` 命令，确认用户再次收到相同的配对码

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

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