openclaw接入telegram机器人有四种方法:一、通过botfather创建机器人并手动配置token;二、使用openclaw onboard向导自动配置;三、通过环境变量注入token;四、验证接入状态与交互测试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您已安装OpenClaw但尚未在Telegram中启用机器人交互功能,则可能是由于Bot Token未正确配置或Telegram Bot未创建成功。以下是接入Telegram机器人的多种方法:
一、通过BotFather创建机器人并配置Token
此方法基于Telegram官方Bot平台,需手动获取Token并注入OpenClaw配置系统,适用于所有操作系统环境。
1、在Telegram中搜索并打开@BotFather账号。
2、发送命令 /newbot,按提示输入机器人名称(如“OpenClaw Assistant”)和用户名(必须以_bot结尾,如“openclaw_xxx_bot”)。
3、BotFather将返回包含HTTP API token的一段消息,格式为“1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZabcdef”,请完整复制该字符串。
4、在本地终端执行以下命令,将Token写入OpenClaw配置:
openclaw config set channels.telegram.botToken "1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZabcdef"
5、启用Telegram通道:
openclaw config set channels.telegram.enabled true
二、使用openclaw onboard向导自动完成配置
此方法利用OpenClaw内置初始化流程,自动引导用户完成Telegram机器人信息录入,避免手动输入错误。
1、在终端中运行openclaw onboard命令。
2、当提示选择通信渠道时,使用方向键移动至Telegram选项并按空格键选中。
3、系统将显示提示:“Please paste your Telegram Bot Token here”,此时粘贴从BotFather获取的Token并回车。
4、若Token格式校验通过,向导将自动执行config set操作并显示“Telegram channel configured successfully”。
5、向导结束后,运行openclaw gateway start启动网关服务。
三、通过环境变量方式注入Token(免配置文件修改)
此方法不修改OpenClaw本地配置文件,适合容器化部署或CI/CD流水线场景,Token仅在进程运行时生效。
1、在终端中设置环境变量:
export OPENCLAW_TELEGRAM_BOT_TOKEN="1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZabcdef"
2、确保同时启用Telegram通道环境开关:
export OPENCLAW_TELEGRAM_ENABLED=true
3、启动OpenClaw网关时添加--env参数(Docker场景)或直接运行:
openclaw gateway start
4、验证环境变量是否加载成功:运行openclaw config get channels.telegram.botToken,应返回非空值。
四、验证Telegram接入状态与基础交互测试
此步骤用于确认Telegram通道已激活且消息路由正常,不依赖Web界面或外部服务。
1、启动OpenClaw网关服务(如尚未运行):
openclaw gateway start
2、在Telegram中搜索并关注您创建的机器人用户名(如@openclaw_xxx_bot)。
3、向机器人发送第一条消息:你好。
4、观察终端日志输出,应出现类似“[telegram] received message from @user_id: 你好”的记录。
5、等待3–8秒,Telegram中应收到AI助手的响应消息,内容为欢迎语或自我介绍。










