
如何为zclaw接入Telegram机器人手机里随时随地指挥你的ESP32【免费下载链接】zclawYour personal AI assistant at all-in 888KiB (~35KB in app code). Running on an ESP32. GPIO, cron, custom tools, memory, and more.项目地址: https://gitcode.com/gh_mirrors/zc/zclawzclaw是运行在 ESP32 上的超小体积 AI 个人助手全固件不到 888 KiB应用代码仅约 35 KB支持定时任务、GPIO 控制、持久记忆和自定义工具。为 zclaw 接入 Telegram 机器人后你无需守在电脑旁——只要手机上有 Telegram就能用自然语言指挥你的 ESP32查状态、控引脚、设定时任务随时随地。为什么选择 Telegram 作为控制通道zclaw 支持两条聊天通道通道特点Telegram 机器人设备联网后直接对话无需电脑开机最适合日常远程操控️ Web Relay通过宿主机转发串口消息适合本地调试接入 Telegram 的好处很直接免服务器、免内网穿透zclaw 固件内置长轮询long polling主动从 Telegram API 拉取消息设备有 Wi-Fi 即可安全白名单只有配置过的 chat ID 才能发消息控制设备内置控制指令/start、/help、/settings查看状态、/stop暂停接收、/resume恢复接收核心实现在 telegram.c它通过getUpdates接口轮询新消息并由 telegram_poll_policy.c 动态调整轮询节奏以省电。接入前的准备工作开始之前请确认✅ 已完成 zclaw 固件烧录参考 README.md 的 Quick Start✅ 设备能连接 Wi-Fi✅ 已配置好 LLM 提供商Anthropic / OpenAI / OpenRouter / Ollama 任一克隆仓库开始git clone https://gitcode.com/gh_mirrors/zc/zclaw cd zclaw第一步在 Telegram 上创建机器人在 Telegram 中搜索并私信官方机器人BotFather发送/newbot按提示为机器人起名创建成功后BotFather 会回复一串bot token形如123456:ABC-DEF...⚠️保管好这个 token它等同于机器人的管理员权限不要泄露给他人。若怀疑泄露可回到 BotFather 用/revoke吊销并重新生成。第二步获取你的 Chat IDzclaw 通过 chat ID 白名单过滤消息来源因此需要拿到自己的 chat ID在 Telegram 中搜索userinfobot发送任意消息比如/start它会直接回复你的 chat ID如果你和家人共用一个设备可以准备最多4 个chat ID用逗号分隔组成白名单。第三步把凭证写入设备Provisionzclaw 使用 provision.sh 脚本将 Wi-Fi、LLM 和 Telegram 凭证一次性写入设备 NVS 存储全程无需重新烧录固件。非交互式写法推荐参数一目了然./scripts/provision.sh \ --wifi-ssid 你的WiFi名 \ --wifi-password 你的WiFi密码 \ --llm-backend anthropic \ --llm-model claude-3-5-sonnet-latest \ --llm-api-key sk-ant-... \ --tg-token 123456:ABC-DEF... \ --tg-chat-id 8888888交互式写法直接运行./scripts/provision.sh脚本会逐步提示输入 Wi-Fi、LLM 以及可选的 Telegram 字段token 和 chat ID 支持逗号分隔的多个 ID最多 4 个。⚠️ 注意如果只填了 token 没填 chat ID脚本会警告token 已设置但没有白名单收到的消息将被忽略——两者必须同时配置。第四步开始对话验证效果Provision 完成后设备会自动重启联网稍等片刻在 Telegram 里给你的机器人发一句话试试你好现在几点如果一切正常设备会调用 LLM 并回复。之后就可以用自然语言干活了帮我把 GPIO 5 拉高每天早晨 7 点提醒我看天气现在内存还剩多少触发get_diagnostics运行时诊断实用控制指令速查指令作用/start或/help查看帮助信息/settings查看设备当前状态/stop暂停消息接收防止误触/resume恢复消息接收常见问题排查 ️Q1机器人不回消息确认设备已联网且 LLM 凭证正确可用./scripts/monitor.sh /dev/ttyUSB0查看串口日志检查 chat ID 是否与白名单一致Q2本地开发时机器人反复重放旧消息运行清积压脚本即可./scripts/telegram-clear-backlog.sh --show-config详见 telegram-clear-backlog.sh。Q3以后想更换授权的 chat ID无需重烧固件重新运行 provision 即可覆盖./scripts/provision.sh --tg-chat-id 新ID1,新ID2Q4如何撤销 Telegram 机器人回到 BotFather 发送/revoke吊销 token也可以参考 security.html 中的凭证吊销清单一并轮换 Wi-Fi 和 LLM 密钥。Q5网络不稳定时轮询会不会耗电不会。telegram_poll_policy.c 会根据后端类型动态调整轮询超时连续收到过期更新时还会智能暂停轮询平衡响应速度与功耗。进阶Telegram 相关源码与工具想深入了解或二次开发可以看看这些文件telegram.c — 轮询与消息收发主逻辑telegram_update.c — 更新解析telegram_targets.c — 消息目标与白名单管理telegram_token.c — token 存储telegram_chat_ids.c — chat ID 白名单telegram_http_diag.c — HTTP 请求诊断日志security.c — 凭证加密与安全策略小结至此你已经完成zclaw 接入 Telegram 机器人的全部步骤创建机器人 → 获取 chat ID → provision 写入凭证 → 手机随时对话。整个过程不到 5 分钟无需任何服务器让这块 888 KiB 的 AI 助手真正随身可用 更多玩法GPIO 控制、定时任务、自定义工具可继续查阅仓库文档站点 docs-site/ 下的 getting-started.html 与 tools.html。【免费下载链接】zclawYour personal AI assistant at all-in 888KiB (~35KB in app code). Running on an ESP32. GPIO, cron, custom tools, memory, and more.项目地址: https://gitcode.com/gh_mirrors/zc/zclaw创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考