telegram-pairing-customization

这是一个针对 OpenClaw 平台的配置定制化技能，旨在优化 Telegram 机器人的用户配对流程。该技能指导管理员修改 OpenClaw 的 Telegram 配对逻辑，将原有的 if (created) 条件判断改为 if (code)，从而使未批准用户在每次发送 /start 消息时都能收到配对码，而非仅在首次请求时发送。

核心用法方面，管理员需要在 OpenClaw 安装目录（通常为 /usr/lib/node_modules/openclaw/）中定位到处理 Telegram 配对请求的文件，找到包含 if (created) 的代码段，将其修改为 if (code) 或 if (do)。这一修改利用了 upsertTelegramPairingRequest 函数的特性：即使用户再次发送 /start 导致 created 为 false，只要配对请求未过期，系统仍会返回相同的配对码。修改后重启 OpenClaw 服务即可生效。

该技能的显著优点在于显著提升用户体验和配对成功率。在默认配置下，如果用户错过了首次发送的配对码，他们将无法再次获取，导致 onboarding 流程中断，增加管理员的支持负担。通过此修改，用户可以随时通过发送 /start 重新获取配对码，确保配对流程的连续性和可靠性。

然而，该技能也存在潜在缺点和局限性。首先，这需要直接修改 OpenClaw 的系统文件，要求管理员具备基本的代码阅读能力和文件系统操作权限。其次，修改后的文件在 OpenClaw 更新时会被覆盖，每次更新后都需要重新应用这些更改，增加了维护成本。此外，错误的修改可能导致服务异常，需要谨慎操作。

该技能适合的目标群体主要是自托管 OpenClaw 实例的系统管理员和开发者，特别是那些需要频繁处理新用户配对请求、且用户可能因各种原因错过初始配对消息的场景。对于使用托管服务或没有服务器文件系统访问权限的用户，此技能不适用。

在使用风险方面，主要涉及系统文件修改带来的潜在问题。包括但不限于：因权限不足导致修改失败、修改错误导致 OpenClaw 服务启动失败、以及更新后忘记重新配置导致功能回退。虽然该技能本身是纯文档且安全，但执行修改过程需要谨慎，建议严格遵循文档中的备份建议，并在测试环境验证后再应用到生产环境。