mirror of
https://github.com/sipeed/picoclaw.git
synced 2026-06-12 18:08:54 +00:00
Mauro
56 lines
2.0 KiB
Markdown
56 lines
2.0 KiB
Markdown
> 返回 [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
|
|
```
|