本指南将带你体验“即插即用”的开发魅力：利用 timbot 插件，将 OpenClaw 托管的 AI 智能体直接“空降”到腾讯云 IM 中。
·零侵入开发：无需对现有 App 进行任何“伤筋动骨”的代码修改。
·极速上线：仅需后台配置，即可获得一个 7×24 小时在线、懂业务、会思考的智能伙伴。
·统一调度：一套逻辑，多端复用。
一、前提条件
在开始前，请确保你已具备以下环境：
·OpenClaw 环境：已在 腾讯云 Lighthouse 服务器上部署 OpenClaw，请参考 部署指南：新购一台 Lighthouse 服务器。
·腾讯云资源：注册腾讯云账号，用于访问即时通信 IM 控制台 。
·调试工具：微信开发者工具。
二、步骤 1：创建 IM 应用并获取凭证
1. 登录 即时通信 IM 控制台，在左侧导航栏选择应用管理，单击创建新应用。
2. 在弹出界面中依次输入应用名称、选择数据中心为中国、设置标签信息（可选）。
3. 创建完成后进入应用详情页，在应用信息模块中找到并记录以下两个关键参数，用于后续鉴权 ：
·SDKAppID：应用的唯一标识 ID 。
·SecretKey：用于生成鉴权签名的密钥 。
三、步骤 2：获取 Lighthouse 服务器 IP 地址
进入 轻量云控制台 > 服务器 菜单，获取你购买的服务器的 IP 地址：
四、步骤 3：创建机器人账号并配置消息回调
为了让 OpenClaw 能收到消息，需要创建一个机器人账号，并配置消息回调。
五、创建机器人账号
在即时通信 IM 控制台的左侧菜单栏中，点击 REST API 调试：
1. 应用选择 步骤 1 中创建的应用。
2. 依次单击机器人 > 创建机器人，在输入 Json 参数中设置机器人的相关信息，你也可以使用默认配置：
·UserID: 机器人的 ID（本 Demo 中固定使用 @RBT#001)。
·Nick: 机器人的名称。
·FaceUrl: 机器人头像的地址。
·SelfSignature：机器人签名。
3. 单击发起调用，调用结果显示 “ActionStatus: OK” ，即表示创建成功 。
六、配置消息回调
这是打通即时通信 IM 与 OpenClaw 的桥梁。
首先，请在即时通信 IM 控制台左侧菜单选择回调配置 > 消息服务 Chat，随后单击右上角的编辑，配置后台回调 URL。
按照下列说明进行配置：
·URL 格式：http://xx.xx.xx.xx:18789/timbot。xx.xx.xx.xx 为 步骤 2 中获取的服务器 IP 地址。
·勾选开启鉴权。
·鉴权 Token：自定义字符串（例如 mysecrettoken），用于请求生成签名，详细参见 回调配置。请记住它，稍后需要填入 OpenClaw 配置中。
·勾选回调事件：请务必勾选 “机器人事件” 下的“机器人事件回调”，确保机器人能收到消息 。
启用后的状态如下：
七、步骤 4：配置 Lighthouse 服务器
进入 轻量云控制台 > 服务器菜单，单击你刚刚购买的服务器。
单击登录，打开服务器终端。
在随后出现的界面中选择免密连接 > 登录。
八、安装插件
openclaw plugins install timbot
九、激活并选择通道
配置修改完成后，需要通过交互命令来激活对应的 Channel。
首先在服务器终端执行命令：
openclaw onboard
运行上面的命令后，提示是否知晓风险，选择 Yes（空格键选择，回车键确认）：
Onboarding 模式选择 QuickStart：
选择 Use existing values：
根据实际情况配置可用的模型：
注意：请选择有免费用量或者已经付费的大模型，否则连接成功后将无法体验完整功能哦。
认证方式选择 API Key：
如果已经填写过 API Key 则选 Yes，没填过选 No：
输入模型的 API Key：
默认模式选择 Keep current：
在出现的 Select channel 列表中，找到并选择 Tencent IM (plugin) 。 这一步是通知 OpenClaw 加载刚配置好的 timbot 模块。
注意：若你选择通道后遇到 “timbot does not support guided setup yet” 的错误提示，解决方案请参考 常见问题。
配置 SDKAppID：
配置 SecretKey：
配置回调 Token：
选择不配置 skills：
选择 Skip for now：
选择 Restart 重启 openclaw gateway：
十、开放网络权限
为了确保腾讯云的回调请求能穿透防火墙到达 OpenClaw，需要放行 18789 端口。
·修改监听地址：执行命令允许服务监听公网请求：
openclaw config set gateway.bind lanopenclaw gateway restart
·使用下面的命令查看直到18789端口的绑定地址变为0.0.0.0表示成功：
netstat -lnpt
·返回 Lighthouse 控制台，选择服务器 > 防火墙，检查防火墙端口是否放开外网权限：
·如果没有，需要按下图所示添加规则：
十一、导入项目
下载 clawdbot-wx 项目，在微信开发者工具导入（请使用自己的小程序 AppID）。如需二次开发或集成到自有项目，可获取 uniapp 小程序源码，点击 下载链接。
请在微信开发者工具中做如下勾选：
十二、和机器人聊天
为了简化流程，请开启小程序开发调试模式：
输入步骤1获取的 SDKAppID 与 SecretKey，用于完成服务鉴权。UserID 可任意填写：系统将自动以此 ID 创建并登录新用户。
登录成功后，打开和机器人的会话，即可开启 OpenClaw 智能体之旅。
尽情使唤你的小助理吧！
十三、怎么通过手机微信小程序进入对话？
在微信开发者工具中选择预览，手机微信扫码后，微信里会一直存在这个小程序，即可随时通过这个小程序使用你的小助理。
十四、小助理一直没有回复，如何排查？
执行下列命令可以查看 timbot 插件的日志：
openclaw gateway stop && openclaw gateway –verbose | grep –line-buffered -i '\\[timbot\\]\\|timbot'
收到 webhook 请求成功：
处理后发送消息成功：
十五、OpenClaw 配置通道时提示不支持引导设置？
执行 openclaw onboard 命令配置通道时，出现以下报错提示：
timbot does not support guided setup yet
·原因：OpenClaw 新版本重构了插件引导设置流程，低版本的 timbot 插件尚未适配该流程。
·解决方案：将 timbot 插件升级至 ≥ 2026.4.3。