效率需要联网clawhub未标认证来源可访问clear审计通过

teamgram-client-e2e-flow（teamgram 客户端 e2e 流程）

Agent Skill

teamgram-client-e2e-flow 用于整理文档、README、Markdown 和说明材料，适合在 OpenClaw 中需要把零散信息整理成结构清晰的文档时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。

总安装

6,265

周安装

251

GitHub Stars

公开资料未说明

下载量

2,028

OpenClaw

安装说明

本站只整理中文说明和来源信息，不托管安装包，也不代用户安装。

GitHub

来源数

许可证

MIT-0

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手，先确认命令和权限，再让它执行。

请帮我安装这个 Agent Skill：teamgram-client-e2e-flow（teamgram 客户端 e2e 流程）
来源仓库：https://github.com/zhihang9978/teamgram-client-e2e-flow
安装命令：
openclaw skills install teamgram-client-e2e-flow
安装前请先检查当前环境是否支持对应 CLI，并向我确认将要执行的命令、安装目录、联网范围和文件读写权限；确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 OpenClaw 从第三方来源获取 Skill；本站只展示命令，不托管安装包，也不自动执行。

ClawHubOpenClaw

openclaw skills install teamgram-client-e2e-flow

简介

记录 KHF Android 客户端架构以及通过所有 Teamgram Server 层进行登录、消息传递和文件操作的完整端到端数据流。

SKILL.md

name: teamgram-client-e2e-flow
description: Documents the KHF Android client architecture and complete end-to-end data flows for login, messaging, and file operations through all Teamgram Server layers.
compatibility: Documentation/knowledge skill only. No executable code. Reference material for Teamgram Server developers.
metadata
author: zhihang9978
version: 1.0.0
source: https://github.com/teamgram/teamgram-server
homepage: https://github.com/teamgram/teamgram-server
openclaw
requires
env: []
bins: []
securityNotes: |

KHF Android 客户端架构与端到端数据流

KHF 客户端关键常量

从 KHF 源码提取（必须与服务端兼容）：

TLRPC.LAYER = 222
BuildVars.APP_ID = 4
BuildVars.APP_HASH = "014b35b6184100b085b0d0572f9b5103"

tgnet/ConnectionsManager：Java → JNI → Native MTProto

ConnectionsManager 负责：

native_init(...) 初始化 MTProto（layer/api_id/设备信息）
native_sendRequest(...) 发送 RPC
DC/网络状态管理

客户端通过 JNI 调用 Native C++ 层实现 MTProto 协议，包括：

加密/解密（AES-IGE）
握手（DH 密钥交换生成 auth_key）
消息序列化/反序列化（TL 二进制格式）
网络连接管理（TCP/WebSocket）
重连与退避策略

MessagesController：业务层

MessagesController 负责 dialogs/messages/users/chats 的本地模型与网络请求，典型方法：

loadAppConfig — 加载应用配置
loadDialogs — 加载对话列表
loadMessages — 加载消息
loadFullChat — 加载群组完整信息
loadFullUser — 加载用户完整信息

端到端数据流示例

登录流程：auth.sendCode → auth.signIn

Client (KHF)
  -> TL: auth.sendCode(phone_number, api_id, api_hash, settings)
  -> MTProto encrypted message
  -> gnetway decrypt + QuickAck + SendDataToSession
  -> session decode TLMessage2 -> route to /mtproto.RPCAuthorization via IDMap
  -> bff.authorization.AuthSendCode
       -> biz.user (check phone registered)
       -> status (online sessions)
       -> verify-code plugin (sms) OR app code
  <- bff returns auth.SentCode or error
  <- session wraps rpc_result
  <- gnetway encrypts + send back
  <- client parses auth.SentCode

消息发送流程：messages.sendMessage

Client
  -> TL: messages.sendMessage / messages.sendMedia / ...
  -> gnetway -> session -> bff.messages
  -> bff.messages
       -> biz_service (dialog/message/chat/user)
       -> msg service (异步投递 + Kafka)
  -> messenger.msg produces to Kafka Inbox-T
  -> inbox consumes Inbox-T, writes inbox/outbox state
  -> produces updates to Kafka Sync-T
  -> sync consumes Sync-T, decides UpdatesMe/NotMe/PushRpcResult
  -> sync calls session (gRPC) to push updates/rpc_result
  -> session routes to correct sessionId
  -> gnetway encrypt -> client

