★ FEATURED ARTICLE 1. 为什么要在手机飞书里养这只“虾”OpenClaw 是近期很火的开源 AI 智能体框架它能跑在你自己的电脑上通过接入各种聊天渠道让你在手机上随时调用本机的 AI 能力。飞书作为办公场景里用得最多的协作工具之一把 OpenClaw 接进来之后你掏出手机就能让 AI 帮你拍照、录音、找文件、发消息相当于随身带了一个能操作电脑的助手。这套流程适合已经装好 OpenClaw、想在移动端随时使唤 AI 的开发者也适合想把办公 IM 变成 AI 入口的团队。整个接入链路的核心是 WebSocket 长连接飞书开放平台把用户消息通过长连接推给 OpenClawOpenClaw 处理完再通过飞书 API 把结果发回去。相比 Webhook 回调长连接不需要公网 IP、不需要内网穿透本地电脑就能跑通这也是它适合个人开发者的原因。而模型调用这一层我用 TaoToken 统一管理 Key一个 Key 就能覆盖 OpenClaw 里配置的多个模型省得在 settings.json 里来回换。下面按“飞书建应用 → TaoToken 拿 Key → OpenClaw 写配置 → npm 启动 → 手机验证”的顺序走一遍每一步都给可复制的命令和参数跟着做基本一次能通。2. 前置准备TaoToken 统一 Key 与飞书应用凭证2.1 TaoToken 侧拿到统一 API KeyOpenClaw 本身不绑定某一家模型服务它通过 OpenAI 兼容接口去调用模型。TaoToken 提供的就是这种兼容入口你只需要一个 Key就能在 OpenClaw 里切换不同模型不用为每个模型单独配一套凭证。操作路径很直接打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录后进入控制台在 API Keys 页面创建一个新 Key。创建时建议给 Key 起个能认出来的名字比如openclaw-feishu方便后面在多个项目里区分。拿到 Key 之后先别急着关页面把这几项记下来配置项值说明API Base URLhttps://taotoken.net/apiOpenClaw 的 base_url 填这个API Keysk-xxxxxxxx控制台生成的那串默认模型按需选比如 claude 系列或 gpt 系列注意API 地址不要加 UTM 参数直接写https://taotoken.net/api即可OpenClaw 拼接路径时不会出错。如果你还没决定用哪个模型可以先在模型对话页面试一下效果确认响应正常再写进配置。模型对话入口在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 登录后直接对话不用写代码就能验证 Key 是否可用。2.2 飞书侧创建自建应用并拿 App ID / App Secret登录飞书开放平台进入开发者后台点“创建企业自建应用”。填好应用名称和描述比如叫“我的小龙虾”。创建完成后在“添加应用能力”里把机器人能力加上。接下来是权限配置。如果你只是个人玩、飞书里没有敏感数据可以把im:、contact:、file:、user、card、application相关权限都勾上省事。如果是企业飞书或者有隐私数据最少要开这三个im:message收发消息im:chat获取会话信息contact:user.base:readonly读取用户基础信息权限页面支持批量导入 JSON把下面这份粘进去点确认就行{ scopes: { tenant: [ im:message, im:message.p2p_msg:readonly, im:message.group_at_msg:readonly, im:message:send_as_bot, im:resource, im:chat, im:chat.members:bot_access, contact:user.base:readonly, contact:user.employee_id:readonly, cardkit:card:read, cardkit:card:write ], user: [ im:chat.access_event.bot_p2p_chat:read ] } }权限配完点“创建版本”发布应用。填版本号和更新说明申请线上发布。如果你自己就是管理员审核秒过不是的话让管理员在飞书管理后台通过一下。发布成功后回到“凭证与基础信息”页面把 App ID 和 App Secret 复制出来。这两个是你机器人的钥匙别泄露。3. 可复制配置OpenClaw 写 settings.json 与飞书事件订阅3.1 把 TaoToken Key 写进 OpenClaw 配置OpenClaw 的模型配置集中在settings.json里。文件位置一般在 OpenClaw 安装目录下的config/settings.json如果你用的是默认安装可以在终端里用openclaw config path查一下具体路径。打开这个文件找到models或providers字段不同版本字段名略有差异以你本地为准把 TaoToken 的配置写进去。骨架如下{ providers: { taotoken: { base_url: https://taotoken.net/api, api_key: sk-你的Key, models: [ claude-sonnet-4-20250514, gpt-4o ] } }, default_model: claude-sonnet-4-20250514 }这里base_url一定写https://taotoken.net/api不要带末尾斜杠也不要加 UTM。api_key换成你在控制台生成的那串。models数组里列你打算用的模型名default_model选一个默认的。改完保存先别启动用一条命令验证配置能不能读到openclaw config validate如果输出Config OK之类的提示说明 JSON 格式和字段都没问题。报错的话多半是逗号或引号写错了按提示行号改。3.2 添加飞书频道并选择 WebSocket 长连接配置好模型之后把飞书频道加上。推荐用命令行向导比让 AI 自己装稳得多openclaw channels add向导会依次问你选择频道类型选Feishu安装方式选npm输入 App Secret粘贴飞书后台复制的那个输入 App ID同样粘贴连接模式选WebSocket长连接频道区域国内选Feishu海外选Lark私聊访问控制建议选“配对码模式”只有通过配对码验证的用户才能私聊走完向导OpenClaw 会自动把飞书频道写进配置并在网页控制台的频道列表里显示出来。如果你更习惯手动改配置也可以在settings.json的channels字段里加{ channels: { feishu: { app_id: cli_xxxxxxxx, app_secret: xxxxxxxx, connection_mode: websocket, region: feishu, dm_policy: pairing } } }两种方式效果一样向导适合第一次配手动改适合批量部署。3.3 飞书侧配置事件订阅频道接好了但飞书还不知道该把哪些消息推给 OpenClaw。回到飞书开发者后台进入“事件与回调”把事件订阅方式改成“长连接”。然后添加事件至少加这一项im.message.receive_v1接收消息其他按需加比如机器人进群、被移除群等。加完之后最关键的一步发布新版本。改了配置不发布不会生效很多人卡在这里以为配置没生效其实是版本没更新。发布后等审核通过飞书侧就齐了。4. 验证请求npm 启动后手机飞书收发消息4.1 启动 OpenClaw 并确认频道在线在终端里执行npm run start或者如果你全局装了 OpenClawopenclaw start启动后看日志应该能看到类似Feishu channel connected via WebSocket的输出。同时打开 OpenClaw 网页控制台在频道列表里确认飞书状态是“在线”。如果显示离线先检查 App ID / App Secret 有没有填错再看飞书事件订阅是不是选了长连接。4.2 手机飞书私聊配对在手机飞书里搜索你创建的机器人进入私聊随便发一句话比如“在吗”。机器人会返回一个配对码类似OpenClaw: access not configured. Your Feishu user id: ou_xxxxxxxx Pairing code: ABC123XY Ask the bot owner to approve with: openclaw pairing approve feishu ABC123XY拿到配对码后在电脑终端执行openclaw pairing approve feishu ABC123XY把ABC123XY换成你收到的码。执行成功会提示配对完成。然后再在手机飞书发一条消息这次 AI 应该能正常回复了。4.3 验证多媒体能力基础对话通了之后试一下发图片。在手机飞书里对机器人说帮我通过电脑摄像头拍一张照片然后发送图片给我OpenClaw 会调用本机摄像头拍照然后把图片发回飞书。如果第一次没发出来可能是技能没加载你可以补一句飞书支持发送图片、文件、音频、视频请把需要发送的文件放到 workspace 工作空间并记住发送方法AI 会去读飞书技能文档自己学会发送多媒体消息。之后录音、录视频、找文件都可以用类似的话术触发。实测下来让它自己研究一遍之后后面再发就顺了。5. 本篇常见错排查报错一Config validate failed: invalid JSON多半是settings.json里多了逗号或者引号没配对。用python -m json.tool settings.json检查一下格式或者把内容粘到在线 JSON 校验器里看哪一行报错。报错二飞书频道显示离线日志报app_id or app_secret invalid检查飞书后台的 App ID 和 App Secret 有没有复制错注意不要带空格。另外确认应用已经发布上线没发布的应用凭证是无效的。报错三手机发消息机器人没反应先看飞书事件订阅里有没有加im.message.receive_v1再看事件订阅方式是不是“长连接”。如果都对了检查 OpenClaw 日志有没有收到事件推送。有时候是配对没完成机器人会把消息拦下来按第 4.2 步重新配对即可。报错四模型调用返回 401说明 TaoToken 的 Key 不对或者没生效。去控制台确认 Key 状态是“启用”然后检查settings.json里api_key有没有写错。注意base_url必须是https://taotoken.net/api不要写成带/v1的路径OpenClaw 会自己拼。报错五图片发不出来提示file not foundOpenClaw 发多媒体文件时要求文件在 workspace 工作空间里。你让 AI 拍照或找文件时明确说“放到 workspace 工作空间”它就会把文件挪过去再发。如果还是不行检查飞书权限里im:resource有没有开。6. 长期跑通与 Key 管理建议如果你打算把这只虾长期养在飞书里建议把模型调用这层固定下来。TaoToken 的好处是一个 Key 管多个模型OpenClaw 里换模型只改default_model字段不用动 Key。长期编码或者跑 Agent 任务的话可以了解一下 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 适合需要稳定调用量的场景。日常排查问题时飞书里直接发斜杠命令就能控制 OpenClaw/new开新对话清上下文/verbose on开调试模式看执行细节。这两个命令不用打开网页控制台手机上就能操作实测挺方便。接入文档和 API Keys 管理分别在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 和 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 配置过程中遇到接口层面的问题可以先翻文档。整套流程跑通之后你手机飞书里就多了一个能操作电脑的 AI 助手拍照、录音、找文件都是一句话的事。
阅读完成 · 觉得有帮助？
