OpenClaw LaunchOpenClaw Launch
← 首页

Telegram 机器人

OpenClaw Telegram 机器人完整教程

从零开始创建你的 Telegram AI 助手 — 支持 GPT、Claude、Gemini、DeepSeek、Kimi 等多模型，3200+ Skills，24/7 全天候在线。

什么是 Telegram AI 机器人？

Telegram 机器人（Bot）是运行在 Telegram 平台上的自动化程序。通过 Telegram 的官方 Bot API，开发者可以创建能够接收和回复消息的机器人。结合 OpenClaw 框架，你可以将 GPT-4o、Claude、Gemini、DeepSeek、Kimi 等顶级AI模型接入 Telegram，打造一个功能强大的私人AI助手。

与微信机器人不同，Telegram 提供了完善的官方 Bot API，创建和运行机器人完全合规，零封号风险。Telegram 也是全球最流行的AI机器人平台，拥有数百万活跃的AI Bot。

为什么选择 OpenClaw 做 Telegram 机器人？

  • 多模型支持 — 不绑定单一AI。GPT-4o、Claude Sonnet、Gemini Pro、DeepSeek V3、Kimi（月之暗面）、Llama、Mistral 等数十种模型自由切换。
  • 3,200+ Skills — 社区贡献的Skills 库，涵盖网页搜索、图片生成、文件处理、代码执行、数据分析、翻译、日程管理等。
  • 24/7 全天候在线 — 托管在云端，机器人永远在线，随时响应消息。
  • Pairing 安全机制 — OpenClaw 默认使用配对（pairing）模式，只有经过配对认证的用户才能使用你的机器人，防止被陌生人滥用。
  • 会话隔离 — 每个 Telegram 用户独立会话，互不干扰，上下文完整保留。
  • 开源免费 — OpenClaw 核心框架 MIT 开源，GitHub 270,000+ Star。

第一步：通过 @BotFather 创建 Telegram 机器人

所有 Telegram 机器人都通过 @BotFather 创建。BotFather 是 Telegram 官方提供的机器人管理工具。以下是详细步骤：

1. 打开 Telegram 搜索 @BotFather

在 Telegram 客户端（手机或电脑均可）的搜索栏中输入 @BotFather，点击进入官方机器人管理账号。BotFather 是 Telegram 唯一的官方机器人创建工具，带有蓝色认证标志。

2. 发送 /newbot 创建新机器人

在与 BotFather 的对话中发送 /newbot 命令。BotFather 会要求你输入机器人的显示名称（name），可以是中文，例如"我的AI助手"。

3. 设置机器人用户名

接下来 BotFather 会让你设置机器人的用户名（username）。用户名必须以 bot 结尾，只能用英文字母、数字和下划线，例如 my_ai_helper_bot。用户名全局唯一，如果已被占用需要换一个。

4. 获取 Bot Token

创建成功后，BotFather 会发给你一串形如 7123456789:AAHxxxxxxx 的 Token。这就是你的机器人凭证，务必妥善保管，不要分享给他人。拥有 Token 就能完全控制你的机器人。

耗时：不到2分钟。创建完成后，你的机器人就存在于 Telegram 上了，但此时它还不会回复任何消息 — 需要连接 AI 后端。

第二步（推荐）：通过 OpenClaw Launch 10秒部署

OpenClaw Launch 是 OpenClaw 的官方托管平台。无需服务器、无需 Docker、无需手写配置文件，可视化界面完成全部设置，一键部署。

1. 打开 OpenClaw Launch

访问 openclawlaunch.com，注册或登录账号。支持 Google、GitHub 一键登录，也支持邮箱注册。

2. 选择 Telegram 平台

在可视化配置器中，选择聊天平台为 Telegram，将刚才从 BotFather 获取的 Bot Token 填入对应字段。

3. 选择 AI 模型

选择你想使用的AI模型：Claude（Anthropic）、GPT（OpenAI）、Gemini（Google）、DeepSeek、Kimi（月之暗面）等。OpenClaw Launch 通过 OpenRouter 统一接入，无需单独注册各模型平台。

4. 点击部署

点击"Deploy"按钮，10秒内你的 Telegram AI 机器人就上线了。回到 Telegram，找到你的机器人，发送一条消息试试。

