telegram-pairing-approver

🤖 Telegram 自动配对会话管家

T2 级可信 Telegram 机器人服务,自动处理配对代码审批,以 systemd 服务提供高可用保障。

收藏
2.3k
安装
962
版本
v1.0.1
CLS 安全性认证2026-05-19
点击查看完整报告 >

使用说明

该 Skill 提供完整的 Telegram 机器人自动化解决方案,专用于处理配对代码审批场景。通过执行部署脚本,用户可快速创建基于 systemd 的系统服务,使用 Node.js 和 Telegraf 框架构建,实现 24/7 不间断监听 Telegram 消息。

核心用法十分直观:用户只需提供 Telegram Bot Token 运行部署脚本,系统即自动生成机器人脚本和 systemd 服务配置文件,完成注册和启动。机器人运行时能智能识别三种配对代码格式(纯代码、带 code: 前缀、带 Pairing code: 前缀),并自动执行 openclaw pairing approve telegram 命令完成授权,同时向用户返回友好的确认信息。

显著优点体现在运维效率和可靠性上。作为系统服务运行,具备自动重启机制,确保服务高可用;自动化处理消除了人工干预需求;支持多种配对代码格式提升了用户体验;严格的正则表达式验证(仅允许 8 位大写字母和数字)确保了输入安全性。

然而,该 Skill 存在明显的权限和透明度局限。最突出的问题是部署过程需要 root 权限创建系统服务文件并执行 systemctl 命令,且 SKILL.md 未充分披露这一要求。生成的服务默认以 root 用户运行,存在潜在的安全风险。此外,部署过程缺乏二次确认机制,可能误操作影响系统配置。

适合的目标群体主要是具备服务器管理权限的 DevOps 工程师、系统管理员以及需要长期运行 Telegram 配对机器人的企业团队。特别适用于内部自动化工作流、CI/CD 环境中的权限审批等场景。

使用风险包括:root 权限执行带来的系统安全风险、Bot Token 泄露导致的未授权访问、以及 systemd 服务配置错误可能影响系统稳定性。建议在隔离环境(如容器或虚拟机)中先行测试,并考虑手动修改服务配置以使用普通用户运行。

安全解读

核心用法

Telegram Pairing Approver 是一个自动化部署工具,用于创建持久运行的 Telegram 机器人服务。用户只需提供 Bot Token,脚本即可自动完成:生成机器人脚本、创建 systemd 服务文件、注册并启动系统服务。机器人自动监听包含配对代码的消息,识别三种格式(纯代码、code: 前缀、Pairing code: 前缀),验证后执行 openclaw pairing approve telegram <code> 命令完成授权。

显著优点

  • 一键部署:单命令完成完整服务搭建,无需手动配置
  • 高可用设计:systemd 服务管理,自动重启机制保障持续运行
  • 多格式兼容:智能识别三种配对代码格式,提升用户体验
  • 用户友好:自动回复清晰的使用说明,降低学习成本

潜在缺点与局限性

  • 权限要求高:需要 root 权限写入系统目录、启动系统服务
  • Token 存储方式欠妥:Bot Token 通过字符串拼接硬编码注入生成文件,存在泄露风险
  • 输入验证有限:配对代码仅验证 8 位字母数字格式,缺乏更严格的边界检查
  • 无卸载机制:仅提供部署功能,未提供配套清理脚本
  • 个人开发者维护:来源可信度 T3,代码审查责任完全在用户

适合人群

  • 需要批量或自动化处理 Telegram 配对请求的技术用户
  • 熟悉 Linux 系统管理、了解 systemd 服务配置的运维人员
  • 已部署 OpenClaw 环境且需要 Telegram 集成的进阶用户
  • 能够自行审查代码并承担安全风险的自托管场景

常规风险

  • 系统命令执行:使用 child_process.exec/execSync 执行 systemctl 等系统命令(功能必需但权限敏感)
  • 服务文件植入:向 /etc/systemd/system/ 写入文件并配置 root 身份运行
  • 命令注入可能:配对代码输入虽经正则过滤,但直接拼接入 shell 命令仍存在理论风险
  • Token 泄露:硬编码存储方式可能导致敏感凭证暴露于文件系统

建议使用前:在隔离环境测试,改用环境变量方式存储 Token,并审计所有执行的系统命令。

telegram-pairing-approver 内容

scripts文件夹
手动下载zip · 3.8 kB
deploy.jstext/javascript
请选择文件