mirror of
https://github.com/sipeed/picoclaw.git
synced 2026-06-12 18:08:54 +00:00
Cytown
667fc85d54
add new field type to Channel struct config.channels refactor to channel_list update config version to 3 update the docs
77 lines
2.6 KiB
Markdown
77 lines
2.6 KiB
Markdown
> 返回 [README](../../../README.zh.md)
|
|
|
|
# Telegram
|
|
|
|
Telegram Channel 通过 Telegram 机器人 API 使用长轮询实现基于机器人的通信。它支持文本消息、媒体附件（照片、语音、音频、文档）、语音转录（配置见[提供商与模型配置](../../zh/providers.md#语音转录)），以及内置命令处理器。
|
|
|
|
## 配置
|
|
|
|
```json
|
|
{
|
|
"channel_list": {
|
|
"telegram": {
|
|
"enabled": true,
|
|
"type": "telegram",
|
|
"token": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
|
|
"allow_from": ["123456789"],
|
|
"proxy": "",
|
|
"use_markdown_v2": false
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
| 字段 | 类型 | 必填 | 描述 |
|
|
| ---------------- | ------ | ---- | --------------------------------------------------------- |
|
|
| 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 格式化 |
|
|
|
|
## 设置流程
|
|
|
|
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 git
|
|
explain how to squash the last 3 commits
|
|
```
|
|
|
|
## 高级格式化
|
|
|
|
您可以设置 `use_markdown_v2: true` 来启用增强的格式化选项。这允许机器人使用 Telegram MarkdownV2 的全部功能，包括嵌套样式、剧透和自定义等宽代码块。
|
|
|
|
```json
|
|
{
|
|
"channel_list": {
|
|
"telegram": {
|
|
"enabled": true,
|
|
"type": "telegram",
|
|
"token": "YOUR_BOT_TOKEN",
|
|
"allow_from": ["YOUR_USER_ID"],
|
|
"use_markdown_v2": true
|
|
}
|
|
}
|
|
}
|
|
```
|