想要让您的微信小程序应用瞬间拥有“大脑”?OpenClaw 为此提供了标准答案。作为连接模型与应用的“超级枢纽”,它让开发者能够一站式配置核心逻辑,快速输出标准的 AI 能力。
本指南将带您体验“即插即用”的开发魅力:利用 timbot 插件,将 OpenClaw 托管的 AI 智能体直接“空降”到腾讯云 IM 中。
零侵入开发:无需对现有 App 进行任何“伤筋动骨”的代码修改。
极速上线:仅需后台配置,即可获得一个 7×24 小时在线、懂业务、会思考的智能伙伴。
统一调度:一套逻辑,多端复用。
前提条件
在开始前,请确保您已具备以下环境:
OpenClaw 环境:已在 腾讯云 Lighthouse 服务器上部署 OpenClaw,请参考 部署指南:新购一台 Lighthouse 服务器。
腾讯云资源:注册腾讯云账号,用于访问即时通信 IM 控制台 。
调试工具:微信开发者工具。
实现流程
步骤 1:创建 IM 应用并获取凭证
1. 登录 即时通信 IM 控制台,在左侧导航栏选择应用管理,单击创建新应用。


2. 在弹出界面中依次输入应用名称、选择数据中心为中国、设置标签信息(可选)。


3. 创建完成后进入应用详情页,在应用信息模块中找到并记录以下两个关键参数,用于后续鉴权 :
SDKAppID:应用的唯一标识 ID 。SecretKey:用于生成鉴权签名的密钥 。
步骤 2: 获取 Lighthouse 服务器 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 服务器

单击登录,打开服务器终端。

在随后出现的界面中选择免密连接 > 登录。

步骤 5:激活 OpenClaw 的 IM 能力
安装插件
openclaw plugins install timbot

配置通道参数
在终端输入下列命令修改配置文件:
vim /root/.openclaw/openclaw.json
添加 timbot 插件配置
在 channels 节点下添加 timbot 配置,并填入步骤1和步骤3中获取的信息,然后保存并关闭文件。

"channels": {"timbot": {"enabled": true,"webhookPath": "/timbot","sdkAppId": "16000xxxxx", // 填入 步骤1 获取的 SDKAppID"botAccount": "@RBT#001","token": "mysecrettoken", // 填入 步骤3 设置的鉴权 Token"secretKey": "xxxxxx", // 填入 步骤1 获取的 SecretKey"dm": {"policy": "open"}}}
激活并选择通道
配置修改完成后,需要通过交互命令来激活对应的 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 模块。

选择不配置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 控制台,选择服务器 > 防火墙,检查防火墙端口是否放开外网权限:

如果没有,需要按下图所示添加规则:

步骤 6:启动服务与效果验证
导入项目

请在微信开发者工具中做如下勾选:

和机器人聊天
为了简化流程,请开启小程序开发调试模式:

输入步骤1获取的 SDKAppID 与 SecretKey,用于完成服务鉴权。UserID 可任意填写:系统将自动以此 ID 创建并登录新用户。

登录成功后,打开和机器人的会话,即可开启 OpenClaw 智能体之旅。

尽情使唤您的小助理吧!