必填，从 BotFather 获取的Token

openclaw 中文openclaw 2026-04-09 2

OpenClaw 是一个开源的大语言模型应用平台，通过配置 Telegram Bot，您可以将其作为便捷的交互入口，整个配置流程主要分为两大步：创建并获取Telegram Bot 和 配置OpenClaw连接该Bot。

必填，从 BotFather 获取的Token-第1张图片-OpenClaw下载中文-AI中文智能体

以下是最核心、最清晰的配置指南：

第一步：创建您的Telegram Bot并获取关键信息

这是与Telegram官方交互的部分。

找到BotFather：
- 在Telegram应用中，搜索 @BotFather (官方机器人)。
创建新机器人：
- 向 @BotFather 发送命令 /newbot。
- 按照提示，依次设置您的机器人的 显示名称 和 用户名，用户名必须以 bot 例如：my_openclaw_bot）。
保存关键令牌：
- 创建成功后，@BotFather 会返回一个重要的 HTTP API Token，格式类似： 1234567890:ABCdefGhIJKlmNoPQRsTUVwxyZ
- 请立即妥善保存此Token，它是您的Bot在代码中的“密码”。切勿泄露给他人。
获取您的Chat ID（用于私聊测试或管理员权限）：
- 在Telegram中，搜索 @userinfobot。
- 向它发送任意消息，它会回复您的 Id，这个数字就是您的 个人Chat ID。

第二步：配置OpenClaw连接Telegram Bot

这部分在您部署OpenClaw的服务器或本地环境上进行。

OpenClaw 通常通过配置文件来管理各种设置，您需要找到并修改其 Telegram 集成部分的配置。

A. 定位配置文件

配置文件通常是 config.toml, config.yaml, .env 或位于 config/ 目录下的特定文件（如 telegram_config.toml），请查阅 OpenClaw 项目的官方文档确认准确位置。

B. 编辑配置（核心步骤）

在配置文件中，找到 Telegram 相关的配置节，并填入第一步获取的信息,最常见的配置项如下：

以 TOML 格式为例：

[telegram]bot_token = "1234567890:ABCdefGhIJKlmNoPQRsTUVwxyZ"
# 可选：Webhook模式配置（适用于有公网IP/域名的服务器）
# webhook_url = "https://your-domain.com/webhook/telegram"
# webhook_port = 8443
# 可选：使用长轮询模式（适用于本地开发或无公网IP，通常更简单）
use_polling = true
# 可选：设置管理员Chat ID，用于接收系统通知或执行管理命令
admin_chat_ids = [987654321]
# 可选：指定哪些Chat ID可以使用Bot，留空或注释掉则允许所有人使用。
# allowed_chat_ids = [987654321, 123456789]
# 通常需要指向您OpenClaw后端API的地址
api_base_url = "http://localhost:8000" # 根据您的实际部署地址修改

关键说明：

bot_token：必须正确填写。
use_polling 与 webhook_url：
- 本地开发/测试：强烈建议设置 use_polling = true，这样Bot会主动向Telegram服务器拉取消息,无需公网地址。
- 服务器部署且有域名：可以使用Webhook模式，性能更好，需要设置有效的 webhook_url（必须是HTTPS）和对应的端口,这通常涉及更复杂的Nginx反向代理和SSL证书配置。
admin_chat_ids：填入您的个人Chat ID,方便管理。

C. 启动/重启OpenClaw服务

保存配置文件。
根据您启动OpenClaw的方式，重启相关服务。
- 如果使用 Docker：docker-compose restart（或重启具体的Bot服务容器）。
- 如果直接运行Python：重启您的应用进程。
- 如果使用系统服务（如 systemd）：sudo systemctl restart openclaw-telegram（服务名可能不同）。

第三步：测试与验证

在Telegram中，找到您刚刚创建的Bot（通过其用户名搜索）。
向它发送 /start 命令。
如果配置正确，您应该会收到来自OpenClaw的欢迎回复，或者至少一个成功的提示（而不是“抱歉，此Bot未启动”等错误）。
尝试发送一个简单问题，如“你好”,看是否能收到由AI生成的回复。

常见问题与排查

Bot 无响应：
- 检查Token：确认 bot_token 完全正确,没有多余空格。
- 检查服务状态：确认OpenClaw的Telegram Bot服务进程确实在运行，且没有报错退出,查看应用日志是首要任务。
- 查看日志：运行 docker logs <container_name> 或在终端查看应用输出，寻找连接Telegram API的错误信息。
- 网络问题：确保您的服务器或本地环境可以正常访问 api.telegram.org。
Webhook 模式失败：
- URL必须是HTTPS：Telegram要求Webhook地址使用SSL加密。
- 端口可访问：确保 webhook_port（默认443或其他）在防火墙已开放,并且没有被其他进程占用。
- 路径正确：OpenClaw后端需要在 webhook_url 指定的路径上处理POST请求。
收到回复但内容不对：
- 检查 api_base_url 是否指向了正确的OpenClaw后端API地址。
- 检查OpenClaw后端的模型配置、知识库连接等是否正常。