telegram-pairing-customization

🔧 OpenClaw Telegram 配对消息持续响应

OpenClaw 社区配置方案,通过修改源码条件判断实现未批准用户每次 /start 都接收配对码,解决消息丢失问题,提升用户 onboarding 成功率。

收藏
4.5k
安装
1.4k
版本
v1.0.4
CLS 安全性认证2026-05-08
点击查看完整报告 >

使用说明

这是一个针对 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 服务启动失败、以及更新后忘记重新配置导致功能回退。虽然该技能本身是纯文档且安全,但执行修改过程需要谨慎,建议严格遵循文档中的备份建议,并在测试环境验证后再应用到生产环境。

安全解读

核心用法

此技能为纯 Markdown 文档型指导,帮助用户修改 OpenClaw 的 Telegram 配对逻辑。核心操作是将条件判断从 if (created) 改为 if (code),使未批准用户在配对被批准前,每次发送 /start 消息都能收到配对码回复。

具体修改步骤
1. 搜索包含 Ask the bot owner to approve with: 的代码片段,定位目标文件(建议从 /usr/lib/node_modules/openclaw/ 开始)

2. 将 if (created) 替换为 if (code)

3. 重启 OpenClaw 服务使更改生效

显著优点

| 维度 | 说明 |
|:---|:---|
| **用户体验提升** | 解决用户首次 `/start` 后丢失配对码、无法重新获取的痛点 |
| **零代码风险** | 纯文档型技能,无可执行代码,不涉及动态执行或远程加载 |
| **修改逻辑清晰** | 仅需改动一行条件判断,技术门槛较低 |
| **原理透明** | 利用 `upsertTelegramPairingRequest` 返回的 `code` 字段持久性,配对码未过期/批准前始终有效 |

潜在缺点与局限性

| 风险点 | 说明 |
|:---|:---|
| **系统文件修改风险** | 需直接修改 OpenClaw 安装目录下的源文件,操作不当可能导致服务异常 |
| **更新覆盖问题** | OpenClaw 更新时会覆盖修改,需重新应用 |
| **权限要求** | 需要文件系统写权限(可能需 sudo) |
| **无回滚机制** | 依赖用户自行备份,技能本身不提供自动备份功能 |
| **路径依赖** | 不同安装方式(npm/global/docker)路径可能不一致,需用户自行定位 |

适合人群

  • OpenClaw 自托管用户,需自定义 Telegram 配对流程
  • 管理员希望降低用户支持负担(减少"找不到配对码"的求助)
  • 具备基本 Linux/Node.js 运维能力的技术用户

常规风险

| 风险类型 | 评估 |
|:---|:---|
| **Skill 本身安全性** | ✅ 极低——纯文档,无代码执行、无网络请求、无数据收集 |
| **用户操作风险** | ⚠️ 中等——指导修改系统文件,需用户具备备份意识和基本运维能力 |
| **供应链风险** | ✅ 低——无第三方依赖,仅依赖 OpenClaw 自身 |
| **合规风险** | ✅ 极低——GDPR/CCPA 全通过,不涉及用户数据处理 |

使用建议

1. 操作前必做:完整备份原始文件
2. 验证路径:确认 OpenClaw 实际安装位置(which openclawnpm root -g

3. 分环境验证:先在测试实例验证,再部署生产

4. 记录变更:维护本地 patch 记录,便于更新后快速重放修改

telegram-pairing-customization 内容

手动下载zip · 2.2 kB
SKILL.mdtext/markdown
请选择文件