1. 为什么要在飞书里远程操控电脑
OpenClaw 2.7.9 是一个能在本机执行任务的智能体客户端,它把自然语言指令拆解成具体操作,再调用系统能力去落地。飞书则是很多人日常已经在用的协作工具,消息触达快、手机端体验好。把这两者接起来,你就能在飞书聊天窗口里发一句话,让家里或公司那台常开的电脑去整理文件、跑脚本、生成表格。对运维和开发者来说,这相当于给自己配了一个随叫随到的远程执行入口,不用额外装远程桌面,也不用记一堆命令。
这篇教程聚焦 OpenClaw 2.7.9 与飞书机器人的完整对接流程,面向需要远程操控电脑的开发者与运维场景。我会给出可复制的 config.toml 与 settings.json 配置骨架、TaoToken 统一 Key 的接入步骤、飞书机器人回调与权限配置清单,以及一条从消息触发到远程执行的验证动作。你跟着做,能确认整条链路是通的。
需要先说明一点:OpenClaw 本身负责“执行”,而它背后调用的大模型通道,我建议用 TaoToken 来统一管理。原因很简单,OpenClaw 支持多种模型接入,如果你每个渠道都单独配一套 Key,后面换模型、加渠道会非常乱。TaoToken 提供一个统一的 API 入口,把 Key 收敛到一处,OpenClaw 里只填一个地址和一个 Key 就行。官网地址是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,API 入口是 https://taotoken.net/api ,注意 API 地址不带 UTM 参数,配置时别写错。
适合谁看:已经在 Windows 10/11 上跑 OpenClaw 2.7.9 的人;想用飞书做指令入口的运维;需要远程让电脑执行批量任务的开发者。如果你还没装 OpenClaw,先去拿安装包,解压即用,内置运行依赖,装完再回来配飞书。
2. TaoToken 统一 Key 的前置准备
在动飞书之前,先把模型通道理顺。OpenClaw 的对话与任务拆解都依赖大模型,如果通道不稳,飞书那边消息发出去也只会卡住或报错。我试过把多个渠道的 Key 分散写在 OpenClaw 里,结果换模型时改了三四份配置,很容易漏。用 TaoToken 之后,只需要维护一个 Key。
第一步,打开 TaoToken 控制台,进入 API Keys 页面创建一个新 Key。地址是 https://taotoken.net/console ,创建时给它起个能认出来的名字,比如 openclaw-feishu。创建完立刻复制,页面刷新后就不再完整显示。
第二步,确认你要用的模型。OpenClaw 2.7.9 的模型配置里需要填模型名,TaoToken 支持主流模型,你可以在模型对话页面先试一下目标模型是否可用,地址是 https://taotoken.net/models 。这一步别省,先确认模型能正常回话,再去配 OpenClaw,能省掉后面一半的排查时间。
第三步,记下两个值:API Base 用 https://taotoken.net/api ,API Key 用刚才复制的那串。这两个值后面会写进 OpenClaw 的 config.toml。
如果你打算长期跑编码类或 Agent 类任务,可以看一下 Coding Plan,地址是 https://taotoken.net/coding-plan ,它更适合高频调用场景。普通远程操控电脑的指令量不大,按量用 API Key 就够了。
注意:TaoToken 是合规的 API 通道服务,配置时只填官方给的地址,不要自行拼接或改写域名路径。
3. 可复制的 OpenClaw 配置骨架
OpenClaw 2.7.9 的配置分两块:一块是模型通道 config.toml,一块是渠道凭证 settings.json。下面给的是骨架,你把 Key 和飞书凭证替换进去即可。
先看 config.toml,放在 OpenClaw 安装目录的 config 文件夹下:
# OpenClaw 2.7.9 模型通道配置 [gateway] host = "127.0.0.1" port = 18789 auto_restart = true [model] provider = "openai-compatible" base_url = "https://taotoken.net/api" api_key = "sk-你的TaoTokenKey" model_name = "你的模型名" timeout = 120 max_tokens = 4096 [agent] workspace = "D:/OpenClaw/workspace" allow_shell = true allow_file_ops = true几个参数说明:base_url 必须写 https://taotoken.net/api ,不要带结尾斜杠;api_key 填你在控制台创建的那串;model_name 填你在模型对话页面验证过的模型名;allow_shell 和 allow_file_ops 控制 OpenClaw 能不能执行命令和读写文件,远程操控电脑这两个要开。
再看 settings.json,放在 OpenClaw 的 settings 目录下,负责飞书渠道凭证:
{ "channels": { "feishu": { "enabled": true, "app_id": "cli_你的AppID", "app_secret": "你的AppSecret", "event_mode": "long_connection", "bot_name": "OpenClaw机器人" } }, "gateway": { "restart_on_save": true } }event_mode 填 long_connection,对应飞书的长连接订阅方式,这样不需要公网域名,个人用户也能用。app_id 和 app_secret 从飞书开放平台拿,下一节讲怎么取。
提示:两个文件都改完后,先别急着启动,确认 JSON 没有多余逗号、TOML 没有中文引号,格式错误是新手最常见的坑。
4. 飞书机器人回调与权限配置清单
飞书这边的配置顺序不能乱,权限和事件订阅是核心,缺一个机器人就不响应。
先在飞书开放平台创建企业自建应用,填应用名称、描述、图标。创建后进入应用配置页,左侧找到“添加应用能力”,选中“机器人”并添加。
接着是权限管理,点“批量导入/导出权限”,选应用身份权限,把下面这份精简后的权限 JSON 粘进去。完整版权限很多,这里保留远程操控电脑真正会用到的部分:
{ "scopes": { "tenant": [ "im:message", "im:message:send_as_bot", "im:message:readonly", "im:chat", "im:chat:read", "im:chat.members:read", "contact:user.base:readonly", "contact:user.id:readonly", "docs:doc", "docs:doc:readonly", "docx:document", "docx:document:create", "docx:document:readonly", "sheets:spreadsheet", "sheets:spreadsheet:create", "sheets:spreadsheet:read", "drive:file", "drive:file:upload", "drive:file:download", "base:app:read", "base:record:create", "base:record:read", "base:record:update" ], "user": [] } }粘进去后点“格式化 JSON”,确认无误再下一步,选择申请开通。个人账号即时生效,企业账号要等管理员审核。
然后是事件订阅。左侧进“事件与回调”,订阅方式选“使用长连接接收事件”,保存。点“添加事件”,搜索“接收消息”,勾选“接收消息 v2.0(im.message.receive_v1)”。这一步决定飞书消息能不能推给 OpenClaw。
最后去“版本管理与发布”,创建版本,版本号填 1.0.0,更新说明随便写,移动端和桌面端默认能力都设为机器人。先保存再发布。个人未认证账号发布后自动生效。
发布后回到“凭证与基础信息”,复制 App ID 和 App Secret,填进上一节的 settings.json。注意复制时不要带空格。
5. 验证请求与成功结果
配置全部写完后,重启 OpenClaw,等右上角 Gateway 显示在线。然后打开飞书,搜索你创建的应用名称,进入机器人聊天窗口。
先发一条最简单的:“你好”。如果机器人回复了内容,说明消息链路和模型通道都通了。如果没回复,先看 OpenClaw 主界面有没有收到事件日志。
再发一条能触发实际操作的指令,比如:“帮我在 D 盘 workspace 目录下新建一个 test 文件夹,并在里面写一个 hello.txt,内容为 feishu ok”。这条指令会走完整链路:飞书消息 → 长连接事件 → OpenClaw 拆解任务 → 调用 TaoToken 模型 → 执行文件操作 → 回传结果。
成功的话,飞书里会收到执行完成的回复,同时你去 D:/OpenClaw/workspace 下能看到 test 文件夹和 hello.txt。这一步验证通过,说明远程操控电脑的链路是完整可用的。
你也可以用 curl 单独验证 TaoToken 通道是否正常,排除模型侧问题:
curl https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的TaoTokenKey" \ -H "Content-Type: application/json" \ -d '{ "model": "你的模型名", "messages": [{"role": "user", "content": "回复 ok"}] }'返回里有正常内容,说明 Key 和地址没问题,问题就在飞书或 OpenClaw 侧。
6. 本篇常见错排查
机器人无响应,先查三处:飞书应用版本是否已发布、权限是否全部开通、事件订阅是否选了长连接并添加了接收消息事件。这三处任意一个没做,消息都到不了 OpenClaw。
凭证配置后连不上,多半是 App ID 或 App Secret 复制时带了空格,或者和飞书平台上的值不一致。重新复制一遍,粘进 settings.json 后保存,OpenClaw 会自动重启 Gateway。
事件接收异常,回飞书“事件与回调”页面,确认订阅方式还是长连接,消息事件还在列表里。有时候改权限后事件配置会被重置,重新保存一次再测。
OpenClaw 服务离线,检查一键启动程序是否还在运行,Gateway 离线就手动重启。如果重启后马上又离线,去看 config.toml 的 base_url 和 api_key 是否写错,模型通道不通也会导致 Gateway 异常。
模型回复慢或超时,把 config.toml 里的 timeout 调大,比如 180。同时确认 TaoToken 控制台里 Key 的额度是否充足,额度耗尽会直接报错。
还有一个容易忽略的点:飞书机器人默认只能收到@它的消息,群聊里要@机器人,单聊直接发即可。如果你在群里发指令没反应,先试试@一下。
整套跑通后,你可以在飞书里下发办公类、文件类、浏览器类指令,OpenClaw 会按你的配置去执行。模型通道统一走 TaoToken,后面想换模型只改 config.toml 一行,飞书侧完全不用动。接入文档在 https://taotoken.net/doc ,API Keys 管理在 https://taotoken.net/api-keys ,需要长期跑 Agent 任务的话 Coding Plan 在 https://taotoken.net/coding-plan 。