opencode/picoclaw
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(telegram): align Telegram README files with new config options

Browse source 
- Add config examples to Telegram Business Mode sections
- Add config examples to Telegram Guest Mode sections
- Update Guest Mode description with placeholder/typing indicator note
- Align formatting and content with README.md across all languages
This commit is contained in:
Roman Stolyarchuk 2026-05-11 10:56:34 +03:00
parent 361a53a2b3
commit 6374567697
6 changed files with 373 additions and 52 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

75
docs/channels/telegram/README.fr.md
View file

@ -12,10 +12,15 @@ Le canal Telegram utilise le long polling via l'API Bot Telegram pour une commun
"telegram": {
"enabled": true,
"type": "telegram",
"token": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
"allow_from": ["123456789"],
"proxy": "",
"use_markdown_v2": false
"settings": {
"proxy": "",
"use_markdown_v2": false,
"business_mode": false,
"business_owner": "123456789",
"business_commands_enable": false,
"guest_mode": false
}
}
}
}
@ -24,10 +29,13 @@ Le canal Telegram utilise le long polling via l'API Bot Telegram pour une commun
| Champ | Type | Requis | Description |
| --------------- | ------ | ------ | ------------------------------------------------------------------------ |
| enabled | bool | Oui | Activer ou non le canal Telegram |
| token | string | Oui | Token de l'API Bot Telegram |
| allow_from | array | Non | Liste blanche d'identifiants utilisateur ; vide signifie tous les utilisateurs |
| proxy | string | Non | URL du proxy pour se connecter à l'API Telegram (ex. http://127.0.0.1:7890) |
| use_markdown_v2 | bool | Non | Activer le formatage Telegram MarkdownV2 |
| settings.proxy | string | Non | URL du proxy pour se connecter à l'API Telegram (ex. http://127.0.0.1:7890) |
| settings.use_markdown_v2 | bool | Non | Activer le formatage Telegram MarkdownV2 |
| settings.business_mode | bool | Non | Activer la gestion des messages Telegram Business |
| settings.business_owner | string | Non | ID utilisateur Telegram du propriétaire Business à ignorer |
| settings.business_commands_enable | bool | Non | Autoriser les commandes du bot dans les chats Telegram Business |
| settings.guest_mode | bool | Non | Activer la gestion et les réponses des messages Telegram Guest |
## Configuration initiale
@ -37,6 +45,56 @@ Le canal Telegram utilise le long polling via l'API Bot Telegram pour une commun
4. Renseigner le Token dans le fichier de configuration
5. (Optionnel) Configurer `allow_from` pour restreindre les identifiants utilisateur autorisés à interagir (les IDs peuvent être obtenus via `@userinfobot`)
## Mode Telegram Business
Définissez `settings.business_mode: true` pour recevoir et répondre aux messages Telegram Business des comptes connectés. Les réponses utilisent le `business_connection_id` entrant, et PicoClaw marque les messages Business comme lus lorsque le bot dispose du droit `can_read_messages`.
Définissez `settings.business_owner` avec l'ID utilisateur Telegram du propriétaire du compte Business. Les messages Business envoyés par cet utilisateur sont ignorés, ce qui évite de répondre aux messages envoyés manuellement depuis le compte connecté.
Par défaut, les commandes du bot sont ignorées dans les chats Business. Définissez `settings.business_commands_enable: true` pour autoriser `/new`, `/help`, `/show`, `/list` et `/use`.
Exemple :
```json
{
"channel_list": {
"telegram": {
"enabled": true,
"type": "telegram",
"allow_from": ["123456789"],
"settings": {
"business_mode": true,
"business_owner": "123456789",
"business_commands_enable": true
}
}
}
}
```
## Mode Telegram Guest
Définissez `settings.guest_mode: true` pour recevoir les mises à jour `guest_message` et répondre avec la méthode Telegram `answerGuestQuery`. Les messages Guest proviennent de chats où le bot n'est pas membre, donc PicoClaw crée des sessions séparées avec le `guest_query_id` entrant.
Lorsque `settings.guest_mode` est `false`, PicoClaw ne demande pas les mises à jour Guest et ignore tout message Guest décodé. Les indicateurs de saisie et de placeholder sont ignorés pour les réponses Guest car Telegram requiert une seule réponse `answerGuestQuery`.
Exemple :
```json
{
"channel_list": {
"telegram": {
"enabled": true,
"type": "telegram",
"allow_from": ["123456789"],
"settings": {
"guest_mode": true
}
}
}
}
```
## Formatage avancées
Vous pouvez définir `use_markdown_v2: true` pour activer les options de formatage améliorées. Cela permet au bot d'utiliser toutes les fonctionnalités de Telegram MarkdownV2, y compris les styles imbriqués, les spoilers et les blocs de largeur fixe personnalisés.
@ -47,9 +105,10 @@ Vous pouvez définir `use_markdown_v2: true` pour activer les options de formata
"telegram": {
"enabled": true,
"type": "telegram",
"token": "YOUR_BOT_TOKEN",
"allow_from": ["YOUR_USER_ID"],
"use_markdown_v2": true
"settings": {
"use_markdown_v2": true
}
}
}
}

