> 返回 [README](../../../README.zh.md)

# Telegram

Telegram Channel 通过 Telegram 机器人 API 使用长轮询实现基于机器人的通信。它支持文本消息、媒体附件（照片、语音、音频、文档）、语音转录（配置见[提供商与模型配置](../../zh/providers.md#语音转录)），以及内置命令处理器。

## 配置

```json
{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
      "allow_from": ["123456789"],
      "proxy": ""
    }
  }
}
```

| 字段       | 类型   | 必填 | 描述                                                      |
| ---------- | ------ | ---- | --------------------------------------------------------- |
| enabled    | bool   | 是   | 是否启用 Telegram 频道                                    |
| token      | string | 是   | Telegram 机器人 API Token                                 |
| allow_from | array  | 否   | 用户ID白名单，空表示允许所有用户                          |
| proxy      | string | 否   | 连接 Telegram API 的代理 URL (例如 http://127.0.0.1:7890) |

## 设置流程

1. 在 Telegram 中搜索 `@BotFather`
2. 发送 `/newbot` 命令并按照提示创建新机器人
3. 获取 HTTP API Token
4. 将 Token 填入配置文件中
5. (可选) 配置 `allow_from` 以限制允许互动的用户 ID (可通过 `@userinfobot` 获取 ID)

## 内置命令

Telegram 会在启动时自动注册 PicoClaw 的顶级 Bot 命令，包括 `/start`、`/help`、`/show`、`/list` 和 `/use`。

与技能相关的命令：

- `/list skills`：列出当前 Agent 可见的已安装技能。
- `/use <skill> <message>`：只在本次请求中强制使用指定技能。
- `/use <skill>`：为同一聊天中的下一条消息预先启用该技能。
- `/use clear`：清除待应用的技能覆盖。

示例：

```text
/list skills
/use git explain how to squash the last 3 commits
/use italiapersonalfinance
dammi le ultime news
```