首页 / 资讯中心 / 文章详情

OpenClaw 2.7.9 对接飞书教程:用 TaoToken 统一 Key 搭建飞书机器人实现远程操控电脑(含安装包)

OpenClaw 2.7.9 对接飞书教程:用 TaoToken 统一 Key 搭建飞书机器人实现远程操控电脑(含安装包) ★ FEATURED ARTICLE
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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_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.0im.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 。
阅读完成 · 觉得有帮助?
咨询建站