75
docs/channels/telegram/README.ja.md
View file

@ -12,10 +12,15 @@ Telegram チャンネルは、Telegram Bot API を使用したロングポーリ
"telegram": {
"enabled": true,
"type": "telegram",
"token": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
"allow_from": ["123456789"],
"proxy": "",
"use_markdown_v2": false
"settings": {
"proxy": "",
"use_markdown_v2": false,
"business_mode": false,
"business_owner": "123456789",
"business_commands_enable": false,
"guest_mode": false
}
}
}
}
@ -24,10 +29,13 @@ Telegram チャンネルは、Telegram Bot API を使用したロングポーリ
| フィールド | 型 | 必須 | 説明 |
| --------------- | ------ | ---- | ----------------------------------------------------------------- |
| enabled | bool | はい | Telegram チャンネルを有効にするかどうか |
| token | string | はい | Telegram Bot API トークン |
| allow_from | array | いいえ | 許可するユーザーIDのリスト。空の場合はすべてのユーザーを許可 |
| proxy | string | いいえ | Telegram API への接続に使用するプロキシ URL (例: http://127.0.0.1:7890) |
| use_markdown_v2 | bool | いいえ | Telegram MarkdownV2 フォーマットを有効にする |
| settings.proxy | string | いいえ | Telegram API への接続に使用するプロキシ URL (例: http://127.0.0.1:7890) |
| settings.use_markdown_v2 | bool | いいえ | Telegram MarkdownV2 フォーマットを有効にする |
| settings.business_mode | bool | いいえ | Telegram Business メッセージ処理を有効にする |
| settings.business_owner | string | いいえ | 無視する Business アカウント所有者の Telegram ユーザー ID |
| settings.business_commands_enable | bool | いいえ | Telegram Business チャットで Bot コマンドを処理する |
| settings.guest_mode | bool | いいえ | Telegram Guest メッセージ処理と返信を有効にする |
## セットアップ手順
@ -37,6 +45,56 @@ Telegram チャンネルは、Telegram Bot API を使用したロングポーリ
4. 設定ファイルにトークンを入力する
5. (任意) `allow_from` を設定して、対話を許可するユーザー ID を制限する（ID は `@userinfobot` で取得可能）
## Telegram Business モード
`settings.business_mode: true` を設定すると、接続された Business アカウントの Telegram Business メッセージを受信して返信できます。返信には受信した `business_connection_id` が使われ、Bot に `can_read_messages` 権限がある場合は受信 Business メッセージを既読にします。
`settings.business_owner` には Business アカウント所有者の Telegram ユーザー ID を設定します。このユーザーからの Business メッセージは無視されるため、接続済みアカウントから手動送信したメッセージへの自動返信を避けられます。
Business チャット内の Bot コマンドは既定で無視されます。`/new`、`/help`、`/show`、`/list`、`/use` を処理したい場合は `settings.business_commands_enable: true` を設定してください。
例：
```json
{
"channel_list": {
"telegram": {
"enabled": true,
"type": "telegram",
"allow_from": ["123456789"],
"settings": {
"business_mode": true,
"business_owner": "123456789",
"business_commands_enable": true
}
}
}
}
```
## Telegram Guest モード
`settings.guest_mode: true` を設定すると、`guest_message` 更新を受信し、Telegram の `answerGuestQuery` メソッドで返信できます。Guest メッセージは Bot が参加していないチャットから届くため、PicoClaw は受信した `guest_query_id` を使って別セッションとして扱います。
`settings.guest_mode` が `false` の場合、Guest 更新は要求されず、デコードされた Guest メッセージも無視されます。Telegram は単一の `answerGuestQuery` 応答のみを必要とするため、Guest 応答のプレースホルダーと入力インジケーターはスキップされます。
例：
```json
{
"channel_list": {
"telegram": {
"enabled": true,
"type": "telegram",
"allow_from": ["123456789"],
"settings": {
"guest_mode": true
}
}
}
}
```
## 高度なフォーマット
`use_markdown_v2: true` を設定することで、增强されたフォーマットオプションを有効にできます。これにより、ボットは Telegram MarkdownV2 の全機能（ネストされたスタイル、スポイラー、カスタム固定幅ブロックなど）を利用できます。
@ -47,9 +105,10 @@ Telegram チャンネルは、Telegram Bot API を使用したロングポーリ
"telegram": {
"enabled": true,
"type": "telegram",
"token": "YOUR_BOT_TOKEN",
"allow_from": ["YOUR_USER_ID"],
"use_markdown_v2": true
"settings": {
"use_markdown_v2": true
}
}
}
}