耗时：10秒（不含注册时间）。你的 Telegram AI 机器人即刻上线，支持文本对话、图片生成、网页搜索、文件处理等全部功能。

第二步（DIY）：通过 Docker 自建部署

如果你更喜欢自己管理服务器，也可以通过 Docker 手动部署 OpenClaw。这种方式需要一定的技术基础，包括服务器运维、Docker 操作和 JSON 配置文件编写。

完整的 Docker 自建教程请参考 OpenClaw 安装部署教程，包含服务器选择、Docker 安装、配置文件编写、HTTPS 设置等全部步骤。

Telegram 相关的关键配置项：

  • channels.telegram.botToken — 填入 BotFather 给你的 Token
  • channels.telegram.dmPolicy — 设为 "pairing"（推荐），只有配对用户才能使用
  • plugins.entries.telegram.enabled — 必须设为 true，否则 Telegram 插件不会启动
  • agents.defaults.model.primary — AI模型选择，需要加上提供商前缀
预计耗时：2-6小时。需要服务器、Docker 经验和手动配置 JSON。详见 完整安装教程。

两种部署方案对比

OpenClaw LaunchDocker 自建
部署时间10秒2-6小时
技术要求零基础即可需要 Docker + Linux 经验
服务器不需要（全托管）需要云服务器或本地机器
配置方式可视化编辑器手写 JSON 配置文件
SSL / HTTPS自动处理手动配置 Caddy 或 Nginx
自动重启内置需配置 PM2 或 systemd
费用$3/月起（支持支付宝/微信）$5-20/月（云服务器）+ 维护时间
版本更新自动更新手动拉取镜像并重启

核心功能详解

多模型自由切换

OpenClaw 不绑定单一AI提供商。你可以随时切换底层模型，无需重新部署：

  • GPT-4o / GPT-4o-mini（OpenAI）— 综合能力最强的通用模型
  • Claude Sonnet / Claude Haiku（Anthropic）— 长文本理解和代码生成能力出色
  • Gemini Pro / Gemini Flash（Google）— 多模态能力强，支持图片理解
  • DeepSeek V3 / DeepSeek R1 — 国产模型，中文理解能力优秀，性价比高
  • Kimi（月之暗面）— 超长上下文窗口，适合处理长文档
  • Llama / Mistral / Qwen — 开源模型，通过 OpenRouter 接入

3,200+ 社区 Skills

OpenClaw 拥有庞大的Skills生态系统，让你的 Telegram 机器人不仅仅是聊天：

  • 网页搜索 — 实时搜索互联网，获取最新信息
  • 图片生成 — 通过 DALL-E、Stable Diffusion 等生成图片
  • 文件处理 — 阅读 PDF、Word、Excel 等文档
  • 代码执行 — 运行 Python、JavaScript 等代码
  • 数据分析 — 分析数据、生成图表
  • 翻译 — 多语言实时翻译
  • 日程管理 — 设置提醒和待办事项

Pairing 安全配对机制

OpenClaw 默认使用 Pairing（配对）安全模式。这意味着：

  • 机器人创建后，陌生人无法直接使用
  • 用户需要通过网关（Gateway）完成配对认证
  • 只有配对成功的用户才能与机器人对话
  • 有效防止机器人被他人滥用，保护你的 API 额度

在 OpenClaw Launch 上，配对流程完全自动化 — 部署完成后你会自动完成配对，无需额外操作。

Telegram Bot 設定详解

完成基础部署后，以下是影响机器人行为最关键的几项設定。无论你使用 OpenClaw Launch 还是 Docker 自建，理解这些配置项都能帮助你快速排查问题。

dmPolicy 設定：控制谁可以使用你的机器人

dmPolicy 是最重要的安全設定，决定哪些用户能向机器人发消息：

  • pairing（推荐） — 用户必须先通过网关完成配对认证，才能使用机器人。有效防止陌生人滥用你的 API 额度。OpenClaw 默认使用此模式，也是我们强烈推荐的設定。
  • open（不推荐） — 任何人都可以直接向机器人发消息。仅适合面向公众的机器人，风险是 API 额度可能被大量消耗。

在 OpenClaw Launch 的可视化配置器中，dmPolicy 设为 pairing 即可，无需手写 JSON。

