Openclaw Telegram Setup

# OpenClaw Telegram Setup

10 分钟配置 Telegram Bot 作为 OpenClaw 消息渠道。

## 为什么选 Telegram？

- **免费无限制**：消息、文件、多媒体全免费
- **API 开放**：Bot API 简单易用
- **全球可用**：无地域限制
- **功能强大**：支持命令、按钮、Inline 查询

## 快速配置

### Step 1: 创建 Bot

1. 在 Telegram 搜索 `@BotFather`
2. 发送 `/newbot`
3. 按提示设置 Bot 名称
4. 保存返回的 **Token**（格式：`123456789:ABCdefGHI...`）

### Step 2: 获取 Chat ID

```bash
# 方法 1：用你的 Bot 发条消息，然后访问
https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates

# 方法 2：用 @userinfobot 获取你的 ID
```

### Step 3: 配置 OpenClaw

编辑 `~/.openclaw/config.yaml`:

```yaml
plugins:
  entries:
    - plugin: openclaw-telegram
      config:
        botToken: "123456789:ABCdefGHI..."
        allowedChatIds:
          - 123456789  # 你的 Chat ID
```

### Step 4: 启动 Gateway

```bash
openclaw gateway start
```

### Step 5: 测试

在 Telegram 向你的 Bot 发送消息，应该收到 AI 回复。

## 高级功能

### 群组支持

```yaml
plugins:
  entries:
    - plugin: openclaw-telegram
      config:
        botToken: "xxx"
        allowedChatIds:
          - 123456789    # 个人
          - -100123456789  # 群组（负数）
```

### 命令支持

在 BotFather 设置命令：
```
/setcommands
help - 获取帮助
status - 检查状态
clear - 清除对话
```

### Webhook 模式（需要公网服务器）

```yaml
plugins:
  entries:
    - plugin: openclaw-telegram
      config:
        botToken: "xxx"
        webhook:
          url: "https://your-domain.com/telegram/webhook"
          port: 8443
```

## 常见问题

### Q: Bot 不回复
A: 检查 Chat ID 是否正确（正数是个人，负数是群组）

### Q: 提示 "Forbidden: bot was blocked by the user"
A: 你可能之前屏蔽了 Bot，需要先解除屏蔽

### Q: 群组消息无响应
A: 确保 Bot 在群组中，且有读取消息权限

## 成本

- Telegram Bot API：**完全免费**
- OpenClaw Gateway：本地运行，无费用
- AI 模型：按使用量计费（DeepSeek 最便宜）

## 需要帮助？

- 微信：yanghu_ai
- Telegram: @yanghu_openclaw
- 免费远程配置（首次）

---

Version: 1.0.0
Created: 2026-03-21