1. 为什么我要把 OpenClaw 接到飞书上OpenClaw 是一个本地优先的开源 AI Agent你可以把它理解成一个「常驻在自己机器上的数字员工」它跑在你本机或服务器上通过大模型理解指令然后去执行读写文件、跑命令、查资料、发消息这类任务。它最大的特点是交互入口不是网页而是你日常用的消息平台——Telegram、Discord、Slack、飞书都行。对国内用户来说飞书是最顺手的选择企业自建应用支持 WebSocket 长连接不需要公网 IP也不用折腾内网穿透消息能实时推到本地的 OpenClaw 进程里。但真正动手时卡人的往往不是 OpenClaw 本身而是模型接入这一段。OpenClaw 要调用大模型就得配 API Key、Base URL、模型名如果你同时用 Anthropic、OpenAI、DeepSeek 好几家配置会散落在不同文件里换一个模型就要改一遍团队协作时更是每人一套 Key管理起来很乱。我这次的做法是用 TaoToken 做统一入口一个 Key、一个 API 通道把 OpenClaw 的模型请求全部收口配置文件里只维护一份凭证。下面这篇就把 Node.js 和 Docker 两种安装方式、飞书频道接入、以及 TaoToken 的配置骨架完整走一遍配置都能直接复制。适合谁看已经会用命令行、想在自己机器或小服务器上跑一个 AI Agent 的开发者想给团队搭一个飞书里能直接对话的自动化助手的同学以及被多模型 Key 管理烦到、想统一收口的人。如果你完全没碰过命令行建议先补一下 Node.js 和 Docker 的基础操作再往下看。2. 前置准备Node.js、Docker 与 TaoToken 统一 Key2.1 环境要求先对齐OpenClaw 对 Node.js 版本有硬要求必须 22.12.0 及以上低版本会在启动阶段直接报错。硬件上最低 1GB 内存能跑起来但真要让它同时处理消息和模型请求建议 4GB 以上硬盘留 5GB。操作系统 macOS、LinuxUbuntu 20.04都行Windows 官方不支持原生运行得走 WSL2。Node.js 版本管理我建议用 nvm别用系统包管理器装Ubuntu 自带的 Node 版本往往太旧后面会和你手动装的版本打架。装好后确认一下node -v # 期望输出 v22.12.0 或更高 npm -vDocker 方式则要求 Docker Engine 24 和 Docker Compose v2用docker compose version确认。2.2 为什么用 TaoToken 统一 KeyOpenClaw 的模型配置支持多家提供商但每接一家就要填一套凭证。TaoToken 的价值在于它提供一个兼容主流接口规范的统一 API 通道你只需要一个 Key就能在 OpenClaw 里切换不同模型不用为每家单独维护配置。对 OpenClaw 这种会把 Key 写进本地配置文件的工具来说凭证越少、越集中泄露面和维护成本就越低。你需要先去 TaoToken 控制台创建一个 API Key。入口在这里控制台创建和管理 Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Key 管理页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite创建完把 Key 复制出来形如sk-xxxx后面配置里会用到。API 的基础地址是https://taotoken.net/api注意这个地址不带任何查询参数配置时原样填入即可。2.3 飞书自建应用先建好飞书这边要提前准备去飞书开放平台创建一个「企业自建应用」拿到 App ID 和 App Secret。关键一步是在「事件订阅」里添加im.message.receive_v1事件否则 OpenClaw 收不到任何消息。连接方式选「长连接」这样不需要公网 IP。权限方面至少要开im:message相关的收发权限。这些在飞书后台点几下就能配好具体按钮位置飞书文档写得很清楚这里不展开。3. 安装 OpenClawNode.js 与 Docker 两条路3.1 Node.js 方式npm 全局安装如果你本机已经有 Node 22直接全局装npm install -g openclawlatest openclaw --version版本号能正常打印就说明装好了。接着跑初始化向导openclaw onboard --install-daemon--install-daemon会把它注册成后台服务开机自启。向导里会让你选 AI 提供商、填凭证、选模型、配 Gateway 端口。这里先随便选一个能跳过的选项模型凭证我们后面直接改配置文件用 TaoToken 统一填。3.2 Docker 方式服务器推荐Docker 隔离性更好适合放在服务器上长期跑。先克隆仓库git clone https://github.com/openclaw/openclaw.git cd openclaw ./docker-setup.sh这个脚本会自动构建镜像、跑一遍向导、并创建配置目录~/.openclaw。跑完后用 compose 管理服务docker compose up -d docker compose logs -f如果日志里出现权限错误EACCES大概率是挂载目录的属主不对执行sudo chown -R 1000:1000 ~/.openclawDocker 容器里 OpenClaw 以 UID 1000 运行宿主机目录属主对不上就会写不进去这个坑我第一次部署时踩过。3.3 两种方式怎么选本机日常用、想快速体验选 npm 方式改配置直接改本地文件调试方便。放服务器长期运行、或者你不想让 Agent 直接碰宿主机文件系统选 Docker安全边界更清晰。两种方式最终都会读写~/.openclaw/下的配置文件后面的配置对两者通用。4. 用 TaoToken 统一 Key 对接 OpenClaw 配置4.1 配置文件在哪OpenClaw 的主配置是~/.openclaw/openclaw.json。向导跑完后这个文件已经存在我们直接编辑它。Docker 方式下这个路径映射到容器内的对应目录改宿主机上的文件即可改完重启容器生效。4.2 模型与凭证配置骨架下面这份配置把模型请求指向 TaoToken 的统一通道。把apiKey换成你在控制台创建的那把 Key{ agent: { model: claude-sonnet-4-5, provider: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥 } }, gateway: { bind: loopback, port: 18789 }, exec: { ask: on }, channels: { feishu: { enabled: true, appId: cli_你的飞书AppID, appSecret: 你的飞书AppSecret, connectionMode: websocket, requireMention: true } } }几个关键点解释一下。provider.type用openai-compatible因为 TaoToken 提供的是兼容主流接口规范的通道OpenClaw 按这个类型去请求就能通。baseUrl填https://taotoken.net/api不要加多余路径。agent.model填你想用的模型名换模型只改这一行Key 和地址都不用动这就是统一入口的好处。gateway.bind设成loopback只允许本机访问千万别改成0.0.0.0暴露到公网。exec.ask设成onAgent 执行危险命令前会先问你这是保命配置。4.3 飞书频道配置要点飞书这段的connectionMode用websocket走长连接不需要公网 IP。requireMention设true表示群里要 机器人才响应避免它在群里乱插话。App ID 和 App Secret 从飞书开放平台的应用凭证页复制。如果你还想配 Telegram 做备用入口逻辑一样加一个telegram节点填 Bot Token 即可但飞书对国内网络环境更友好建议主力用飞书。4.4 配置校验改完配置先做一次健康检查openclaw doctor它会检查 Node 版本、配置文件语法、Gateway 端口占用、频道连通性。有报错按提示改别急着启动。5. 验证请求从飞书发一条消息跑通全链路5.1 启动服务并看日志npm 方式openclaw gateway restart openclaw gateway logs --followDocker 方式docker compose restart docker compose logs -f日志里应该能看到 Gateway 在 18789 端口监听以及飞书频道建立长连接成功的提示。5.2 飞书里发起对话在飞书里找到你创建的这个自建应用给它发一条消息比如「你好帮我列一下当前目录的文件」。第一次对话可能需要配对审批去终端执行openclaw pairing list openclaw pairing approve feishu 配对码批准后 Agent 就会响应。如果它成功调用了模型并返回结果说明 TaoToken 这条链路是通的。你可以在日志里看到模型请求的往返记录确认请求确实打到了taotoken.net/api。5.3 用模型对话页快速验证 Key如果你只想先确认 Key 本身可用不想动 OpenClaw可以直接在 TaoToken 的模型对话页发一条测试消息模型对话在线验证 Key 与模型https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite能正常返回内容说明 Key 和通道没问题剩下的就是 OpenClaw 配置的事了。这个排查顺序能帮你快速定位问题出在哪一层。5.4 验证成功的标志三个信号同时出现就算跑通飞书里收到 Agent 的回复终端日志里出现模型请求成功的记录openclaw gateway status显示服务运行中。到这一步你的 OpenClaw 已经是一个能在飞书里对话、背后由 TaoToken 统一供模型的 AI Agent 了。6. 本篇常见错误排查6.1 Node 版本冲突导致启动失败报错通常是Unsupported engine或启动即退出。原因是系统里存在多个 Node 版本OpenClaw 调到了旧的那个。解决用 nvm 装 22.12.0nvm use 22切过去再确认which node指向 nvm 的路径。Ubuntu 下如果之前用 apt 装过 nodejs建议先sudo apt purge nodejs libnode-dev清掉。6.2 飞书收不到消息最常见的原因是事件订阅没配im.message.receive_v1或者连接模式没选长连接。其次检查requireMention如果设了true群里必须 机器人才响应私聊不受影响。再确认配对是否已批准openclaw pairing list里如果还有待处理请求消息会被拦下。6.3 模型请求 401 或 404401 一般是 Key 填错或过期去控制台重新生成一把。404 多半是baseUrl写错了确认填的是https://taotoken.net/api不要多加/v1之类的路径也不要带查询参数。改完配置记得重启服务OpenClaw 不会热加载配置文件。6.4 Docker 权限错误日志里出现EACCES或permission denied执行sudo chown -R 1000:1000 ~/.openclaw。如果还不行检查 compose 文件里的 volume 映射路径是否和实际配置目录一致。6.5 端口 18789 被占用openclaw doctor会提示端口冲突。改配置文件里gateway.port为其他值比如 18790重启即可。改完记得同步更新你任何依赖这个端口的本地脚本。6.6 长连接频繁断开飞书长连接对网络稳定性有要求。如果日志里反复出现重连检查服务器出网是否稳定以及是否有中间设备掐断长连接。这种情况可以考虑把 OpenClaw 部署在出网更稳的环境里。7. 长期跑 Agent 与 Coding Plan 的选择如果你只是偶尔用飞书问几句上面这套配置足够了。但如果你打算让 OpenClaw 长期在线、频繁处理任务或者把它当成日常编码、自动化工作流的一部分模型调用量会明显上升这时候按量计费的成本和额度管理就需要提前规划。TaoToken 的 Coding Plan 面向的就是这种长期、高频的编码与 Agent 场景适合把 OpenClaw 这类常驻 Agent 的模型调用统一纳入一个额度体系里管理Coding Plan长期编码 / Agent 场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite接入相关的文档和参数说明都在这里配置遇到不确定的字段可以对照查接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteAPI Key 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite如果你用的是 Claude Code 这类 Anthropic 生态的工具TaoToken 也有对应的接入说明Claude Code / Anthropic 接入https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite我的建议是先用统一 Key 把 OpenClaw 跑通验证飞书链路和模型响应都正常再根据实际调用量决定要不要上 Coding Plan。别一上来就买大套餐先跑一周看看真实消耗这个顺序最稳。