Openclaw용 Teamgram 세션 계층 및 Authsession

Teamgram Server 아키텍처 내의 세션 라우팅 계층 및 authsession 서비스를 이해하기 위한 포괄적인 문서 스킬입니다.

zhihang9978

v1.0.0

Mar 15, 2026

설치

정보

Skill.md

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.


                  npx clawhub@latest install teamgram-session-layer

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌

~/.openclaw/skills/

워크스페이스

<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.


                  Clawhub를 사용해서 teamgram-session-layer 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

Teamgram 세션 계층 및 Authsession란 무엇인가요?

Teamgram 세션 계층 스킬은 Teamgram Server의 interface.session 및 service.authsession 구성 요소에 대한 깊은 기술적 통찰력을 제공합니다. 이 시스템이 gateway에서 오는 TLMessage2 스트림을 auth_key_id별로 집계하고, 키당 여러 세션을 관리하며, 보안 솔트(security salts)를 유지하는 방법을 설명합니다.

이 지식 베이스는 Openclaw Skills에서 작업하는 개발자가 MTProto RPC 요청이 Backend-for-Frontend (BFF) 모듈로 라우팅되는 방식과 사용자-auth_key 바인딩이 위험 제어 및 푸시 알림을 위해 유지되고 관리되는 방식을 이해하는 데 필수적입니다.

Teamgram 세션 계층 및 Authsession 활용 사례

Perm, Temp 및 MediaTemp 인증 키의 집계 이해.
METHOD_NOT_IMPL 오류를 방지하기 위해 새 BFF 모듈에 대한 IDMap 라우팅 구성.
runLoop 및 rpcRunLoop를 사용한 백프레셔 및 신뢰성 메커니즘 분석.
세션 유지 및 보안 감사를 위해 AuthKeyId를 UserId에 매핑.

Teamgram 세션 계층 및 Authsession 작동 원리

세션 서비스는 gnetway로부터 TLMessage2 스트림을 수신하고 이를 auth_key_id별로 집계합니다.
MainAuthWrapper는 분리된 데이터 및 제어 채널을 사용하여 세 가지 유형의 세션 목록(Main, Temp, MediaTemp)을 관리합니다.
세션 서비스는 IDMap 구성을 참조하여 Etcd를 통해 MTProto RPC 호출을 적절한 BFF 서비스로 라우팅합니다.
sync 서비스의 나가는 업데이트 및 RPC 결과는 특정 세션 연결로 다시 전달됩니다.
authsession 서비스는 장치 정보 및 계층 버전을 포함한 세션 메타데이터에 대한 영구 저장소 및 쿼리를 제공합니다.

Teamgram 세션 계층 및 Authsession 설정 가이드

이것은 Openclaw Skills를 위한 문서 및 지식 기반 스킬입니다. Teamgram 개발의 참고 자료로 사용하려면 서버 환경이 구성되어 있는지 확인하십시오.

# Example session service configuration
cat teamgramd\/etc\/session.yaml

# Example authsession service configuration
cat teamgramd\/etc\/authsession.yaml

Teamgram 세션 계층 및 Authsession 데이터 스키마 및 분류 체계

세션 계층은 내부 큐와 외부 서비스 매핑을 통해 데이터를 구성합니다.

구성 요소	데이터 책임
IDMap	MTProto RPC 경로(예: /mtproto.RPCMessages)를 BFF 서비스 키에 매핑합니다.
MainAuthWrapper	PermAuth, TempAuth 및 MediaTempAuth 세션을 격리합니다.
authsession DB	AuthKeyId, UserId 및 클라이언트 메타데이터(장치, 계층, initConnection)를 유지합니다.
SessionDataChan	gnetway/sync에서 들어오는 페이로드에 대한 버퍼입니다.