Adventure 4：把 AI 装进手机（Telegram 机器人）
Sign in
Adventure 4：把 AI 装进手机（Telegram 机器人）
准备好让你的 AI 助手装进口袋了。本节里，你会把 AI 接到一个聊天软件上，然后从世界任何地方都能控制它。

Adventure 1

本节目标
今天你要掌握的
消息协议
看清即时通讯背后到底是怎么工作的
创建你的机器人
从零搭建一个属于自己的 Telegram 机器人
连上 OpenClaw
把 AI 接进来，让它通过 Telegram 回复你
远程操控
在任何地方都能向你的服务器下达命令

Adventure 1

本节大悬念 🤔
你的 AI 助手住在服务器里，只能通过终端跟它说话。可如果你不在电脑跟前、又想问它一件事呢？
想一想：你在吃饭、在公交上、在和朋友闲逛的时候，怎么和 AI 对话？我们得给它一种走到哪都能联系上的方式。

Adventure 1

为什么要把 AI 装进手机？
问题在哪
现在，你的 AI 助手只能通过电脑里的终端窗口和你交流。也就是说，你必须坐在书桌前才能用上它。可如果你正在：
  • 去上课的路上
  • 和朋友一起吃午饭
  • 在家，但人不在电脑前
  • 在度假，可临时想查一件事
解决方案
给 AI 一个「手机号」，让你像给朋友发消息那样和它聊。这意味着：
  • 随时随地都能用
  • 不需要电脑
  • 秒回
  • 真正的移动能力

Adventure 1

请出 Telegram：AI 的新家
Telegram 是一款和 WhatsApp、微信差不多的聊天软件，但它有一项超能力：对开发者开放。和那些封闭的平台不同，Telegram 允许你创建「机器人」——一种能自动收发消息的程序。
把机器人想象成一位从不睡觉、永远秒回、还会帮你自动办事的机器朋友。你的 AI 即将变成这样的一员。

Adventure 1

为什么是 Telegram？ 🤖
开放平台
和微信、WhatsApp 不一样，Telegram 用开放 API 欢迎开发者。也就是说你不需要特殊许可，就能搭出自己的机器人。
强大的 Bot API
Telegram 给开发者准备了一整套工具。你可以让 bot 发送消息、图片、按钮，甚至自定义键盘。
完全免费
创建和运行 bot 都不收费。不用绑卡、不用订阅，纯粹的构建自由。

Adventure 1

讨论时间
💬 想—配对—分享
独立思考（1 分钟）
如果你不在电脑前，最想问 AI 哪三件事？
配对讨论（2 分钟）
和搭档分享你的想法。哪些最实用？哪些最有创意？
全班分享（2 分钟）
听听大家的想法。一个能装进口袋的 AI 助手，能为你做什么？

Adventure 1

Bot 到底是什么？ 🤖
Bot 其实就是一段能自动收发消息的程序。它就像一位永远在线的助手：
  • 从不睡觉，也不会请假
  • 消息一来就回
  • 可以被编程去做特定的事
  • 同时和很多人对话毫无压力
Telegram 上的 bot 能答疑、能定提醒、能玩游戏、能播新闻，等等。你的 AI 马上就要加入这个队伍。

Adventure 1

第二幕：动手做
创建你的 Telegram 机器人
好玩的部分来了——亲手做一个 bot！别紧张，Telegram 把这件事做得意外地简单。这一步你不用写复杂代码，只要和一个叫 BotFather 的特殊 bot 聊几句就行——它的工作就是替你造 bot。
把 BotFather 想成一位「bot 工厂厂长」：你告诉他你想要什么，他帮你造出来。

Adventure 1

认识 BotFather 👨‍💼
Bot 缔造者
BotFather 是 Telegram 官方提供的、专门用来造 bot 的 bot。从 2015 年起，他已经造出了数百万个机器人。
你和 BotFather 的互动方式就像和朋友聊天：他问，你答。聊完之后，他会发给你一段特殊的代码——叫做 API Token。

冷知识： BotFather 只听以斜杠（/）开头的命令。这是你告诉他「我要做某件具体的事」的方式。

Adventure 1

一步步创建你的 bot 🛠️
01
找到 BotFather
打开 Telegram，在搜索框输入 @BotFather。他带着蓝色的官方认证勾。
02
开启对话
点「Start」，或者直接发送 /newbot 命令，开始创建你的 bot。
03
起一个名字
起一个亲切的显示名字，比如「Ethan's AI Assistant」——这是别人会看到的名字。
04
起一个用户名
选一个以「bot」结尾的独特用户名，比如「ethan_ai_bot」——别人通过它来找到你的 bot。
05
拿到你的 token
BotFather 会发给你一个 API Token——一长串字母和数字组成的字符串。务必好好保存。

