接入 IM 工具

如果是在单机环境中操作 OpenClaw 最方便的选择其实是使用它的文本界面TUI但这显然不是人们使用这款 Agent 应用的目的。毕竟我们在这类应用场景中显然有更好的选择譬如 Claude Code、OpenCode 等。人们选择以服务的形式来部署 Agent 的目标是希望能构建一个接近于科幻世界所设定的那种人工智能体让人类随时能通过日常使用的通信工具与它联系并让它替我们完成一些工作任务。下面让我们来详细了解一下将 OpenClaw 服务端接入到 IM 工具的方法。在正式执行接入配置之前我们首先应该要了解这些 IM 工具究竟是如何与 OpenClaw 进行交互的。按照 OpenClaw 的服务端结构相关功能主要是通过一个被称作“消息网关Gateway”的组件来完成的。换而言之当用户在 IM 工具中向 OpenClaw 发送消息时接下来的通信步骤主要会按照图 1 所示流程来进行。OpenClaw 消息流转图 1 IM 与OpenClaw 之间的消息流转接入 WhatsAppWhatsApp 是一款在国际互联网上非常流行的 IM 工具支持用户在全球范围内进行实时通讯。这里之所以选择从 WhatsApp 开始介绍将 OpenClaw 接入 IM 工具的方法主要因为它是最早支持 OpenClaw 的通信工具之一接入的步骤相对简单得多适合初学者快速进入状况。下面让我们来具体介绍一下将 OpenClaw 接入到 WhatsApp 的具体步骤。在正式开始执行接入工作之前我们需要确认以下几个前置条件:确保 OpenClaw 的服务端已经完成部署并且能够正常运行确保手机和工作设备上都已安装了 WhatsApp 应用并完成了账号的注册与登录确保网络环境畅通因为稍后需要扫描二维码进行连接在OpenClaw服务端所在的计算机上打开命令行终端环境并执行openclaw channels add命令并在打开的确认对话框中选择“yes”进入到如图 2 所示的客户端接入配置界面中。OpenClaw的客户端选择界面图 2 OpenClaw的客户端选择界面WhatsApp在后续出现的配置向导界面中我们需要依次选择“WhatsApp” → ”default” → ”yes”如图 3 所示。WhatsApp的配置界面图 3 WhatsApp 的接入配置界面在确认上述界面之后OpenClaw 会自动从 WhatsApp 处获得一个二维码我们需要在手机端的 WhatsApp 应用中打开“设置”→“已连接的设备”→“关联设备”选项然后扫描这个二维码。在扫描成功之后配置界面会提示我们为 OpenClaw 设置一个电话号码如图 4 所示。为OpenClaw设置电话号码图 4 为 OpenClaw 设置电话号码图中的号码是虚构的在上述界面中我们既可以为它配置一个单独的电话号码也可以直接使用自己的手机号码。通常情况下为其配置一个独立的号码会更安全一些也更符合独立交互场景下的使用体验。但在这里为了演示方便我就直接使用自己的手机号码了。在配置完成并重启 OpenClaw 网关服务之后我们只需要在 WhatsApp 中向自己发送一条消息就能看到 OpenClaw 用我们自己的身份所做的回复了如图 5 所示。在WhatsApp中与OpenClaw进行交互图 5 在 WhatsApp 中与 OpenClaw 进行交互至此我们就完成了将 OpenClaw 接入到 WhatsApp 的整个操作流程。除了 WhatsApp 之外较为常用的国际 IM 工具还有 Telegram、Slack 等。它们接入 OpenClaw 的方式与 WhatsApp 大同小异考虑到这些软件在国内少有使用这里就不再赘述了。接入飞书平台飞书是中文社区被广泛使用的一款线上协作平台许多企业团队都会基于它来创建属于自己的远程办公系统用于进行线上会议、项目管理、文件共享、任务安排等日常工作。下面让我们来了解一下如何将该平台接入 OpenClaw 以便为自己的团队增添一位“数字员工”其具体步骤如下。在正式开始执行接入工作之前我们同样需要确认以下几个前置条件确保 OpenClaw 的服务端已经完成部署并且能够正常运行确保手机和 PC 上都已安装了飞书应用并拥有了自己的账号确保网络环境畅通因为稍后需要一些应用发布的审核通过操作打开网页浏览器用自己的账号登录到飞书开放平台网站上并创建一个“企业自建应用”这里的应用名称、描述以及图标读者可以根据自己的喜好自行填写。创建完成之后我们就会进入到如图 6 所示的设置界面中。在飞书开放平台创建应用图 6 在飞书开放平台创建应用在上述界面中我们需要先将应用的 App ID 和 App Secret 保存到本地以便稍后在 OpenClaw 的配置界面中使用到它们。然后在左侧菜单依次点击“应用功能”→“机器人”→“创建机器人”并按照提示完成机器人的创建。创建完成之后我们就可以在飞书客户端中看到这个机器人了如图 7 所示。为飞书应用添加机器人功能图 7 为飞书应用添加机器人功能在上述界面的左侧点击“权限管理”然后在右侧点击“批量导入/导出权限”按钮并粘贴以下 JSON 代码并确认开通权限{“scopes”: {“tenant”: [“aily:file:read”,“aily:file:write”,“application:application.app_message_stats.overview:readonly”,“application:application:self_manage”,“application:bot.menu:write”,“cardkit:card:read”,“cardkit:card:write”,“contact:user.employee_id:readonly”,“corehr:file:download”,“event:ip_list”,“im:chat.access_event.bot_p2p_chat:read”,“im:chat.members:bot_access”,“im:message”,“im:message.group_at_msg:readonly”,“im:message.p2p_msg:readonly”,“im:message:readonly”,“im:message:send_as_bot”,“im:resource”],“user”: [“aily:file:read”,“aily:file:write”,“im:chat.access_event.bot_p2p_chat:read”]}}继续在图 7 所示界面的左侧点击“事件与回调”然后在右侧的“事件配置”一栏中将订阅方式设置为“长连接接收事件(WebSocket)”并通过“添加事件”按钮依次添加以下事件并保存如图 8 所示。im.message.receive_v1 - 接收消息im.message.message_read_v1 - 消息已读回执im.chat.member.bot.added_v1 - 机器人进群im.chat.member.bot.deleted_v1 - 机器人被移出群为飞书应用添加事件订阅