Editing План интеграции OpenClaw Channels в Синаполис (section)

== Ingress policy ==

=== Telegram policy на текущем этапе ===

Нормативно закрепляется следующее:

* единственный официальный Telegram-ingress сейчас — <code>@EchoIntakeBot</code>;
* <code>@EchoIntakeBot</code> остаётся pure Telegram wrapper / transport shell, а не LLM/agent;
* Filum остаётся primary server-native workhorse для этого контура;
* OpenClaw не получает контроль над live token или live webhook <code>@EchoIntakeBot</code> без отдельной авторизованной миграции;
* OpenClaw Telegram channel допускается только как sandbox/new-token контур или как специально утверждённый миграционный контур с rollback-планом.

=== Группы и явное обращение ===

Для Синаполиса обязательна модель explicit-address only:

* никакого blanket ingestion всего группового потока;
* group messages должны обрабатываться только по явному mention/target/prefix;
* в действующем контуре Ductor используется <code>group_mention_only=true</code>;
* <code>@EchoIntakeBot</code> уже обслуживает group messages только при явном <code>@EchoIntakeBot</code> mention;
* эта же логика должна быть сохранена и в OpenClaw-facing policy.

OpenClaw docs подтверждают fail-closed модель для групп:

* по умолчанию группы ограничены через <code>groupPolicy: "allowlist"</code>;
* replies в группах требуют mention, если это явно не отключено;
* проверка идёт по цепочке <code>groupPolicy -> group allowlist -> requireMention</code>;
* DM pairing не должен автоматически открывать group authorization;
* DM и group sessions разделены.

Источники:

* [https://docs.openclaw.ai/channels/groups OpenClaw Groups]
* [https://docs.openclaw.ai/channels/telegram OpenClaw Telegram]

=== Нормативное правило allowlists ===

Для всех внешних каналов должны быть разделены:

* allowlist разрешённых group/channel peer IDs;
* allowlist разрешённых sender IDs внутри разрешённых групп;
* mention gating policy;
* optional per-group/per-channel tool restrictions.

Для Telegram это означает:

* chat/group IDs хранятся в allowlist групп, а не в sender allowlist;
* user IDs хранятся в sender allowlist;
* default policy должна оставаться fail-closed;
* <code>requireMention=true</code> должно считаться нормой по умолчанию.

=== Сессии и routing ===

OpenClaw хранит DMs и группы раздельно, а routing детерминирован по входному каналу и peer. Для Синаполиса это важно по двум причинам:

* личный DM-контекст не должен смешиваться с group/session контекстом;
* forum topics, group rooms и channel rooms должны сохранять отдельные session keys, чтобы маршрутизация и безопасность были проверяемы.

Источники:

* [https://docs.openclaw.ai/channels/channel-routing OpenClaw Channel routing]
* [https://docs.openclaw.ai/channels/group-messages OpenClaw Group messages]