Adventure 1

动手做
🎯 活动 1：创建你的 bot（10 分钟）
你的任务： 马上创建一个属于你自己的 Telegram bot。
  1. 在手机或电脑上打开 Telegram
  1. 搜索 @BotFather
  1. 按上一页的步骤走一遍
  1. 把你 bot 的 用户名 和 API Token
  1. 记下来。完成后给同桌看看。

教师检查： 在教室里走动，帮卡住的同学。确保每位同学都把 API Token 存好了。

Adventure 1

⚠️ 重要的安全提醒
你的 API Token 等同于密码！
BotFather 发给你的 API Token 极其重要——它就是你 bot 那扇门的钥匙。任何拿到它的人，都能：
  • 假冒你的 bot 发消息
  • 看到所有和你 bot 的对话
  • 改你 bot 的设置
  • 造成各种麻烦
黄金法则： 永远不要把 API Token 给别人。别贴到网上，别发在群里，也别让它出现在截图里。

Adventure 1

Token 该放在哪里 🔐
✅ 可以放的地方
  • 密码管理器里
  • 手机的私密备忘录里
  • 你的 OpenClaw 配置文件里
  • 私人本子里
❌ 千万不要放的地方
  • 发到社交平台
  • 塞进一个公开的 GitHub 仓库
  • 丢进群聊
  • 邮件给朋友
万一不小心泄露了，可以用 BotFather 的 /revoke 命令吊销旧 token，再生成一个新的。

Adventure 1

知识检查
🧠 苏格拉底式提问
继续往下之前，先确认每个人都掌握了基本概念。和同伴讨论：
你觉得 Telegram 为什么给 bot 用 token，而不是密码？
在「能不能造 bot」这件事上，Telegram 和微信这样的 app 有什么不同？
如果有人拿到你的 token，最糟能搞出什么事？

Adventure 1

第三幕：连接
把 OpenClaw 连到 Telegram
你已经有了一个 bot，现在该给它装上大脑了。我们要把 Telegram bot 连到 OpenClaw，让 AI 能读消息、能聪明地回应。
魔法就发生在这一刻——你的 AI 会从一个只能在终端里跑的程序，变成你随时随地都能聊天的移动助手。

Adventure 1

配置 OpenClaw 🔧
把 OpenClaw 接到 Telegram 极其简单——一条命令搞定。打开终端运行：
openclaw config

Local->channels->configure/link->telegram->input bot token-> finish



* Search your bot using the bot's username

* send a message /start

* receive the pairing code



openclaw pairing approve telegram [Paring code]

小贴士： 在添加平台之前，先确认 OpenClaw 服务器在运行。

Adventure 1

测试你的连接 🧪
找到你的 bot
打开 Telegram，搜索你 bot 的用户名（以「bot」结尾的那个）
发一条消息
输入一句简单的问候，比如「Hello」或「你好」，发出去
观察日志
看看服务器终端——你应该能看到消息已经被接收的记录
拿到回复
几秒之内你的 bot 就该回复你。回了——就成了。

Adventure 1

动手做
🎯 活动 2：测试你的 bot（5 分钟）
你的任务： 让你的 bot 真的对消息做出回应。
  1. 先确认 OpenClaw 在服务器上运行
  1. 运行 openclaw platform add telegram 命令
  1. 提示时输入你的 API Token
  1. 在 Telegram 里找到你的 bot
  1. 发一条消息，等它回复
成功标准： 你的 bot 回了消息。截个图作证。

Adventure 1

这背后的魔法是怎么回事？ ✨
我们来理一下你的消息从手机到 AI、再回到手机的整段旅程：
OpenClaw 收到
转发到云端
服务器接收
Telegram 发出
你输入
整段旅程发生在 1 秒之内。你的消息穿过互联网、被 AI 处理、然后几乎瞬间回到你手上。

Adventure 1

技术上的旅程 🛤️
逐步拆解
  1. 你输入： 消息从你的手机出发
  1. 加密发送： Telegram 把消息加密后送出
  1. 服务器路由： Telegram 的服务器识别出你的 bot
  1. API 调用： Telegram 把消息送到你的服务器
  1. OpenClaw 接收： 你的服务器接住进来的消息
  1. AI 思考： AI 处理你的问题
  1. 返回响应： OpenClaw 把回复送回 Telegram
  1. 你收到： 答案出现在你的手机上

