名称： telegram-cloud-storage
描述： 基于 Teldrive 的高性能 Telegram 云存储解决方案。将 Telegram 转变为具有本地 API/UI 的无限容量云盘。
元数据： {"openclaw":{"requires":{"bins":["teldrive"]},"install":[{"id":"binary","kind":"exec","command":"./scripts/install_binary.sh","label":"下载 Teldrive 二进制文件"}]}}

Telegram 云存储 (Teldrive 版)

本技能运行 Teldrive，这是一个强大的工具，用于组织 Telegram 文件并提供高速访问的 API 和 Web 界面。

核心特性

• 无限存储：以 Telegram 作为后端存储。
• 高性能：使用 Go 语言编写，速度经过优化。
• 界面与 API：包含 Web 界面和 REST API。
• AI 原生客户端：包含 client.py，支持基于智能体的文件操作。

致谢

本技能是对 divyam234 开发的 Teldrive 的封装。核心引擎的所有功劳归于原作者。

前置要求

1. PostgreSQL 数据库：推荐使用 17 及以上版本。
2. pgroonga 扩展：用于在 Postgres 内实现文件搜索，必须安装。
3. Telegram API：从 my.telegram.org 获取 App ID 和 Hash。

安装步骤

1. 数据库设置

确保 Postgres 正在运行，并已安装 pgroonga 扩展。

CREATE DATABASE teldrive;
\c teldrive
CREATE EXTENSION IF NOT EXISTS pgroonga;

2. 配置

运行设置脚本以生成 config/config.toml 配置文件：

./scripts/setup.sh

3. 启动服务

./scripts/manage.sh start

智能体使用

本技能包含一个 Python 客户端，用于编程式访问。

环境变量

• TELDRIVE_TOKEN：您的 JWT 令牌（可从 Web 界面或登录后的 config/token.txt 获取）。
• TELDRIVE_SESSION_HASH：您的 Telegram 会话哈希（位于 teldrive.sessions 表中）。

常用命令

# 列出文件
python3 scripts/client.py list /

# 上传文件
python3 scripts/client.py upload 本地文件.txt /远程路径

# 下载文件
python3 scripts/client.py download <文件ID> 本地保存路径

目录结构

• bin/：存放 Teldrive 二进制文件。
• config/：存放配置模板及生成的配置文件。
• scripts/：包含设置、管理和客户端脚本。
• logs/：存放应用程序日志。