1. 为什么要在飞书里跑 OpenClawOpenClaw 是一个能在你电脑上真正动手干活的开源个人 AI 助手它和普通聊天机器人的区别在于不只是回答问题还能读写文件、执行命令、定时处理任务。你可以把它理解成一个住在你电脑里的执行型助理而飞书就是你指挥它的对讲机。把 OpenClaw 接进飞书之后你在手机飞书里发一句“帮我看看 D 盘那个报表文件夹里有什么”它就能在你 Windows 主机上真的去翻目录然后把结果回给你。这套链路适合谁适合手上有台常开的 Windows 机器、想用聊天软件远程指挥 AI 干活的人。整个流程分两大块一是 Windows 下用 Node.js 和 PowerShell 把 OpenClaw 装起来二是到飞书开放平台建机器人、配事件订阅让消息能双向跑通。模型调用这块我用 TaoToken 的统一 Key 来收口一个 Key 走 API 通道省得在多个模型平台之间来回切。下面按“装环境 → 装 OpenClaw → 配模型 → 接飞书 → 验证 → 排障”的顺序走命令和配置都能直接复制。装之前先确认你的 Windows 是 10 或 11PowerShell 能正常打开磁盘留出至少 2GB 空间。2. 前置准备Node.js 与 TaoToken 统一 Key2.1 先把 Node.js 装好OpenClaw 跑在 Node.js 上版本建议 v22.x 以上。虽然一键安装脚本会尝试自动装依赖但自己先装好能少踩很多坑。到 Node.js 官网下载 Windows 安装包选 LTS 或 Current 都行装完打开 PowerShell 验证node -v npm -v正常会输出类似v22.14.0和10.9.0的版本号。如果提示“不是内部或外部命令”说明环境变量没生效关掉 PowerShell 重开一次还不行就重启电脑。2.2 准备 TaoToken 统一 KeyOpenClaw 要调用大模型才能干活这里用 TaoToken 做统一入口。它的好处是一个 Key 就能走 API 通道模型切换、额度管理都在一个后台看不用每个模型平台单独注册。操作路径打开 TaoToken 官网进控制台在 API Keys 页面创建一个新 Key复制出来先存好。这个 Key 后面会填进 OpenClaw 的模型配置里。如果你还没账号先注册再建 Key整个过程几分钟。注意Key 只在创建时完整显示一次复制后妥善保存别直接贴到公开的聊天记录或截图里。TaoToken 的 API 地址是https://taotoken.net/api这个地址在配置模型通道时会用到。控制台里还能看到模型列表和用量方便你后面排查是 Key 的问题还是模型名写错了。3. 安装 OpenClaw 并写入 config.toml3.1 放开 PowerShell 执行权限以管理员身份运行 PowerShell按 Win 键搜索 PowerShell右键选“以管理员身份运行”。然后依次执行两条命令Set-ExecutionPolicy RemoteSigned -Scope CurrentUser Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass第一条让当前用户可以运行本地和下载的脚本第二条只对当前这个进程生效关掉窗口就失效属于临时放行。这两条只影响你自己的账户不动系统其他部分。3.2 执行一键安装在同一个 PowerShell 窗口里粘贴iwr -useb https://openclaw.ai/install.ps1 | iex脚本会自动检测环境、装依赖、下载核心文件、配环境变量然后进入配置向导。如果中途报错多半是 Node 环境的问题回到 2.1 确认node -v能正常输出再重跑一次。3.3 配置向导怎么选向导里会依次问几件事风险告知选 Yes 继续模式选 QuickStart接着填模型 API Key。这里就是 TaoToken 统一 Key 上场的地方——把 2.2 里复制的 Key 填进去模型通道指向 TaoToken 的 API 地址。通讯平台这一步先跳过飞书我们后面单独配因为它的参数比较多混在向导里容易乱。Skills 和 Hooks 也先选 No后面在 Web UI 里补。向导跑完会自动开一个新窗口启动服务等大约 30 秒回到配置窗口选“Open the Web UI”浏览器会打开http://127.0.0.1:18789这个控制面板。3.4 config.toml 骨架OpenClaw 的配置集中在config.toml里Windows 下一般在用户目录的.openclaw文件夹。下面是一份可复制的骨架重点是模型段走 TaoToken 通道[model] provider openai-compatible api_key 你的TaoToken统一Key base_url https://taotoken.net/api model glm-4.7 [gateway] port 18789 [plugins.feishu] enabled true app_id cli_你的飞书AppID app_secret 你的飞书AppSecret domain feishu allow_group truebase_url指向 TaoToken 的 API 地址api_key填统一 Keymodel按你控制台里可用的模型名写。飞书那段先留空也行等第 4 章拿到 AppID 和 AppSecret 再回填。改完配置记得重启服务让配置生效。4. 接入飞书机器人事件订阅与长连接4.1 创建飞书应用打开飞书开放平台进开发者后台点创建企业自建应用填应用名称和描述。创建完进“凭证与基础信息”页把 AppID 和 AppSecret 复制出来回填到上面 config.toml 的[plugins.feishu]段。4.2 加机器人能力和权限在应用功能里添加“机器人”能力。然后到权限管理把即时通讯相关的权限开全重点是接收消息、发送消息、获取群组信息这几项。权限不开全后面消息能进来但回不出去。4.3 安装飞书插件回到 PowerShell执行openclaw plugins install m1heng-clawd/feishu装完新开一个窗口跑openclaw config在渠道里选飞书填 AppID、AppSecret域名选中国的feishu接受群组聊天选是一路确认后重启服务。控制面板里能看到飞书插件状态变成已启用。4.4 配事件回调走长连接回飞书后台在事件订阅里选“使用长连接接收事件”。选完之后“添加事件”按钮才会从灰色变可点。添加“接收消息”事件再补一个获取通讯录基本信息的权限然后创建版本并发布到飞书客户端里审批通过。4.5 在飞书里发第一条消息发布通过后在飞书里找到你的机器人发一句“你好帮我看看当前目录有什么文件”。消息会通过长连接推到本机 OpenClaw它调用 TaoToken 通道的模型生成回复再经飞书发回来。第一次响应可能慢几秒属于正常。5. 验证请求与成功结果5.1 命令行验证模型通道在确认飞书链路之前先用命令行单独验证 TaoToken 通道通不通这样出问题好定位是模型还是飞书的事curl https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer 你的TaoToken统一Key -H Content-Type: application/json -d {\model\:\glm-4.7\,\messages\:[{\role\:\user\,\content\:\说一句话测试\}]}返回里带choices字段和一段回复内容就说明 Key、地址、模型名三者都对。如果返回 401是 Key 的问题返回 404多半是模型名写错连接超时则检查本机网络和防火墙。5.2 服务状态检查openclaw status openclaw healthstatus看服务在不在跑health做一次健康检查。两个都正常再回飞书发消息测试。实测下来先命令行通、再飞书通这个顺序排查效率最高。5.3 成功的样子飞书里机器人正常回复控制面板http://127.0.0.1:18789能看到会话记录和插件状态PowerShell 窗口没有报错刷屏。到这一步消息收发和 AI 回复就整条跑通了。6. 本篇常见错排查Q1装飞书插件报spawn npm ENOENT这是 Windows 下 npm 调用方式的问题。找到 OpenClaw 安装目录下的dist/process/exec.js定位runCommandWithTimeout里的spawn调用在 Windows 平台下给 npm 加上shell: truelet command argv[0]; let useShell false; if (process.platform win32 path.basename(command) npm) { useShell true; } const child spawn(command, argv.slice(1), { stdio, cwd, env: resolvedEnv, shell: useShell, });改完保存重跑插件安装命令。Q2提示 openclaw 命令找不到关掉所有 PowerShell 窗口重开让环境变量重新加载。还不行就重启电脑。这是 PATH 没刷新导致的不是安装失败。Q3安装卡住不动按 CtrlC 中断跑openclaw doctor看诊断结果。如果提示网络问题检查防火墙有没有拦 Node 进程。Q4API Key 配置错误跑openclaw onboard重新进向导重填 TaoToken 统一 Key确认没有多余空格base_url是https://taotoken.net/api。Q5端口 18789 被占用换端口启动openclaw gateway --port 18790同时把 config.toml 里的[gateway] port一起改掉保持一致。Q6飞书消息发出去没回复先看openclaw status服务在不在再看飞书后台事件订阅是不是选了长连接、接收消息事件有没有加、版本有没有重新发布。这三处任一没做消息都进不来。整条链路跑通后你可以在飞书里直接指挥 OpenClaw 处理本机任务模型调用统一走 TaoToken 的 Key 和 API 通道换模型只改 config.toml 里一行。想验证模型效果就去模型对话页试几句长期挂着跑编码或 Agent 任务的话Coding Plan 更划算Key 和额度都在控制台的 API Keys 页面管理。