Adventure 1

讨论时间
💬 理解检查
和同伴互相解释：
为什么消息先到 Telegram 的服务器，而不是直接到你的 bot？
如果 OpenClaw 服务器在别人发消息那一刻崩溃了，会怎样？
想一想：在这套系统里，哪些环节可能产生延迟？
分享： 你和同伴发现了什么？

Adventure 1

第四幕：远程超能力
解锁远程操控的魔法
你现在拥有超能力了。 🦸
AI 连上 Telegram 之后，你能做到一件神奇的事：从世界任何地方操控你的服务器。只要有网，你就能让 AI 替你做事。

Adventure 1

你能下达什么命令？ 🎮
获取信息
问天气、看新闻摘要、查搜索结果——AI 替你抓数据。
查服务器状态
远程查看磁盘空间、CPU 占用、正在运行的进程。
好玩的互动
讲笑话、玩文字游戏，或者就是和你的 AI 伙伴聊天。

Adventure 1

可以试一试的命令 💬
实用类命令
What's the weather in Beijing?



Check disk space on server



What's my server's IP address?



Show running processes



Check if port 8080 is open
趣味类命令
Tell me a joke



What's the meaning of life?



Recommend a movie



Translate "hello" to Spanish



Write a haiku about coding
可能性是无限的——只要你教过它，AI 都能做。

Adventure 1

真正的考验：动起来！ 📱
酷的地方来了。我们来验证一下：远程操控真的能用。
  1. 先确认你的 bot 连得上、能回复
  1. 站起来，走出教室（先获得允许）
  1. 在走廊里给你的 bot 发一条消息
  1. 等回复
  1. 回到教室，分享你的体验
「你已经走出了楼，AI 却可能在几千公里外的某个机房里。可你们仍在实时对话——这就是远程操控的力量。」

Adventure 1

现实中的应用
为什么远程操控很重要 🌍
系统管理
专业系统管理员就用类似的工具，从家里、咖啡馆、甚至度假地管理服务器。
告警与监控
服务器出问题时，无论你在哪儿都能立刻收到通知。
私人助理
搭一个真正能跟你走的 AI 助手——帮你写作业、提醒事项、随手解答。
团队协作
多人可以和同一个 bot 互动，特别适合小组项目和共享任务。

Adventure 1

🎓 核心概念：客户端–服务器模型
你刚搭起来的这套东西，背后是计算机世界里一个最基础的模式： 客户端–服务器模型:
  • 客户端： 你的手机（发起请求）
  • 服务器： 你的云端机器（提供响应）
  • 协议： Telegram API（它们之间说的语言）
网站、游戏、app，绝大部分互联网都建立在这套模式上。理解它，对每一个开发者都至关重要。

Adventure 1

小组讨论
💭 想得更大：还能接到哪里？
Telegram 已经接好了，但它不是唯一的聊天平台。我们一起头脑风暴：
1
Discord
在游戏社群里非常流行——你的 AI 能不能进 Discord 服务器？
2
Slack
公司里常用的协作工具——想象一下，团队里多了一位 AI 同事。
3
WhatsApp
限制更多，但用户量巨大——有没有什么巧妙的变通办法？
4
WeChat
在中国体量极大、API 却很封闭——其中的挑战和机会在哪里？
讨论： 对你最有用的会是哪个平台？你会在上面做点什么？

Adventure 1

⚠️ 常见错误与修复方法
如果没一次跑通也别慌。下面是同学们最常碰到的问题和解决办法：

Adventure 1

排错指南 🔧
问题：bot 不回消息
可能原因： Token 输错了、OpenClaw 服务器没在跑、或者网络有问题。
修复： 再次确认 token 前后没有多余空格；重启 OpenClaw；检查你的网络连接。
问题：出现「Unauthorized」错误
原因： API token 错了，或者已经被吊销。
修复： 用 /token 命令找 BotFather 拿一个新 token，或者干脆重新建一个 bot。
问题：回复很慢
原因： 可能是服务器过载、网络慢，或 AI 在处理复杂请求。
修复： 检查一下服务器资源；先用简单问题试试；重启一下平台连接。
问题：搜索框里找不到 bot
原因： 用户名输错了，或者 bot 还没创建完成。
修复： 对照确认完整用户名（包括「_bot」结尾）。也可以直接点 BotFather 给你的链接。

Adventure 1

