先别急着装软件我得告诉你为什么值得折腾这件事。把 OpenClaw、Qwen 和飞书串起来之后你等于给自己配了一个 7x24 小时在线、能随叫随到的 AI 助理同事在飞书群里 它它就能替你查资料、写文档、处理文本、跑简单脚本而且这套链路走 Windows 10 完全没压力成本可以压到零。这篇教程我会把环境准备、大模型接入、飞书机器人创建、到最终群聊联调每一步都拆开讲中间还会穿插我实际踩过的坑和排查思路照着做基本能一次跑通。如果你之前没接触过 Agent 类工具也别被OpenClaw 接入飞书这种说法唬住。本质上就三件事在本机跑一个 Agent 框架、让这个框架能用 Qwen 模型思考、再给飞书机器人开一个传声筒接口。把这三件事拆开各自搞定整个项目就成了。1. 先把目标和环境想清楚这套方案到底是怎么跑的1.1 三条链路拆解整个系统里有三个角色OpenClaw 是大脑中枢Qwen 是思考核心飞书是交互界面。你坐在飞书里发消息消息通过机器人接口推送给 OpenClawOpenClaw 把任务交给 Qwen 模型做推理拿到结果后再通过机器人接口把回复发回飞书群。理解了这个流向后面所有配置出错你都能快速定位是哪个环节断了。思考核心Qwen负责理解你的问题、生成回答、规划步骤大脑中枢OpenClaw负责接收消息、管理会话、调用模型、控制权限交互界面飞书机器人负责把你说的话传进来把模型的回复传出去。很多人装到一半卡住就是没搞清这个问题到底是模型的问题还是 Agent 框架的问题还是飞书配置的问题。先建立这个分层意识后面排查会轻松很多。1.2 Windows 10 环境检查版本、内存、磁盘、网络先说系统版本。建议用 Windows 10 22H2这是 Win10 生命周期里最成熟的一个大版本如果你用的是 LTSC 企业版只要补丁较新问题也不大。老版本系统在安装新工具时可能会出现运行时库缺失比如缺少 VC Redistributable 导致 Python 包装完一跑就崩。这种问题排查起来很费时间所以第一步先确认你系统更新是开着的至少把近一年的关键补丁装上。硬件方面分两条路线看。如果走阿里云百炼 API 路线本机只是跑 OpenClaw 这个 Agent 框架内存 8GB 就够CPU 不挑。但如果走 Ollama 本地部署 Qwen 的免费路线模型推理是在本机跑的强烈建议内存 16GB 以上磁盘留出 30GB 左右。7B 参数的量化模型大概占用 4-6GB 存储运行时还要吃 6-8GB 内存4GB 内存的老机器跑 7B 模型会非常吃力还不如直接走 API 路线。网络方面你需要保证本机能正常访问外网——飞书开放平台的接口、阿里云百炼的接口、Python 包下载源都需要联网。另外注意如果电脑装的是公司版飞书或者单位网络有严格的白名单策略飞书长连接可能被拦后面我会专门说怎么避开这个坑。最后提一个很容易被忽略的点Windows 10 如果弹出许可证到期的提示先处理掉再安装。倒不是不能装而是这种弹窗可能会中断安装进程或者在 PowerShell 执行脚本时让会话意外退出别问我是怎么知道的。2. 装前置环境Python、Git、Node.js 一个都别跳2.1 Python 3.10 安装和 PATH 检查OpenClaw 是 Python 写的所以 Python 环境是整个链路的地基。我推荐直接装 Python 3.10 或 3.11不建议用 3.12 以上因为部分依赖库可能还没跟上。去 python.org 下载 Windows installer安装时有一个非常关键的勾选Add Python to PATH。很多人装完发现python命令用不了就是这一步没勾。勾上之后打开一个新的 PowerShell 窗口输入python --version如果你看到Python 3.10.x说明装好了。如果提示找不到命令可以手动把C:\Users\你的用户名\AppData\Local\Programs\Python\Python310\和同目录下的Scripts\两个路径加到系统环境变量的 PATH 里。2.2 Git 和 Node.js 的用途与安装要点Git 和 Node.js 看起来不相关但实际使用中几乎绕不开。OpenClaw 安装时可能需要拉取官方仓库代码或者后面安装社区插件这些都要用到 Git。Node.js 则是飞书开放平台某些调试工具和 OpenClaw 部分扩展组件的前置依赖。Git 安装没什么特殊要求git-scm.com 下载 Windows 版一路默认即可。唯一建议在安装时把Git from the command line and also from 3rd-party software选上这样 PowerShell 里直接能用git命令。Node.js 装 LTS 版本也就是长期支持版别追最新版。装完同样验证一下node --version npm --version两个命令都有输出就代表没问题。2.3 国内网络下 pip 换源和基础验证国内直连 Python 官方源装包经常慢到让人怀疑人生建议先把 pip 换到清华镜像源。在 PowerShell 里执行pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple顺带也把 git 拉取超时时间调一下防止后面 clone 大仓库时断掉git config --global http.lowSpeedLimit 1000 git config --global http.lowSpeedTimeout 60前置环境装完后最后验证一遍重新打开 PowerShell依次输入python --version、git --version、node --version三条命令都有输出这一节就算齐活了。我强烈建议每装完一个工具就重开一次终端因为 PATH 环境变量的变更只有在新会话里才生效同一个窗口里验证十有八九会误报没装上。3. 安装 OpenClaw从 pip 安装到跑通第一个对话3.1 安装命令与版本确认OpenClaw 的安装方式现在是统一的 Python 包分发建议先建一个虚拟环境再装免得和系统里的其他 Python 工具互相污染。我习惯这样操作py -3.10 -m venv openclaw-env .\openclaw-env\Scripts\Activate.ps1 pip install --upgrade pip pip install openclaw如果 PowerShell 提示无法加载脚本是因为系统默认禁止脚本执行需要先放开当前用户的执行策略Set-ExecutionPolicy -Scope CurrentUser RemoteSigned这个命令只对当前用户生效不会影响系统安全的整体配置。装完验证openclaw --version如果安装顺利会输出一个版本号。注意这个命令要在虚拟环境激活的状态下执行习惯了之后每次要启动 OpenClaw 前都得先激活环境。也可以把激活命令写成一个start-openclaw.bat脚本放在桌面省得每次手敲echo off cd /d %USERPROFILE%\openclaw-env call .\Scripts\Activate.bat openclaw3.2 openclaw configure 配置器怎么用OpenClaw 提供了一个交互式配置向导装完后第一次运行一般会引导你设置。如果没有自动弹出配置界面就手动执行openclaw configure这个配置器会问你几个问题选择模型提供商、填写 API 密钥、设置模型名称等。此时先别急着选因为我们要用的 Qwen 接入方式比较特殊直接选 OpenAI 兼容模式即可密钥和 base URL 接下来两节会讲到。配置文件通常生成在用户目录下的.openclaw文件夹里默认叫config.yaml。整个 Agent 的行为都在这个文件里控制比如默认模型、温度参数、系统提示词、最大上下文长度等等。你可以直接打开这个文件手动改改完重启 openclaw 进程就生效。我建议刚开始不要动太多参数先用默认值跑通再逐步调整。3.3 本地先跑一句话验证链路通不通模型配置好之后先不要急着接飞书直接在终端里跑一句openclaw启动后你会进入一个 Agent 交互界面在里面输入你好或者用一句话介绍一下你自己。如果它能回复说明 OpenClaw 到 Qwen 这一层已经通了。这是整个项目里最重要的一个验证节点——这个环节通过之前不要去做任何飞书相关的配置。否则到时候飞书没反应你根本不知道是模型的问题还是机器人接口的问题。终端里跑通之后按 CtrlC 或输入/exit退出。接下来才进入飞书接入环节。4. 接 Qwen 大模型免费路线和本地路线怎么选Qwen 是阿里巴巴开源的大模型系列接入方式目前主要两条路走阿里云百炼平台的 API需要联网或者用 Ollama 在本地跑开源权重完全离线。这个教程标题说完全免费我分别解释一下两条路线的真实成本。4.1 路线A阿里云百炼 DashScope 的 OpenAI 兼容接口阿里云百炼提供了一个 OpenAI 兼容的接口这意味着 OpenClaw 只需要配置成OpenAI 兼容模式把 base URL 指向 DashScope就能用上 Qwen 系列模型。这比用 SDK 接入简单得多。操作步骤打开阿里云百炼控制台注册并开通 DashScope 服务在 API-KEY 管理页面创建一个密钥形如sk-xxxx在 OpenClaw 的配置里Provider 选择OpenAI 兼容或自定义 OpenAI 类型填入以下关键参数参数值API Key百炼控制台创建的sk-开头的密钥Base URLhttps://dashscope.aliyuncs.com/compatible-mode/v1模型名qwen-plus或qwen-turbo在 Windows PowerShell 里也可以直接用环境变量验证$env:OPENAI_API_KEY 你的百炼API密钥 $env:OPENAI_BASE_URL https://dashscope.aliyuncs.com/compatible-mode/v1 $env:OPENAI_MODEL qwen-plus这样配置之后OpenClaw 发往 OpenAI 接口的请求就会被转发到 DashScope由 Qwen 模型处理。这里我建议用qwen-plus它比qwen-turbo智力更强比qwen-max便宜个人使用性价比最高。图片理解模型比如 qwen-image 系列这次不在范围内我们接的是文本对话链路。关于免费百炼为开通用户提供了一定的免费 token 额度新账号一般够用一阵子。但免费额度和永久免费是两回事日常重度使用终归会触发计费。个人轻度使用的话每月费用通常在几块钱以内如果你追求绝对零成本看路线B。4.2 路线BOllama 本地部署 QwenOllama 是一个本地模型运行工具Windows 版有图形界面装好后模型全部在本地跑不产生任何 API 费用断网也能用。这条路线是真正意义上的免费代价是你的电脑要扛得起推理负载。安装和拉取模型去 ollama.com 下载 Windows 版安装包装完右下角托盘会常驻一个 Ollama 图标打开 PowerShell执行ollama pull qwen2.5:7b这一步会拉取约 4GB 的模型文件网络差的话耐心等一下。也可以选择更小的qwen2.5:3b跑起来更快但智商明显降一档内存够用还是建议 7B。然后在 OpenClaw 配置里Provider 选择 OllamaBase URL 默认http://localhost:11434模型名填qwen2.5:7b。Ollama 的本地接口完全兼容 OpenAI 格式所以 OpenClaw 配起来非常顺。启动 OpenClaw 后模型第一次加载需要几秒到几十秒之后对话响应速度取决于你的 CPU/GPU 性能。如果电脑没有 NVIDIA 显卡纯 CPU 跑 7B 模型大概每秒出几个 token能忍但别指望它有 API 方案那么伶牙俐齿。4.3 两条路线对比和我的选择建议对比项百炼 API 路线Ollama 本地路线费用有免费额度超出后按量计费免费是否断网可用否是模型能力qwen-plus 较强响应快受限于本机性能安装复杂度低中适合人群不想折腾硬件、要稳定体验想零成本、数据不出本机我的建议是第一轮先用百炼 API 路线把全链路跑通因为出问题的环节少跑通稳定之后如果对数据隐私有要求或者想省那几块钱再切到 Ollama。两套方案的 OpenClaw 配置文件就是换 Provider 和模型名的事切换成本很低。5. 飞书开放平台配置创建机器人应用的完整流程飞书这边的步骤是最容易让人迷糊的因为飞书开放平台的菜单更新频繁不同版本的界面位置有出入。但核心逻辑不变创建应用、启用机器人能力、配置权限、配置事件订阅、发布版本。5.1 创建企业自建应用开启机器人能力打开飞书开放平台open.feishu.cn用你的飞书账号登录。点击创建应用类型选择企业自建应用不是商店应用——企业自建应用是自己内部用审核在自己手里流程最短。创建完成后进入应用详情页左侧菜单找到添加应用能力选择机器人启用。这个操作会在你的应用下挂一个机器人实例之后在飞书群里添加机器人时搜到的就是这个应用的名字。拿到两个关键凭证左侧菜单凭证与基础信息里能看到App ID和App Secret。这两个值后面要填进 OpenClaw先复制保存到一个记事本里。App Secret 相当于机器人的密码别截图发别人。5.2 权限管理该勾哪些权限飞书机器人要收发消息必须开通对应的权限。在权限管理页面搜索并开通以下几项权限代码作用im:message读取消息内容im:message:send_as_bot以机器人身份发送消息im:chat:read读取群信息im:chat:write更新群信息im:resource上传下载消息资源图片等这里有个很容易踩的坑权限分应用权限和用户权限两种我们要的是应用权限带以机器人身份字样的别勾错了。开通权限后必须创建版本并发布权限才会真正生效。在版本管理与发布里创建工作版本填写版本号和更新说明提交后如果自己就是企业管理员可以直接通过否则等管理员审批。很多人在这一步没发布就直接测试结果机器人能收到消息但发不出去日志里报权限错误。5.3 事件订阅长连接方式本地开发最省事飞书要把用户发的消息推送给 OpenClaw有两种方式回调 URL 和长连接。回调 URL 需要一个公网可访问的 HTTPS 地址本地开发还得配合内网穿透工具麻烦且容易出问题长连接是飞书开放平台提供的 WebSocket 订阅方式应用主动和飞书服务器建立连接不需要公网 IP。强烈建议选长连接。操作路径事件与回调 → 订阅方式 → 选择使用长连接接收事件 → 添加事件im.message.receive_v1消息接收事件。如果你想过滤掉非 消息可以先不加过滤等跑通了再在 OpenClaw 配置里做消息条件过滤。订阅事件加好后OpenClaw 启动时就能通过长连接收到飞书群里 机器人的消息。5.4 创建版本并发布在飞书里找到机器人回到版本管理与发布填写版本号如1.0.0可用范围选全部成员或指定成员提交发布。审核通过后打开飞书客户端创建一个测试群聊点群设置 → 群机器人 → 添加机器人在列表里搜到刚才创建的应用名字添加进群。到这里飞书侧的准备工作完成。你可以先在群里试一下给机器人发一条普通消息如果机器人没有任何反应是正常的——因为 OpenClaw 还没启动。下一节就开始接链路。6. 把 OpenClaw 接到飞书App ID、App Secret 填哪里6.1 OpenClaw 飞书 Channel 配置入口OpenClaw 把这类即时通讯接入叫 Channel频道飞书是其中的一个 Channel。在 OpenClaw 的配置文件里Channel 部分需要指定飞书的信息来源。配置向导通常会询问你要启用哪个 Channel可选飞书、Discord、Slack等。选择飞书后填入以下三项feishu: app_id: cli_xxxxx app_secret: 你的AppSecret # 如果事件订阅里设置了加密还需要填 Encrypt Keyapp_id即飞书开放平台里的 App ID通常是cli_开头app_secret就是创建应用时的那串密文。如果你的飞书应用在事件订阅里配置了 Encrypt Key也需要一起填进去。这些值填错任何一个启动时都会报认证失败或者连接断开所以填完之后反复核对一遍。配置完成后启动方式是一样的openclaw记得先激活虚拟环境。启动日志里如果出现类似Feishu channel connected或者长连接已建立的字样就说明 OpenClaw 已经和飞书服务器连上了。6.2 启动过程会看到什么日志正常启动过程大概会有这样几个阶段的输出加载配置 → 初始化模型连接 → 连接飞书长连接 → 提示监听成功。如果走到初始化模型连接就卡住多半是模型配置有问题回到第 4 节检查 API Key 和 Base URL如果卡在连接飞书长连接多半是 App ID 或 App Secret 错误或者是事件订阅没有配好。日志还有一个有用的地方当你往测试群里发消息不管 OpenClaw 有没有成功回复飞书的事件推送都会先在日志里出现。如果日志里能看到收到消息的事件但 agent 没有回复说明问题出在模型调用或 Agent 本身的处理逻辑如果连日志里都没有消息记录说明飞书到 OpenClaw 这一段没通优先检查事件订阅和应用权限。6.3 群里 机器人 测试完整链路到这一步在测试群里输入你的机器人 你好帮我介绍一下你自己正常情况下几十秒内你会看到机器人回复。如果第一次回复偏慢不要急着下结论模型加载和会话初始化都需要时间等一分钟再说。测试的时候我建议按这个顺序逐步放开先只发普通文字你好看机器人是否回复让它写一段 200 字的宣传文案验证生成能力让它把这段话改写成更口语化的版本验证多轮对话和上下文记忆尝试让它输出一个 markdown 格式的三行表格验证结构化输出。通过这四组测试基本可以确认链路完整可用。我在第一次跑通时在群里让它帮我整理一篇会议纪要它按要点列了出来那一刻你会觉得之前折腾的全部环境配置都值了。7. 实战排错我踩过的坑和解决办法7.1 session file locked 的排查链路启动时如果看到类似session file locked (timeout 60000ms)的报错别慌这个问题我遇到过好几次。原因通常是上一个 openclaw 进程没有正常退出会话文件仍被占用或者同一条命令在多个终端窗口里同时启动了 openclaw两个进程抢同一个会话文件。排查链路如下打开任务管理器结束所有 python 进程里的 openclaw 相关进程检查用户目录下的.openclaw文件夹找到以.session或类似后缀结尾的会话文件确认没有正在运行的 openclaw 进程后删除对应的锁文件通常是.lock结尾重新启动 openclaw报错消失。根本原因是 OpenClaw 的多进程会话锁机制同一时间只允许一个进程操作某个会话文件防止数据写乱。所以日常使用也要养成习惯——同一个配置目录只开一个 openclaw 进程。如果经常切换模型或修改配置改完先/exit退出再重新启动不要直接硬关终端很容易留下残留锁。7.2 飞书消息被截断怎么处理飞书机器人单条消息的长度有限制Qwen 如果一口气生成一长篇文章很容易超过飞书的单条消息上限表现就是回复到一半被切断。这个不是 OpenClaw 或 Qwen 坏了而是飞书平台的消息限制。处理办法有两个方向在对话时约束模型比如告诉它控制在 200 字以内分三点回复每点不超过 50 字。Qwen 对这类指令的遵循能力不错大部分情况能解决。调整 OpenClaw 的模型参数把max_tokens调低让单次生成的文本量减少多次追问分次获取。代价是回答复杂问题时可能会显得不够完整需要你连续追问补充。我个人习惯是两者结合日常提问会主动说简洁回答长文写作拆成先列提纲再分部分展开既规避了消息截断也提高了模型输出质量。7.3 agent 不应答、权限不足等几个高频问题机器人完全不应答先看 OpenClaw 启动日志里有没有收到消息事件。有事件但没回复检查模型 API 的余额或密钥是否过期连事件都没有检查事件订阅是否生效特别是长连接模式是否真的连接成功。提示权限不足 or 消息发送失败回到飞书开放平台检查应用是否发布了最新版本权限是否覆盖了im:message:send_as_bot。改权限之后必须重新创建版本并发布否则不生效。这点我至少踩过三次以为权限勾上就行了结果发布会漏了机器人闷声不响半天。机器人被 了却没有任何反应还有一个隐蔽原因是飞书机器人的可用范围。如果应用的可用范围没有覆盖你这个群虽然机器人进群了但它不会接收事件推送。在飞书管理后台把可用范围改成全部成员或者确认当前账号在可用范围内。每次修改配置后必须重启进程OpenClaw 不会热加载配置改完config.yaml或飞书参数必须退出重进。这是最高频的假故障来源——改了一堆配置发现没生效其实只是没重启。8. 从 Debug 到日常使用几个让我效率明显提升的配置习惯链路通了之后别急着收工。基于我实际用下来的体验有几个配置习惯能明显提升使用舒适度。第一个是给 OpenClaw 设置合适的系统提示词system prompt。在配置文件里可以指定一个系统提示词告诉 Agent你是我的个人助手回答简洁使用中文不确定的事情如实说明。这个提示词会影响所有对话的风格值得花几分钟打磨。第二个是确认当前会话的 Channel。在 Agent 交互界面里输入/channel可以查看当前通话接入了哪个平台。当你同时配了飞书和终端多个渠道时这个命令能快速确认消息是从哪个通道进来的排查问题时很好用。第三个是定期清理会话历史。OpenClaw 会存每个会话的上下文时间久了会越占越多。如果发现启动变慢或者模型记性变差在配置里把会话历史轮换周期调短或者手动删除旧会话文件能有效减轻负担。第四个是Windows 开机自启体验。如果希望机器人像真正的同事一样一直在岗可以用任务计划程序创建一个开机自启任务指向你的启动脚本start-openclaw.bat重启电脑后 OpenClaw 自动拉起。注意设置成只在用户登录时运行否则没有用户会话环境命令执行可能会失败。说到最后我想分享一个实际操作中很有用的技巧在测试群里给机器人起一个好记的名字并告诉同事问它比问我快。我自己已经习惯把临时性的信息检索、文案修改、格式转换这类重复脑力活丢给它真实体验是模型的水平不一定每次都惊艳但胜在随叫随到、不抱怨、不推诿。OpenClaw 这个框架最大的价值就是让 AI 从网页对话框里走出来住进你每天工作的聊天软件里。剩下的事情全靠你愿意在配置上多花这一下午。