文件上传下载流程

Client
  -> files.upload* / upload.getFile
  -> bff.files
       -> dfs 保存/获取 file parts
       -> media 生成缩略图/元数据
       -> db 写入 documents/photos/photo_sizes/...
  <- 返回 inputFile / fileLocation / document/photo

DFS
  - Minio buckets: documents/photos/videos/encryptedfiles
  - MiniHttp 0.0.0.0:11701 提供 HTTP 下载入口

客户端与服务端兼容性要点

LAYER 版本：客户端 LAYER=222 必须与服务端 session.yaml 中的 layer 配置一致
APP_ID/APP_HASH：必须与服务端 BFF 配置中的 ApiId/ApiHash 匹配
MTProto 握手：客户端使用 obfuscated2 + AES-IGE 加密
TL 序列化：客户端和服务端必须使用相同的 TL Schema 版本

常见错误与排查

错误	含义	排查方向
PHONE_NUMBER_INVALID	手机号格式不正确	检查国际格式（+86...）
PHONE_NUMBER_BANNED	手机号被封禁	检查 predefined_users 表
SESSION_PASSWORD_NEEDED	需要两步验证	用户设置了密码
AUTH_KEY_UNREGISTERED	auth_key 未注册	清除客户端数据重新握手
CONNECTION_NOT_INITED	未调用 initConnection	客户端需先发 initConnection
ERR_ENTERPRISE_IS_BLOCKED	企业版功能锁定	需要解除企业版拦截（修改 biz_service 中的企业版检查逻辑）
METHOD_NOT_IMPL	RPC 方法未实现	检查 BFF handler 和 session IDMap 路由是否配置

企业版锁定模式

Teamgram 社区版中部分功能被企业版锁定拦截，表现为：

ERR_ENTERPRISE_IS_BLOCKED 错误
在 biz_service 层的 helper 中通过 checkEnterprise() 函数拦截

解锁方法：修改 biz_service 中对应 helper 的企业版检查逻辑，移除或绕过 checkEnterprise() 调用。

关键代码路径

客户端 (KHF)

ConnectionsManager：TMessagesProj/jni/tgnet/ConnectionsManager.cpp
MessagesController：TMessagesProj/src/main/java/org/telegram/messenger/MessagesController.java
TLRPC 定义：TMessagesProj/src/main/java/org/telegram/tgnet/TLRPC.java
BuildVars：TMessagesProj/src/main/java/org/telegram/messenger/BuildVars.java

服务端 (HD/Teamgram)

gnetway 入口：app/interface/gnetway/
session 路由：app/interface/session/
BFF 模块：app/bff/
biz_service：app/service/biz/
messenger：app/messenger/
配置文件：teamgramd/etc/
SQL schema：teamgramd/deploy/sql/

Source Code References

Repository: https://github.com/teamgram/teamgram-server (Apache-2.0)

适合场景

OpenClaw 用户查找和安装 Skill 时

用户想查找某类 Agent Skill 时

需要根据任务场景推荐可安装能力包时

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明，方便继续核验

能力 4

补充不同宿主或平台的使用分布数据

能力 5

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用；具体调用方式请以来源页面和 README 为准。

平台分布

OpenClaw

85.38%

按下载量换算1,732

安全审计

VirusTotal

通过

ClawScan

通过

Static analysis

通过

权限和风险

需要联网

该 Skill 可能需要联网访问来源站点、仓库或外部 API；具体网络访问范围需要结合源码和 README 复核。

安装前确认

本站仅展示第三方公开信息，不托管安装包，不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。当前只有一个来源，正式发布前建议补源仓库或其他目录站核验。

来源信息

GitHub 仓库

github.com

/zhihang9978/teamgram-client-e2e-flow

SKILL.md 来源

clawhub.ai

/zhihang9978/teamgram-client-e2e-flow

继续浏览同类 Skills

更多效率 Skills（21,003）返回 Skills 目录

上一个 Skill

teamgram-biz-service（团队商务服务）

teamgram-biz-service 用于整理文档、README、Markdown 和说明材料，适合在 OpenClaw 中需要把零散信息整理成结构清晰的文档时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。

下一个 Skill

teamgram-gnetway-gateway（teamgram gnetway 网关）

teamgram-gnetway-gateway 用于辅助前端页面、组件、样式和交互逻辑开发，适合在 OpenClaw 中需要维护前端项目、生成组件或检查界面实现时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。