排错技巧 🐛
专业的排错步骤
  1. 查看日志： 在终端输出里找报错信息
  1. 单独测试： 对一句简单的「hi」，bot 会回吗？
  1. 校验凭据： 你的 token 是不是正确、且仍然有效？
  1. 重启服务： 有时候来一次干净的重启就能解决一堆怪问题
  1. 向人求助： 把你试过的步骤说给同学听——往往讲一遍就想通了。

Adventure 1

小测验
📝 知识检查小测
检验一下你学到了什么。回答下面 5 道题：

Adventure 1

测验题目
1
API Token 是什么？
A）你 bot 的用户名
B）一段允许程序访问你 bot 的秘密代码
C）一种加密货币
D）一个 Telegram 手机号
2
BotFather 是谁？
A）Telegram 的 CEO
B）一位专门造 bot 的真人
C）Telegram 官方提供的、用于创建其他 bot 的 bot
D）一个调试工具
3
用哪条命令把 Telegram 加到 OpenClaw 里？
A）openclaw install telegram
B）openclaw platform add telegram
C）telegram connect openclaw
D）add-platform --telegram
4
为什么 bot 的用户名必须以「bot」结尾？
A）这是 Telegram 的规定，方便一眼识别
B）BotFather 随机要求的
C）这样 bot 跑得更快
D）只是建议，不是强制
5
如果有人拿到你的 API Token，会怎样？
A）没事，它本来就是公开信息
B）对方能操控你的 bot，看到所有消息
C）你的手机会被黑
D）bot 会停止工作

Adventure 1

答案 📋
1
答案：B —— 一段允许程序访问你 bot 的秘密代码
API Token 就像一把钥匙：证明你是 bot 的主人，并允许程序操控它。
2
答案：C —— Telegram 官方用于创建其他 bot 的 bot
BotFather 是 Telegram 专门做的一个 bot，用来帮你创建和管理自己的 bot。
3
答案：B —— openclaw platform add telegram
这是把 OpenClaw 接到 Telegram 的正确命令。
4
答案：A —— 这是 Telegram 的规则，方便一眼识别
Telegram 要求 bot 用户名以「bot」结尾，这样用户能一眼分辨 bot 和普通账号。
5
答案：B —— 对方能操控你的 bot 并读取消息
所以安全才这么要紧——拿到 token 的人能完整冒充你的 bot。

Adventure 1

成就解锁
🏆 恭喜！
你做到了！
📱 移动指挥官
你现在能在任何地方用手机操控 AI
🤖 Bot 大师
你亲手创建并配置好了自己的 Telegram bot
🌐 远程操控专家
你理解了客户端–服务器通信和远程访问

Adventure 1

💼 课后挑战
继续探索、继续动手。本周的几个任务：
1
多样化测试
给你的 bot 发至少 10 种不同类型的问题，记录哪一类回答得最好
2
教别人一遍
向家人或朋友讲讲你的 AI bot 是怎么工作的——教是最好的学。
3
探索更多命令
查一查 AI 在 Telegram 里还能处理哪些命令
4
大胆做梦
写下 3 个你希望 bot 拥有的新功能——以后我们可能真的去做。

Adventure 1

🔮 预告：下一节
Adventure 5：自动化
现在你的 bot 只在你发消息时才反应。可如果它能自动干活呢？
下一节你会学到怎样：
  • 把任务安排到指定时间运行
  • 搭一套自动告警的监控
  • 创建不需要你介入也能触发的工作流
  • 做出一个会主动帮你的真正智能的助手
想象一下：每天早上醒来收到一份天气简报，服务器需要关注时自动给你提醒——全部自动完成。

Adventure 1

反思时间
🤔 离堂作业
下课前，花 3 分钟回顾一下，写下：
一件让你意外的收获
一件你还困惑、或想深入的内容
一个你能在课外用上这门手艺的场景
把回答分享给全班，或交给老师。你诚实的反馈能让大家一起进步。

Adventure 1

你正在掌握真正的技能！ 💪
今天你不只是照着说明走——你做出了一件真东西，正是专业人士每天在用的。今天涉及到的概念有：
  • 客户端–服务器架构
  • API 认证
  • 安全最佳实践
  • 远程系统管理
  • 实时消息协议
这些不只是课堂概念——它们是现代技术的地基。Google、Facebook，乃至每一家初创公司，都在用同一套原理。
继续搭、继续学、继续创造让人眼前一亮的东西。
Adventure 5 见！ 🚀

Adventure 1