前置工作
已通过天翼云生态专区订购 OpenClaw 应用
已为对应的OPenClaw应用实例完成模型配置
说明
若 OpenClaw 版本过低,将导致无法在公有云生态专区页面中进行模型配置。
操作步骤
登录天翼云官网,进入生态专区控制台。在应用管理-我的应用中,选中对应的OpenClaw实例,点击进入应用详情页面。
点击应用配置页签,进入 OpenClaw 应用配置页面。在通道配置模块中,可对 OpenClaw 进行通道配置(支持企业微信、QQ、钉钉、飞书),实现将 OpenClaw 接入各类即时通讯软件
说明
OpenClaw 支持在同一台服务器上配置多个通道,可同时接入QQ 机器人、飞书机器人等多个接入实例。若当前服务器已接入过其他通道,可在此基础上继续添加更多通道。
1.OpenClaw快速接入QQ配置
1.1登录QQ开放平台
进入腾讯QQ开放平台官网,完成QQ账号登录。
1.2创建QQ机器人
在QQ开放平台的QQ机器人页面,单击“创建机器人”,完成QQ机器人创建。
机器人创建完成后,记录并保存页面显示的 ”AppID“ 和 “AppSecret” 两个参数。请妥善保管、切勿泄露,注意数据安全,后续配置步骤将需要使用以上信息。
返回 QQ 软件,即可在消息列表中看到已创建的 QQ 机器人,且机器人会自动发送第一条欢迎消息。
1.3QQ通道配置
登录天翼云官网,进入生态专区控制台。在应用管理-我的应用中,选中对应的OpenClaw实例,点击进入应用详情页面。
进入应用配置页签,在通道配置模块,选择通道来源为为“QQ”,并依次填写前面步骤获取的 QQ 机器人 AppID 与 AppSecret,点击“确认添加”完成配置操作。
1.4QQ机器人接入验证
配置好 QQ 机器人的 AppID 和 AppSecret 后,在已接入通道列表确保您的飞书通道显示“运行中”。
可在 QQ 中与已对接 OpenClaw 的机器人单独发起对话。若机器人能正常以 AI 形式回复,即表示 OpenClaw 已成功接入 QQ 机器人。
2.OpenClaw快速接入企微配置
2.1企业微信通道配置
2.1.1快捷配置(推荐)
登录天翼云官网,进入生态专区控制台。在应用管理-我的应用中,选中对应的OpenClaw实例,点击进入应用详情页面。
进入应用配置页签,在通道配置模块,选择通道来源为“企业微信 ”,选择配置方式为”快捷配置“,点击“扫描授权”。
在弹出的页面中,使用具有创建智能机器人权限的企业微信完成扫码授权。
在企业微信中点击一键创建智能机器人即可完成配置
2.1.2手动配置
2.1.2.1登录企业微信官网
进入企业微信官网,使用有企业管理员权限的账号登录。
2.1.2.2添加飞企微机器人
在左侧导航依次找到并进入安全与管理-管理工具,选择智能机器人,然后在页面内点击创建机器人。
在弹出的弹窗中,点击”手动创建“按钮
点击API模式创建,连接方式选择”使用长连接“创建。在配置方法中的Secret处单击点击获取
在配置方法中的Secret处单击点击获取,记录并保存页面显示的 ”BotID“ 和 “Secret” 两个参数。请妥善保管、切勿泄露,注意数据安全,后续配置步骤将需要使用以上信息。
2.1.2.3配置企微通道
登录天翼云官网,进入生态专区控制台。在应用管理-我的应用中,选中对应的OpenClaw实例,点击进入应用详情页面。
进入应用配置页签,在通道配置模块,选择通道来源为“企业微信 ”,选择配置方式为”手动配置“,点击“确认添加”。
2.1.2.4配置企微机器人
返回企业微信官网,在左侧导航依次找到并进入安全与管理-管理工具,进入对应机器人的详情页。
点击“…”按钮,再点击获取机器人二维码,通过移动端企业微信扫码后添加该机器人。
2.2企微机器人接入验证
配置好企微机器人的 AppID 和 AppSecret 后,在已接入通道列表确保您的企微通道显示“运行中”。
可在企微中与已对接 OpenClaw 的机器人单独发起对话。若机器人能正常以 AI 形式回复,即表示 OpenClaw 已成功接入企微机器人。
3.OpenClaw快速接入飞书配置
3.1登录飞书开放平台
进入登录飞书开放平台官网,完成飞书账号登录。
3.2创建企业自建应用
点击“创建企业自建应用”,完成应用名称、应用描述、应用图标等信息的填写,完成应用创建。
3.3添加飞书机器人
完成应用创建后,进入应用管理页面。
在左侧导航栏中找到并点击添加应用能力,在“按技能添加”页签中选择机器人,点击”添加“完成机器人添加。
在左侧导航栏找到并点击凭据与基础信息。记录并保存页面显示的 ”AppID“ 和 “AppSecret” 两个参数。请妥善保管、切勿泄露,注意数据安全,后续配置步骤将需要使用以上信息。
3.4飞书通道配置
登录天翼云官网,进入生态专区控制台。在应用管理-我的应用中,选中对应的OpenClaw实例,点击进入应用详情页面。
进入应用配置页签,在通道配置模块,选择通道来源为为“飞书”,并依次填写前面步骤获取的飞书机器人 AppID 与 AppSecret,点击“确认添加”完成配置操作。
3.5添加权限配置
登录飞书开放平台。进入对应机器人应用的应用管理页面。
在左侧导航栏中找到并点击权限管理,在输入框中输入目标权限,为应用添加权限。必需权限和可选权限配置见下表。
| 必需权限 | 范围 | 说明 |
|---|---|---|
| contact:user.base:readonly | 用户信息 | 获取用户基本信息 |
| contact:contact.base:readonly | 通讯录 | 获取通讯录基本信息 |
| im:message | 消息 | 发送和接收消息 |
| im:message.p2p_msg:readonly | 私聊 | 读取发给机器人的私聊消息 |
| im:message.group_at_msg:readonly | 群聊 | 接收群内 @机器人 的消息 |
| im:message:send_as_bot | 发送 | 以机器人身份发送消息 |
| im:resource | 媒体 | 上传和下载图片/文件 |
| 可选权限 | 范围 | 说明 |
|---|---|---|
| im:message.group_msg | 群聊 | 读取所有群消息(敏感) |
| im:message:readonly | 读取 | 获取历史消息 |
| im:message:update | 编辑 | 更新/编辑已发送消息 |
| im:message:recall | 撤回 | 撤回已发送消息 |
| im:message.reactions:read | 表情 | 查看消息表情回复 |
权限添加完后状态如下:
3.6添加事件订阅
在左侧导航栏找到并点击事件与回调。在事件配置列表选择订阅方式为长连接。
在已添加事项列表点击”添加事件“,具体添加项见下表:
| 事件 | 说明 |
|---|---|
| im.message.receive_v1 | 接收消息(必需) |
| im.message.message_read_v1 | 消息已读回执 |
| im.chat.member.bot.added_v1 | 机器人进群 |
| im.chat.member.bot.deleted_v1 | 机器人被移出群 |
注意
事件订阅必须在OpenClaw添加飞书配置并启动后,才可以创建,否则无法创建成功。
3.7创建版本并发布
左侧导航栏找到并点击版本管理与发布。点击右上角的”创建版本“,填写应用版本号和更新说明等信息,点击保存并确认发布。
待飞书管理员通过发布审核。审核发布成功后,可以在版本管理与发布页面,查看到已经发布的版本号和状态。
3.8飞书机器人接入验证
配置好飞书机器人的AppID 与 AppSecret后,在已接入通道列表确保您的飞书通道显示“运行中”。
可在飞书中与已对接 OpenClaw 的机器人单独发起对话。若机器人能正常以 AI 形式回复,即表示 OpenClaw 已成功接入飞书机器人。
以电脑版飞书软件为例(手机端飞书的操作类似),登录飞书后,在飞书搜索栏中搜索机器人应用名称。
在搜索框中输入前面步骤中创建的飞书机器人的应用名称,输入回车进行搜索。
与该机器人进行对话,若机器人能正常以 AI 形式回复,即表示 OpenClaw 已成功接入飞书机器人。
4.OpenClaw快速接入钉钉配置
4.1登录钉钉开放平台
进入钉钉开发者平台官网,使用具有管理员权限的账号登录平台。
4.2创建钉钉应用
在钉钉开发者平台进入应用开发-钉钉应用管理页面,点击创建应用,填写“应用名称”和“应用描述”,完成应用创建。
4.3添加钉钉机器人
选择上一步中创建的应用,在左侧导航栏找到并点击添加应用能力,选择添加机器人,点点击”保存“为应用添加能力。
在“机器人配置”页面,填写所有的必填项,消息接收模式选择stream模式,随后点击发布。
在左侧导航栏找到并点击版本管理与发布,完成所有必填项,可在“应用可见范围(可选项)”中配置能添加这个钉钉机器人的员工范围。点击保存,在弹出的窗口点击确认发布。发布后版本详情将显示“已上线”。
在左侧导航栏找到并点击凭据与基础信息。记录并保存页面显示的 ”Client ID“ 和 “Client Secret” 两个参数。请妥善保管、切勿泄露,注意数据安全,后续配置步骤将需要使用以上信息。
4.4钉钉通道配置
登录天翼云官网,进入生态专区控制台。在应用管理-我的应用中,选中对应的OpenClaw实例,点击进入应用详情页面。
进入应用配置页签,在通道配置模块,选择通道来源为为“钉钉”,并依次填写前面步骤获取的钉钉机器人 Client ID 与 Client Secret,点击“确认添加”完成配置操作。
4.5钉钉机器人接入验证
配置好钉钉机器人的 Client ID 与 Client Secret后,在已接入通道列表确保您的钉钉通道显示“运行中”。
登录钉钉后,在顶部搜索栏中搜索机器人应用名称。
点击对应的应用,即可与该机器人进行对话,若机器人能正常以 AI 形式回复,即表示 OpenClaw 已成功接入钉钉机器人。