《OpenClaw入门实战》第六章

第六章：手机远程控制Telegram/钉钉接入实战《OpenClaw入门实战》第六章讲师：王老师（OpenClaw社区贡献者）本章目录01.远程控制原理|多通道集成架构解析02.实战接入：TelegramBot|配置与使用指南03.实战接入：钉钉机器人|配置与使用指南04.备选方案：ClawApp|手机H5客户端体验05.常见问题排查|远程接入失败怎么办？远程控制原理：多通道集成架构解析核心原理：Gateway统一路由OpenClaw通过Gateway作为消息统一路由中心，解耦了Web、Telegram、钉钉等通信渠道，实现指令的集中处理与分发。工作流程：端到端执行闭环1.用户发起指令

通过手机端Telegram或钉钉发送自然语言指令。2.消息转发与解析

指令经Gateway汇聚，调用大模型(LLM)理解意图。3.执行与反馈

AgentRunner执行具体技能，结果原路返回至手机端。OpenClaw多通道集成架构流程图方案对比：TelegramBotvs钉钉机器人TelegramBot(个人/海外)配置难度：简单快捷无需公网IP，几步即可完成部署网络要求：需科学上网国内访问受限，适合海外环境安全性：基础限制主要通过配置ALLOWED_USER_IDS限制功能丰富度：高支持图片、文件、按钮等丰富交互适用场景：个人/海外用户追求简单快捷，轻量级使用钉钉机器人(企业/国内)配置难度：相对复杂需HTTPS公网回调地址，配置项较多网络要求：国内直连国内网络环境非常稳定，无访问限制安全性：高支持IP白名单、消息加签等多重机制功能丰富度：基础主要以文本消息交互为主，相对单一适用场景：企业/国内办公对数据安全性要求高，团队协作场景实战接入：TelegramBot配置（步骤1）1.搜索并找到@BotFather在Telegram搜索框输入@BotFather，找到官方机器人并进入聊天界面。2.发送创建命令发送/newbot命令，按照提示开始创建新的机器人。3.设置名称与用户名设置显示名称（中文/英文），并设置以bot结尾的唯一用户名。4.获取并保存APITokenBotFather返回的长字符串即为Token，这是Bot的唯一凭证，务必妥善保存。实战接入：TelegramBot配置（步骤2）01.安装TelegramSkill打开终端，执行以下命令完成技能包安装：openclawskillsinstalltelegram02.配置BotToken(关键步骤)替换"你的BotToken"为实际值，并启用渠道：openclawconfigsetchannels.telegram.botToken"你的BotToken"openclawconfigsetchannels.telegram.enabledtrue实战接入：TelegramBot配置（步骤3）01.获取你的用户ID(关键步骤)在Telegram搜索@userinfobot，发送任意消息即可获取你的数字ID。02.配置允许的用户IDopenclawconfigsetchannels.telegram.allowedUserIds"你的ID"03.重启Gateway服务openclawgatewayrestart安全提示：请务必正确配置allowedUserIds，这是防止未授权访问的最后一道防线。如果跳过此步，任何人都可能控制你的设备。实战接入：TelegramBot测试发送测试指令简单对话测试发送“你好”，验证基础响应能力文件操作指令发送“帮我看看桌面上有哪些文件”定时任务指令发送“20分钟后提醒我休息一下”预期交互结果如果配置正确，Bot会立刻响应指令。例如：成功列出桌面文件列表，或确认提醒设置。这标志着您已成功通过手机远程控制AI助理。实战接入：钉钉机器人配置（步骤1）配置目标在钉钉开发者后台创建自定义机器人应用，并获取访问密钥(ClientID/Secret)。操作步骤1.访问后台并登录访问，使用钉钉账号登录。2.创建企业内部应用点击“创建应用”，选择“企业内部应用”，类型选“机器人”。3.填写基本信息完善应用名称、描述等信息，完成创建。4.获取并保存密钥在“凭证与基础信息”中找到ClientID/Secret，务必妥善保存。实战接入：钉钉机器人配置（步骤2）1.安装并启用钉钉插件openclawpluginsinstallclawdbot-dingtalkopenclawpluginsenableclawdbot-dingtalk2.配置ClientID与Secretopenclawconfigsetchannels.dingtalk.enabledtrueopenclawconfigsetchannels.dingtalk.clientId"你的ID"openclawconfigsetchannels.dingtalk.clientSecret"你的密钥"终端操作示意图实战接入：钉钉机器人配置（步骤3）01.生成公网HTTPS地址(ngrok)钉钉要求公网HTTPS地址。本地开发使用ngrok映射本地18789端口到公网：$ngrokhttp1878902.配置钉钉回调地址在“事件与回调”页面，将ngrok生成的地址加上路径/webhook/dingtalk填入“消息接收地址”。示例：https://abcdef.ngrok.io/webhook/dingtalk03.订阅事件与验证订阅“机器人收到消息”事件，并完成加签验证，确保服务器能正常接收钉钉推送。实战接入：钉钉机器人测试发送测试指令将机器人添加至钉钉群后，@机器人并发送指令：问候指令：“你好”功能指令：“帮我查询今天的天气”验证预期结果若配置正确，机器人会在群内自动回复消息，例如返回实时天气情况。备选方案：ClawApp手机H5客户端极简部署方案无需配置Bot，仅需Docker即可在电脑部署，通过手机浏览器直接访问。轻量、开源、即开即用。四步快速部署克隆代码：gitclone/qingchencloud/clawapp.git配置环境：创建.env文件，设置连接密码与Token启动服务：dockercomposeup-d--build手机访问：浏览器输入IP:3210，输入密码即可使用客户端界面预览互动实操：配置TelegramBot并远程控制电脑操作步骤(Step-by-Step)1.创建Bot通过@BotFather创建新Bot并记录APIToken。2.安装Skill执行命令:openclawskillsinstalltelegram3.配置Token与白名单设置BotToken及通过@userinfobot获取并配置UserID。4.重启服务执行命令:openclawgatewayrestart5.发送指令发送消息给Bot：“在桌面创建test.txt并写入内容”。任务目标与评判标准(Objectives)成功创建TelegramBot并获取有效Token。OpenClaw环境中TelegramSkill配置无误。电脑桌面成功生成test.txt文件。文件内容正确包含"HelloOpenClaw"。任务成功的学员将获得课程积分奖励！常见问题排查：TelegramBot无响应？配置错误或渠道未启用原因：BotToken错误或Telegram渠道未开启。解决：执行`openclawconfiggetchannels.telegram`检查配置，确保`enabled`为`true`。用户ID未在白名单中原因：用户ID配置错误或未在`allowedUserIds`列表中。解决：确认ID正确并重启Gateway；可尝试清空列表进行测试。网络无法连接Telegram服务器原因：本地网络限制导致无法访问TelegramAPI。解决：检查网络连接，尝试在浏览器中访问``测试连通性。Gateway服务未正常运行原因：Gateway进程未启动或意外退出。解决：执行`openclawgatewaystatus`检查状态，确保服务正在运行。常见问题排查：钉钉机器人无响应？密钥配置错误(ClientID/Secret)原因：ClientID或ClientSecret配置错误，导致鉴权失败。解决：执行命令`openclawconfiggetchannels.dingtalk`检查配置，确保密钥与钉钉后台一致。回调地址错误或服务断开原因：回调地址配置错误，或ngrok服务已断开导致地址失效。解决：检查ngrok是否在运行，确认地址未变化。尝试重启ngrok并更新钉钉后台的回调地址。未订阅事件或加签验证失败原因：未订阅“机器人收到消息”事件，或加签验证未通过导致消息无法推送。解决：在开发者后台“事件与回调”中订阅对应事件，并确保加签验证通过。机器人未添加到群聊原因：机器人虽然创建成功，但未被正确添加到目标群聊中。解决：在钉钉群的“群设置-智能群助手”中，确认已添加你创建的机器人。常见问题排查：如何确保远程控制的安全？核心原则：最小权限确保AI仅执行明确允许的操作，避免越权。严格限制资源访问范围，仅开放必要接口。Telegram安全加固务必配置allowedUserIds

这是最重要的防线，仅限个人ID访问。定期审查Bot访问日志，及时发现异常登录。钉钉与通用安全钉钉：配置IP白名单，启用消息加签验证。定期更新OpenClaw及插件至最新版本。拒绝安装来源不明或低评分的Skills/Plugins。本章总结远程控制原理通过Gateway作为统一的消息路由中心，实现多通道集成，支持多种通信方式。Telegram接入配置简单快捷适合个人，但需科学上网，且必须配置allowedUserIds保证安全。钉钉接入适合企业用户，国内网络稳定，安全机制完善，但配置复杂，需要公网HTTPS回调。ClawApp备选方案部署简单，通过手机浏览器即可访问，无需配置聊天软件，适合不想折腾的用户。安全永远是第一位任何远程接入方式都必须做好安全配置，遵循最小权限原则，防止未授权访问。课后任务：实现手机远程控制的完整工作流01.选择并配置根据实