mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-09 03:30:48 +08:00
初始化:独立 oclaw 仓库首提交
- 在 oclaw/ 下重新初始化 Git 仓库 - 补齐子仓库 .gitignore,避免提交本地运行态数据(_local、node_modules、logs 等) - 提交当前工程代码与配置 Made-with: Cursor
This commit is contained in:
commit
ba3836f00f
579 changed files with 83112 additions and 0 deletions
50
docs/GATEWAY_TELEGRAM_NORMALIZATION.md
Normal file
50
docs/GATEWAY_TELEGRAM_NORMALIZATION.md
Normal file
|
|
@ -0,0 +1,50 @@
|
|||
# Gateway Telegram Normalization
|
||||
|
||||
This document describes how gateway send-related handlers normalize Telegram transport targets.
|
||||
|
||||
## Scope
|
||||
|
||||
Normalization is applied in these handlers:
|
||||
|
||||
- `send`
|
||||
- `chat.send`
|
||||
- `sessions.send`
|
||||
|
||||
The shared implementation lives in `oclaw/gateway/server_methods/telegram_send_normalize.py`.
|
||||
|
||||
## Input fields
|
||||
|
||||
When `channel == "telegram"`, the normalizer reads:
|
||||
|
||||
- `to`
|
||||
- `threadId` (optional)
|
||||
- `replyToId` (optional)
|
||||
|
||||
Supported `to` examples:
|
||||
|
||||
- `telegram:group:-100123:topic:42`
|
||||
- `telegram:-100123:42`
|
||||
- `@username`
|
||||
- `https://t.me/username`
|
||||
|
||||
## Output fields
|
||||
|
||||
The normalizer returns:
|
||||
|
||||
- normalized `to`
|
||||
- `target`:
|
||||
- `chatId`
|
||||
- `chatType` (`direct` | `group` | `unknown`)
|
||||
- `messageThreadId` (when present in target)
|
||||
- `threadId` (normalized integer if present/resolved)
|
||||
- `replyToMessageId` (normalized integer if present)
|
||||
|
||||
## Precedence
|
||||
|
||||
- `threadId` in request params overrides thread inferred from target suffix.
|
||||
- `replyToId` is converted to `replyToMessageId` if numeric; otherwise omitted.
|
||||
|
||||
## Notes
|
||||
|
||||
- Non-Telegram channels pass through unchanged.
|
||||
- Normalized fields are included in handler payloads and in forwarded params for `chat.send -> enqueue_chat_send`.
|
||||
Loading…
Add table
Add a link
Reference in a new issue