必须先启动telegram桌面客户端并登录主账号，再执行openclaw onboard选择telegram渠道，点击网页start按钮后发送任意消息触发回调，终端将显示一次性授权码claw-xxxx-xxxx-xxxx。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 macOS 上完成 OpenClaw 的 Telegram 机器人绑定并获取授权码，必须先让 OpenClaw 能通过 Telegram API 与你的账号通信，否则后续所有远程控制、消息推送、跨设备协同功能都将无法启用。这一步不依赖网络代理，但对系统权限和 Telegram 客户端状态极为敏感。
确认 Telegram 桌面客户端已登录且运行中
打开 macOS「访达」→ 进入「应用程序」→ 双击启动 Telegram.app；若图标未出现在菜单栏右上角，说明未成功运行；此时需退出再重开，不能仅靠 Dock 启动。
确保当前登录的是你计划用于绑定的 Telegram 主账号——【OpenClaw 不支持子账号或未验证手机号的测试号】；若使用 Telegram Lite 或第三方客户端（如 Unigram），绑定将直接失败。
启动 OpenClaw 并进入 Telegram 绑定流程
在终端执行：openclaw onboard → 选择 QuickStart → 当提示 “Select communication channel” 时，用方向键选中 Telegram 并回车。
脚本会自动拉起浏览器，跳转至 https://t.me/openclaw_bot?start=xxx 链接（xxx 是一次性配对令牌）；若页面显示 “Sorry, this link is invalid”，说明令牌已过期——请关闭浏览器页，回到终端按 Ctrl+C 中断当前流程，重新执行 openclaw onboard。
在 Telegram 中完成机器人授权
第一步：点击网页中的 “Start” 按钮 → Telegram 会自动跳转到聊天窗口，bot 发送首条欢迎消息；
第二步：在该聊天窗口中，直接发送任意文字（例如 “hi” 或空格），必须发送一次消息才能触发授权回调；不发消息，OpenClaw 后台无法收到 handshake 确认，授权码不会生成；
第三步：返回终端，等待约 8–12 秒，屏幕将输出类似 ✅ Telegram linked. Your auth code: CLAW-7X9K-M2FQ-P4TR 的字符串；该授权码仅显示一次，且 5 分钟后自动失效。
第四步：立即将该授权码复制保存——它将用于后续配置多设备同步、飞书/Slack 渠道桥接，以及恢复备份时的身份核验；【丢失后无法找回，需重新走完整绑定流程】。
