闲社服务运行正常AI智能体自动化平台
t

Teamgram网关层

技能标识:teamgram-gnetway-gateway

Documents the gnetway network gateway layer in Teamgram Server, covering TCP/WS/HTTP listeners, connection lifecycle, MTProto decryption, QuickAck, and session dispatch.

作者:admin | 来源记录:ClawHub
登记来源
ClawHub
版本
V 1.0.0
检测标记
后台标记通过
免费
免费获取
0
收藏
来源与检测标记为平台登记信息,并不代表已展示可复核的检测报告。使用前请核对版本、依赖和所需权限,建议先在隔离环境中运行。
概述
安装方式
版本历史

Teamgram网关层

技能名称: teamgram-gnetway-gateway
详细描述:

网络层:gnetway(interface.gateway)

监听端口与协议

来自配置 teamgramd/etc/gnetway.yaml:

yaml
Gnetway:
Server:
- Proto: tcp
Addresses:
- 0.0.0.0:10443
- 0.0.0.0:5222
- Proto: websocket
Addresses:
- 0.0.0.0:11443

协议端口说明
TCP0.0.0.0:10443主要 MTProto TCP 端口
TCP
0.0.0.0:5222 | 备用 TCP 端口 | | WebSocket | 0.0.0.0:11443 | WebSocket 连接入口 |
  • - gnetway 通过 etcd 发现 session:Key: interface.session

连接生命周期

OnOpen

  • - 根据本地监听地址判断连接类型(tcp/ws/http)
  • 创建 connContext
  • 设置 closeDate
  • 放入 timewheel 管理超时

OnClose

  • - 对非 HTTP 连接,如果已存在 permauthkey
  • 通知 session.CloseSession(回收会话、清理在线状态等)

加密消息处理流程

text
收到加密数据
→ authKey.AesIgeDecrypt 解密
→ 提取 salt、sessionId、msgId
→ SessionDispatcher.SendData (gRPC) 转发给 session 服务

核心点:

  • - 通过 authKey.AesIgeDecrypt 解密
  • 从解密后 payload 头部提取:salt、sessionId、msgId
  • 通过 SessionDispatcher.SendData(gRPC)把 payload[16:] 转发给 session

auth_key 缓存与 QueryAuthKey

当 connContext 中没有 authKey(首次连接或缓存未命中):

  1. 1. 异步调用 session 的 QueryAuthKey
  2. 获取 authKey 后存入 connContext
  3. 执行 onEncryptedMessage 处理加密消息

QuickAck

QuickAck token 通过 SHA256(authKey[88:120] + encryptedData) 前 4 字节计算,最高位置 1。
必须通过 codec 编码发送,否则 obfuscated CTR 计数器不同步,导致客户端解密失败。

关键代码路径

  • - 主服务入口:app/interface/gnetway/
  • gnet 服务器实现:app/interface/gnetway/internal/server/gnet/server_gnet.go
  • 配置文件:teamgramd/etc/gnetway.yaml

源代码参考

  • - 仓库地址:https://github.com/teamgram/teamgram-server (Apache-2.0)

标签

skill ai

通过对话安装

以下为平台配置的接入选项,并非逐项实测通过。能否安装取决于客户端支持、技能来源和运行环境:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 teamgram-gnetway-gateway-1776080415 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 teamgram-gnetway-gateway-1776080415 技能

通过命令行安装

skillhub install teamgram-gnetway-gateway-1776080415

下载

⬇ 下载 teamgram-gnetway-gateway v1.0.0(免费)

文件大小: 2.28 KB | 发布时间: 2026-4-15 14:37

v1.0.0 最新 2026-4-15 14:37
Initial release
返回顶部