50
docs/channels/telegram/README.md
View file

@ -12,12 +12,12 @@ The Telegram channel uses long polling via the Telegram Bot API for bot-based co
"telegram": {
"enabled": true,
"type": "telegram",
"token": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
"allow_from": ["123456789"],
"settings": {
"proxy": "",
"use_markdown_v2": false,
"business_mode": false,
"guest_mode": false,
"business_owner": "123456789",
"business_commands_enable": false
}
@ -26,13 +26,16 @@ The Telegram channel uses long polling via the Telegram Bot API for bot-based co
}
```
| Field | Type | Required | Description |
| ---------------- | ------ | -------- | ------------------------------------------------------------------ |
| enabled | bool | Yes | Whether to enable the Telegram channel |
| token | string | Yes | Telegram Bot API Token |
| allow_from | array | No | Allowlist of user IDs; empty means all users are allowed |
| proxy | string | No | Proxy URL for connecting to the Telegram API (e.g. http://127.0.0.1:7890) |
| use_markdown_v2 | bool | No | Enable Telegram MarkdownV2 formatting |
| Field | Type | Required | Description |
| ------------------------ | ------ | -------- | ------------------------------------------------------------------------ |
| enabled | bool | Yes | Whether to enable the Telegram channel |
| allow_from | array | No | Allowlist of user IDs; empty means all users are allowed |
| settings.proxy | string | No | Proxy URL for connecting to the Telegram API (e.g. http://127.0.0.1:7890) |
| settings.use_markdown_v2 | bool | No | Enable Telegram MarkdownV2 formatting |
| settings.business_mode | bool | No | Enable Telegram Business message handling |
| settings.business_owner | string | No | Telegram user ID of the Business account owner to ignore |
| settings.business_commands_enable | bool | No | Allow bot commands in Telegram Business chats |
| settings.guest_mode | bool | No | Enable Telegram Guest Mode update handling and replies |
## Setup
@ -78,13 +81,12 @@ Example:
```json
{
"channels": {
"channel_list": {
"telegram": {
"enabled": true,
"type": "telegram",
"allow_from": ["123456789"],
"settings": {
"token": "YOUR_BOT_TOKEN",
"business_mode": true,
"business_owner": "123456789",
"business_commands_enable": true
@ -94,6 +96,29 @@ Example:
}
```
## Telegram Guest Mode
Set `settings.guest_mode: true` to receive `guest_message` updates and reply with Telegram's `answerGuestQuery` method. Guest messages come from chats where the bot is not a member, so PicoClaw keeps them in separate sessions using the incoming `guest_query_id`.
When `settings.guest_mode` is false, guest updates are not requested and any decoded guest message is ignored. Placeholder and typing indicators are skipped for guest replies because Telegram requires a single `answerGuestQuery` response.
Example:
```json
{
"channel_list": {
"telegram": {
"enabled": true,
"type": "telegram",
"allow_from": ["123456789"],
"settings": {
"guest_mode": true
}
}
}
}
```
## Advanced Formatting
You can set `use_markdown_v2: true` to enable enhanced formatting options. This allows the bot to utilize the full range of Telegram MarkdownV2 features, including nested styles, spoilers, and custom fixed-width blocks.
@ -104,9 +129,10 @@ You can set `use_markdown_v2: true` to enable enhanced formatting options. This
"telegram": {
"enabled": true,
"type": "telegram",
"token": "YOUR_BOT_TOKEN",
"allow_from": ["YOUR_USER_ID"],
"use_markdown_v2": true
"settings": {
"use_markdown_v2": true
}
}
}
}

75
docs/channels/telegram/README.pt-br.md
View file

@ -12,10 +12,15 @@ O canal Telegram utiliza long polling via a API de Bot do Telegram para comunica
"telegram": {
"enabled": true,
"type": "telegram",
"token": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
"allow_from": ["123456789"],
"proxy": "",
"use_markdown_v2": false
"settings": {
"proxy": "",
"use_markdown_v2": false,
"business_mode": false,
"business_owner": "123456789",
"business_commands_enable": false,
"guest_mode": false
}
}
}
}
@ -24,10 +29,13 @@ O canal Telegram utiliza long polling via a API de Bot do Telegram para comunica
| Campo | Tipo | Obrigatório | Descrição |
| --------------- | ------ | ----------- | -------------------------------------------------------------------------- |
| enabled | bool | Sim | Se o canal Telegram deve ser habilitado |
| token | string | Sim | Token da API de Bot do Telegram |
| allow_from | array | Não | Lista de IDs de usuários permitidos; vazio significa todos os usuários |
| proxy | string | Não | URL do proxy para conexão com a API do Telegram (ex. http://127.0.0.1:7890) |
| use_markdown_v2 | bool | Não | Habilitar formatação Telegram MarkdownV2 |
| settings.proxy | string | Não | URL do proxy para conexão com a API do Telegram (ex. http://127.0.0.1:7890) |
| settings.use_markdown_v2 | bool | Não | Habilitar formatação Telegram MarkdownV2 |
| settings.business_mode | bool | Não | Habilitar tratamento de mensagens Telegram Business |
| settings.business_owner | string | Não | ID de usuário Telegram do proprietário Business a ser ignorado |
| settings.business_commands_enable | bool | Não | Permitir comandos do bot em chats Telegram Business |
| settings.guest_mode | bool | Não | Habilitar tratamento e respostas de mensagens Telegram Guest |
## Configuração inicial
@ -37,6 +45,56 @@ O canal Telegram utiliza long polling via a API de Bot do Telegram para comunica
4. Preencha o Token no arquivo de configuração
5. (Opcional) Configure `allow_from` para restringir quais IDs de usuário podem interagir (os IDs podem ser obtidos via `@userinfobot`)
## Modo Telegram Business
Defina `settings.business_mode: true` para receber e responder mensagens Telegram Business de contas comerciais conectadas. As respostas usam o `business_connection_id` recebido, e as mensagens Business são marcadas como lidas quando o bot tem o direito `can_read_messages`.
Use `settings.business_owner` para informar o ID de usuário Telegram do proprietário da conta Business. Mensagens Business desse usuário são ignoradas, evitando respostas automáticas a mensagens enviadas manualmente pela conta conectada.
Por padrão, comandos do bot em chats Business são ignorados. Defina `settings.business_commands_enable: true` para processar `/new`, `/help`, `/show`, `/list` e `/use`.
Exemplo :
```json
{
"channel_list": {
"telegram": {
"enabled": true,
"type": "telegram",
"allow_from": ["123456789"],
"settings": {
"business_mode": true,
"business_owner": "123456789",
"business_commands_enable": true
}
}
}
}
```
## Modo Telegram Guest
Defina `settings.guest_mode: true` para receber atualizações `guest_message` e responder com o método Telegram `answerGuestQuery`. Mensagens Guest vêm de chats onde o bot não é membro, então o PicoClaw mantém sessões separadas usando o `guest_query_id` recebido.
Quando `settings.guest_mode` é `false`, atualizações Guest não são solicitadas e qualquer mensagem Guest decodificada é ignorada. Indicadores de digitação e placeholders são ignorados para respostas Guest porque o Telegram requer uma única resposta `answerGuestQuery`.
Exemplo :
```json
{
"channel_list": {
"telegram": {
"enabled": true,
"type": "telegram",
"allow_from": ["123456789"],
"settings": {
"guest_mode": true
}
}
}
}
```
## Formatação Avançada
Você pode definir `use_markdown_v2: true` para habilitar opções de formatação aprimoradas. Isso permite que o bot utilize todos os recursos do Telegram MarkdownV2, incluindo estilos aninhados, spoilers e blocos de largura fixa personalizados.
@ -47,9 +105,10 @@ Você pode definir `use_markdown_v2: true` para habilitar opções de formataç
"telegram": {
"enabled": true,
"type": "telegram",
"token": "YOUR_BOT_TOKEN",
"allow_from": ["YOUR_USER_ID"],
"use_markdown_v2": true
"settings": {
"use_markdown_v2": true
}
}
}
}

75
docs/channels/telegram/README.vi.md
View file

@ -12,10 +12,15 @@ Kênh Telegram sử dụng long polling qua Telegram Bot API để giao tiếp d
"telegram": {
"enabled": true,
"type": "telegram",
"token": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
"allow_from": ["123456789"],
"proxy": "",
"use_markdown_v2": false
"settings": {
"proxy": "",
"use_markdown_v2": false,
"business_mode": false,
"business_owner": "123456789",
"business_commands_enable": false,
"guest_mode": false
}
}
}
}
@ -24,10 +29,13 @@ Kênh Telegram sử dụng long polling qua Telegram Bot API để giao tiếp d
| Trường | Kiểu | Bắt buộc | Mô tả |
| -------------- | ------ | -------- | ------------------------------------------------------------------------ |
| enabled | bool | Có | Có bật kênh Telegram hay không |
| token | string | Có | Token API Bot Telegram |
| allow_from | array | Không | Danh sách trắng ID người dùng; để trống nghĩa là cho phép tất cả |
| proxy | string | Không | URL proxy để kết nối với Telegram API (ví dụ: http://127.0.0.1:7890) |
| use_markdown_v2 | bool | Không | Bật định dạng Telegram MarkdownV2 |
| settings.proxy | string | Không | URL proxy để kết nối với Telegram API (ví dụ: http://127.0.0.1:7890) |
| settings.use_markdown_v2 | bool | Không | Bật định dạng Telegram MarkdownV2 |
| settings.business_mode | bool | Không | Bật xử lý tin nhắn Telegram Business |
| settings.business_owner | string | Không | ID người dùng Telegram của chủ tài khoản Business cần bỏ qua |
| settings.business_commands_enable | bool | Không | Cho phép lệnh bot trong chat Telegram Business |
| settings.guest_mode | bool | Không | Bật xử lý và trả lời tin nhắn Telegram Guest |
## Hướng dẫn thiết lập
@ -37,6 +45,56 @@ Kênh Telegram sử dụng long polling qua Telegram Bot API để giao tiếp d
4. Điền Token vào file cấu hình
5. (Tùy chọn) Cấu hình `allow_from` để giới hạn ID người dùng được phép tương tác (có thể lấy ID qua `@userinfobot`)
## Chế độ Telegram Business
Đặt `settings.business_mode: true` để nhận và trả lời tin nhắn Telegram Business từ các tài khoản doanh nghiệp đã kết nối. Phản hồi dùng `business_connection_id` nhận được, và PicoClaw đánh dấu tin nhắn Business là đã đọc khi bot có quyền `can_read_messages`.
Đặt `settings.business_owner` thành ID người dùng Telegram của chủ tài khoản Business. Tin nhắn Business từ người dùng này sẽ bị bỏ qua để tránh bot trả lời các tin nhắn bạn gửi thủ công từ tài khoản đã kết nối.
Theo mặc định, lệnh bot trong chat Business bị bỏ qua. Đặt `settings.business_commands_enable: true` để xử lý `/new`, `/help`, `/show`, `/list` và `/use`.
Ví dụ :
```json
{
"channel_list": {
"telegram": {
"enabled": true,
"type": "telegram",
"allow_from": ["123456789"],
"settings": {
"business_mode": true,
"business_owner": "123456789",
"business_commands_enable": true
}
}
}
}
```
## Chế độ Telegram Guest
Đặt `settings.guest_mode: true` để nhận cập nhật `guest_message` và trả lời bằng phương thức Telegram `answerGuestQuery`. Tin nhắn Guest đến từ chat mà bot không phải là thành viên, nên PicoClaw tách phiên bằng `guest_query_id` nhận được.
Khi `settings.guest_mode` là `false`, cập nhật Guest không được yêu cầu và mọi tin nhắn Guest được giải mã sẽ bị bỏ qua. Các chỉ báo gõ và placeholder được bỏ qua cho phản hồi Guest vì Telegram yêu cầu một phản hồi `answerGuestQuery` duy nhất.
Ví dụ :
```json
{
"channel_list": {
"telegram": {
"enabled": true,
"type": "telegram",
"allow_from": ["123456789"],
"settings": {
"guest_mode": true
}
}
}
}
```
## Định dạng nâng cao
Bạn có thể đặt `use_markdown_v2: true` để bật các tùy chọn định dạng nâng cao. Điều này cho phép bot sử dụng toàn bộ các tính năng của Telegram MarkdownV2, bao gồm các kiểu lồng nhau, spoiler và các khối chiều rộng cố định tùy chỉnh.
@ -47,9 +105,10 @@ Bạn có thể đặt `use_markdown_v2: true` để bật các tùy chọn đ
"telegram": {
"enabled": true,
"type": "telegram",
"token": "YOUR_BOT_TOKEN",
"allow_from": ["YOUR_USER_ID"],
"use_markdown_v2": true
"settings": {
"use_markdown_v2": true
}
}
}
}

75
docs/channels/telegram/README.zh.md
View file

@ -12,10 +12,15 @@ Telegram Channel 通过 Telegram 机器人 API 使用长轮询实现基于机器
"telegram": {
"enabled": true,
"type": "telegram",
"token": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
"allow_from": ["123456789"],
"proxy": "",
"use_markdown_v2": false
"settings": {
"proxy": "",
"use_markdown_v2": false,
"business_mode": false,
"business_owner": "123456789",
"business_commands_enable": false,
"guest_mode": false
}
}
}
}
@ -24,10 +29,13 @@ Telegram Channel 通过 Telegram 机器人 API 使用长轮询实现基于机器
| 字段 | 类型 | 必填 | 描述 |
| ---------------- | ------ | ---- | --------------------------------------------------------- |
| enabled | bool | 是 | 是否启用 Telegram 频道 |
| token | string | 是 | Telegram 机器人 API Token |
| allow_from | array | 否 | 用户ID白名单，空表示允许所有用户 |
| proxy | string | 否 | 连接 Telegram API 的代理 URL (例如 http://127.0.0.1:7890) |
| use_markdown_v2 | bool | 否 | 启用 Telegram MarkdownV2 格式化 |
| settings.proxy | string | 否 | 连接 Telegram API 的代理 URL (例如 http://127.0.0.1:7890) |
| settings.use_markdown_v2 | bool | 否 | 启用 Telegram MarkdownV2 格式化 |
| settings.business_mode | bool | 否 | 启用 Telegram Business 消息处理 |
| settings.business_owner | string | 否 | 需要忽略的 Business 账号所有者 Telegram 用户 ID |
| settings.business_commands_enable | bool | 否 | 允许在 Telegram Business 聊天中处理机器人命令 |
| settings.guest_mode | bool | 否 | 启用 Telegram Guest 消息处理和回复 |
## 设置流程
@ -37,6 +45,56 @@ Telegram Channel 通过 Telegram 机器人 API 使用长轮询实现基于机器
4. 将 Token 填入配置文件中
5. (可选) 配置 `allow_from` 以限制允许互动的用户 ID (可通过 `@userinfobot` 获取 ID)
## Telegram Business Mode
设置 `settings.business_mode: true` 后，PicoClaw 会接收并回复已连接商业账号的 Telegram Business 消息。回复会使用传入的 `business_connection_id`，当机器人具备 `can_read_messages` 权限时，传入的 Business 消息会被标记为已读。
使用 `settings.business_owner` 保存商业账号所有者的 Telegram 用户 ID。来自该用户的 Business 消息会被忽略，避免机器人回复你从已连接商业账号手动发送的消息。
默认情况下，Business 聊天中的机器人命令会被忽略。设置 `settings.business_commands_enable: true` 后，可处理 `/new`、`/help`、`/show`、`/list` 和 `/use`。
示例：
```json
{
"channel_list": {
"telegram": {
"enabled": true,
"type": "telegram",
"allow_from": ["123456789"],
"settings": {
"business_mode": true,
"business_owner": "123456789",
"business_commands_enable": true
}
}
}
}
```
## Telegram Guest Mode
设置 `settings.guest_mode: true` 后，PicoClaw 会接收 `guest_message` 更新，并使用 Telegram 的 `answerGuestQuery` 方法回复。Guest 消息来自机器人未加入的聊天，因此 PicoClaw 会使用传入的 `guest_query_id` 建立独立会话。
当 `settings.guest_mode` 为 `false` 时，PicoClaw 不会请求 Guest 更新，并会忽略任何已解码的 Guest 消息。Guest 回复的占位符和打字指示器会被跳过，因为 Telegram 需要单一的 `answerGuestQuery` 响应。
示例：
```json
{
"channel_list": {
"telegram": {
"enabled": true,
"type": "telegram",
"allow_from": ["123456789"],
"settings": {
"guest_mode": true
}
}
}
}
```
## 内置命令
Telegram 会在启动时自动注册 PicoClaw 的顶级 Bot 命令，包括 `/start`、`/help`、`/show`、`/list` 和 `/use`。
@ -67,9 +125,10 @@ explain how to squash the last 3 commits
"telegram": {
"enabled": true,
"type": "telegram",
"token": "YOUR_BOT_TOKEN",
"allow_from": ["YOUR_USER_ID"],
"use_markdown_v2": true
"settings": {
"use_markdown_v2": true
}
}
}
}