前面已经介绍了如何安装 OpenClaw,但是 OpenClaw 还有一个巨大的亮点就是可以通过通讯软件来实现远程控制,官方提供了各种通讯工具接入方式,包括 Telegram、Discord、Slack 等等,但是在国内的用户可能会遇到一些访问限制,所以最好使用国内的通讯工具,目前飞书是一个很好的选择,本文介绍如何配置飞书机器人来实现远程控制 OpenClaw。

假设 OpenClaw 已经安装并且可以正常使用了,接下来我们就来配置飞书机器人。如果你还没有安装,可以看一下这篇文章:OpenClaw 安装完整教程以及国内大模型配置指南

OpenClaw 配置飞书插件

我们通过运行下面命令,进入我们运行下面命令进入配置界面安装飞书插件,建议使用内置的,不要使用第三方,安全。

openclaw config

因为是本地部署,我们这里选择第一个 Local(this machine) 选项,然后选择 Channels -> Configure/link -> Feishu/Lark (飞书) -> Download from npm (@openclaw/feishu),安装飞书插件。

OpenClaw Config

群聊策略选择 Open - Responsed in all groups(requires mention),这样就可以在飞书的群聊里面使用了。

Group Chat Strategy

创建飞书机器人

浏览器访问 https://open.feishu.cn/app 页面,使用飞书app扫码登录。登录后进入页面【创建企业自建应用】,填写信息后,在左侧【凭证与基础信息】里面获取对应的 App ID 和 App Secret,后续配置需要用到。

到了这里要暂停一下,我们回到终端,重新运行 OpenClaw 安装向导:openclaw onboard --install-daemon,到了配置 Channel 的地方就可以看到飞书插件了,选择飞书进行配置对应的 App ID 和 App Secret,完成配置后,重启 OpenClaw 网关:

openclaw gateway restart

启动后可以看到有下面的日志输出,说明已经连接上了飞书的服务器了。

ws success.jpg

您可以使用以下命令检查网关状态或者查看实时日志,方便调试。

  • openclaw gateway status - 查看网关运行状态

    openclaw status success

  • openclaw logs --follow - 查看实时日志

重新打开飞书后台,接下来在左侧的【权限管理】菜单中,点击【批量导入/导出权限】,输入下面的配置,然后点击下一步,点击【申请开通】->【确认开启】按钮即可。

{
"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:write",
"contact:user.employee_id:readonly",
"corehr:file:download",
"docs:document.content:read",
"event:ip_list",
"im:chat",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:bot_access",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.group_msg",
"im:message.p2p_msg:readonly",
"im:message:readonly",
"im:message:send_as_bot",
"im:resource",
"sheets:spreadsheet",
"wiki:wiki:readonly"
],
"user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
}
}

接下来点击【机器人】菜单,配置机器人名称。

feishu info config

打开【事件与回调】菜单,【事件配置】选项卡下,选择【订阅方式】为【使用长连接接收事件】,保存成功后,就可以添加事件,选择【接收消息】。

receive message event

注意:必须要确保已经通过上述添加了飞书渠道了,并且网关已经启动了(可以通过 openclaw gateway status 查看),否则飞书选择长连接订阅方式后保存会报错:未检测到应用连接信息,请确保长连接建立成功后再保存配置

feishu no detect app info

常见错误

访问 127.0.0.1:18789 报错,unauthorized: gateway token missing

我们只需要在 ~/.openclaw/openclaw.json 里面找到 token,然后在 url 输入即可。

127.0.0.1:18789?token=xxxxxx

OpenClaw 提示没权限操作系统文件

我们连上飞书之后,会发信息让他操作一下电脑文件,它会提示 “没有访问文件系统的工具”

No tools are available for file system access

只需要在 OpenClaw 配置文件里面添加对应的权限就可以了,具体可以参考下面的配置:

OpenClaw Permission Configuration

然后重启下 OpenClaw 网关即可:

openclaw gateway restart

再次让他操作一下电脑文件,就可以成功了。

openclaw operate file system success

总结

通过上述配置,我们就成功地将 OpenClaw 接入了飞书通讯软件,现在我们就可以通过飞书来远程控制 OpenClaw 了,具体查看下图,完美