配对流程（Pairing Flow）

使用 pairing 模式时，新用户的配对步骤如下：

1. 用户向机器人发送任意消息

机器人会回复一条提示，告知用户需要先完成配对认证。

2. 用户打开 OpenClaw 网关（Gateway）

机器人回复中包含网关链接。用户点击链接，进入 OpenClaw 控制面板。

3. 在网关中批准配对请求

机器人拥有者（你）在网关中看到配对请求，点击批准。或者设置为允许用户自动完成配对，无需人工审批。

4. 配对完成，开始对话

配对成功后，用户可以正常与机器人对话。配对信息持久保存，不需要重复配对。

使用 OpenClaw Launch 部署时，你（机器人拥有者）的配对在部署完成后自动完成，无需额外操作。

常见設定问题排查

  • 机器人没有回复消息 — 检查 Bot Token 是否正确填入，确认 plugins.entries.telegram.enabled 设为 true。使用 OpenClaw Launch 时在仪表盘查看实例状态是否为"运行中"。
  • 发消息后机器人要求配对但没有链接 — 这是 dmPolicy: "pairing" 的正常行为。需要登录 OpenClaw 网关完成配对。确认实例的网关 URL 可以正常访问。
  • 配对后仍然无法对话 — 检查 AI 模型的 API Key 是否正确配置，确认 OpenRouter 或对应模型平台账户有余额。
  • 机器人在群聊中不响应 — 需要在 BotFather 中将 Group Privacy 設定为 Disable（/setprivacy → Disable），让机器人能接收群聊中的所有消息。
  • 切换 AI 模型后没有生效 — 在 OpenClaw Launch 仪表盘保存配置后需要等待几秒热加载。如果是 Docker 自建，修改配置文件后 OpenClaw 支持热重载，通常无需重启容器。

中国用户注意事项

Telegram 使用

Telegram 在中国大陆需要通过代理访问。在手机上使用代理工具后即可正常使用 Telegram 客户端和机器人。机器人本身运行在 OpenClaw Launch 的海外服务器上，不受网络限制。

API 代理配置

如果你选择 Docker 自建部署在国内服务器上，需要注意：

  • AI模型 API（OpenAI、Anthropic、Google）需要能够从服务器访问
  • 国内云服务器可能需要配置 HTTP 代理
  • 使用 OpenClaw Launch 则无需担心网络问题 — 服务器在海外，直连所有 API

Bot Token 安全

Bot Token 是机器人的唯一凭证，请务必注意：

  • 不要将 Token 发布到公开的代码仓库、论坛或群聊中
  • 如果 Token 泄露，立即在 BotFather 中使用 /revoke 命令重新生成
  • OpenClaw Launch 对 Token 进行加密存储，安全有保障

支付方式

OpenClaw Launch 支持支付宝和微信支付，中国用户可以方便地完成订阅。月费 $3 起，无需信用卡。

常见问题

创建 Telegram 机器人需要付费吗？

创建机器人本身完全免费。通过 @BotFather 创建机器人不收取任何费用。费用来自AI模型调用 — 使用 OpenClaw Launch 托管，月费 $3 起，包含所有基础设施费用。

一个账号可以创建多少个机器人？

Telegram 允许每个账号创建最多 20 个机器人。在 OpenClaw Launch 上，每个订阅对应一个运行实例，如果需要多个机器人可以创建多个实例。

机器人可以在群聊中使用吗？

可以。将机器人添加到 Telegram 群组后，它可以响应群聊消息。在 BotFather 中设置 /setjoingroups 为 Enable 即可允许机器人加入群组。OpenClaw 支持群聊场景，每个用户的会话独立隔离。

如何更换 AI 模型？

在 OpenClaw Launch 仪表盘中，进入实例设置，切换模型即可，无需重新部署。如果是 Docker 自建，修改配置文件中的 agents.defaults.model.primary 字段，OpenClaw 支持热加载，无需重启容器。

立即创建你的 Telegram AI 机器人

只需一个 Bot Token，10秒部署。支持 GPT、Claude、Gemini、DeepSeek 等所有主流模型。

开始部署
OpenClaw Telegram 机器人設定教程 — 10秒创建AI Bot | OpenClaw Launch