OpenClaw 配 TaoToken:部署飞书机器人时 API Key 这样填 📅 发布时间:2026/9/14 7:21:45 👁 浏览次数: OpenClaw 接飞书最难的不是装 Docker而是模型 API Key。原教程默认去阿里云百炼控制台拿 Key很多人没有账号卡在这一步就停了。TaoTokenhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 是一个统一 API 通道注册后创建 Key回到 OpenClaw 填 Base URL 和 Key模型调用就通了。下面按 OpenClaw 接飞书的完整流程走一遍重点讲 API Key 怎么填。1. 为什么这套组合能跑通OpenClaw 飞书 TaoToken1.1 三个组件各干各的活OpenClaw原 Clawdbot / Moltbot负责接收飞书消息、拆解任务、调模型去执行最后把结果回传到飞书。阿里云 ECS 负责 7×24 小时稳定运行飞书是聊天入口TaoToken 在这里做模型通道。没有模型通道OpenClaw 只是一个空壳收到指令后没法真正“思考”和“干活”。原教程默认你去阿里云百炼控制台创建 API-Key但 OpenClaw 本身并不要求必须用哪家云厂商的密钥它只需要一个能提供大模型推理能力的接口。TaoToken 做的就是这件事把各大模型的调用统一成一个 Base URL你只要拿一个 Key就能让 OpenClaw 具备模型调用能力。1.2 为什么不用百炼非要换 TaoToken很多人在第一步就被卡住没有百炼账号、没有阿里云实名认证、或者公司已经有其他模型服务的 Key不想每个工具各配一套。TaoToken 的做法是提供一个 OpenAI 兼容的 API 通道注册、创建 Key 全在网页上完成之后把它当作 OpenClaw 的大模型接口来源。也就是说你不需要为了一个飞书机器人再去开通一个云厂商的模型服务。TaoToken 是合规的 API 兼容通道不是代理工具也不是什么“破解 Key”。它的定位是统一接入层你只管用模型侧参数、模型 ID、用量明细都在控制台里看。1.3 部署前置条件阿里云账号需要实名认证能创建 ECS 或轻量应用服务器。飞书账号需要有企业管理员权限才能创建自建应用、配置权限和事件订阅。本地电脑可以访问阿里云控制台、飞书开放平台以及 TaoToken 官网。技术基础会基本的 Linux 命令即可本文给完整命令不用深入掌握 Docker 原理。2. 一键部署 OpenClawAPI Key 别再填百炼了2.1 在阿里云上拉起 OpenClaw 镜像进入阿里云 OpenClaw 一键部署专题页点“一键购买并部署”。配置参考镜像OpenClaw(Moltbot) 镜像。已经买过服务器的可以重置系统重新选镜像。实例内存必须 2 GiB 及以上。地域默认美国弗吉尼亚。目前中国内地域除香港的轻量应用服务器联网搜索功能受限建议按官方说明选地域。时长按预算选。等服务器创建的时候刚好可以去做下一步拿 TaoToken 的 Key。2.2 先去 TaoToken 官网拿 Key打开 TaoToken 注册账号进入控制台创建 API Key。创建后复制那串 Key本文统一用 YOUR_API_KEY 占位。这一步对应原教程里“打开阿里云百炼控制台创建 API-Key”的位置只是换了个更通用的入口。注意控制台里能看到的模型列表、调用用量都在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 这个网页上。注册、创建 Key、看模型广场、看用量都去官网网页填进 OpenClaw 的地址是接口地址两者不要混。2.3 回到轻量服务器「应用详情」完成配置服务器创建好后进入轻量应用服务器控制台找到安装好 OpenClaw 的实例。在「应用详情」面板里按顺序做三件事放行 18789 端口单击“一键放通”把防火墙端口放行否则后面访问不了 OpenClaw 控制台。配置模型参数在原来的“百炼 API-Key”配置位置改填 TaoToken 的信息。Base URL 填 https://taotoken.net/api API Key 填 YOUR_API_KEY模型 ID 不要自己编打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 的模型广场看当前可用模型是什么 ID 就填什么。单击“执行命令”让配置写入 OpenClaw。这一步会把 API Key 和相关参数持久化到服务器环境里。2.4 手动部署时怎么注入这组参数如果你不是用一键部署而是自己写 docker-compose.yml可以把模型参数放进 OpenClaw 服务的 environment 里services: openclaw: image: openclaw/openclaw:2026-latest container_name: openclaw-core restart: unless-stopped ports: - 3000:3000 environment: - OPENAI_API_KEYYOUR_API_KEY - OPENAI_BASE_URLhttps://taotoken.net/api - OPENAI_MODEL以TaoToken模型广场为准 volumes: - ./data:/app/data特别说一句接口地址是 https://taotoken.net/api 末尾不要加 /v1。很多工具默认带 /v1OpenClaw 这时候会报 404。官网网页和接口地址不要混网页是给人操作的接口是给程序填的。3. 阿里云 ECS 环境准备与 Docker 安装3.1 创建 ECS 实例登录阿里云控制台进入 ECS 云服务器模块点“创建实例”。配置参数地域选择就近区域比如华东 2、华北 2降低网络延迟。实例规格入门级选 2 核 4Gecs.g6.large企业级推荐 4 核 8G。镜像CentOS 8.x 64 位阿里云官方镜像。存储40GB 高效云盘。网络分配公网 IP带宽按需求设置推荐 4Mbps 以上。安全组开放 22、80、443、3000 端口。购买完成后记录实例公网 IP 和登录密码。3.2 SSH 登录并初始化系统ssh root你的服务器公网IP yum update -y3.3 安装 Docker 和 Docker Composeyum install -y yum-utils device-mapper-persistent-data lvm2 yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo yum install -y docker-ce docker-ce-cli containerd.io systemctl start docker systemctl enable docker docker --versionCompose 也要装curl -L https://github.com/docker/compose/releases/download/v2.24.6/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose chmod x /usr/local/bin/docker-compose docker-compose --version建议关闭 firewalld避免后面端口拦截排查半天systemctl stop firewalld systemctl disable firewalld最后配置阿里云镜像加速解决拉取镜像慢的问题。登录阿里云容器镜像服务控制台复制你自己的加速地址替换下面命令里的“你的加速地址”mkdir -p /etc/docker tee /etc/docker/daemon.json -EOF { registry-mirrors: [https://你的加速地址.mirror.aliyuncs.com] } EOF systemctl daemon-reload systemctl restart docker4. 手动部署 OpenClawDocker Compose 配置4.1 创建项目目录和 compose 文件如果已经用一键部署这段可以跳过直接看第 5 节飞书配置。手动部署的话先建目录mkdir -p /opt/openclaw cd /opt/openclaw创建 docker-compose.ymlversion: 3.8 services: openclaw: image: openclaw/openclaw:2026-latest container_name: openclaw-core restart: unless-stopped ports: - 3000:3000 environment: - NODE_ENVproduction - PORT3000 - LOG_LEVELinfo - OPENAI_API_KEYYOUR_API_KEY - OPENAI_BASE_URLhttps://taotoken.net/api - OPENAI_MODEL以TaoToken模型广场为准 volumes: - ./data:/app/data如果你的一键部署面板已经写好了模型参数这里就不要再重复设置避免环境变量覆盖冲突。4.2 启动并检查服务docker-compose up -d docker-compose logs curl http://localhost:3000/health日志里没有 ERROR健康检查返回 {status:ok}说明 OpenClaw 已经起来模型通道也指向了 TaoToken。5. 飞书接入配置自建应用 机器人5.1 在飞书开放平台创建自建应用登录飞书开放平台进入“企业自建应用”创建一个应用类型选“机器人”。名称随意比如“OpenClaw-AI助手”。创建后记录三个核心凭证App ID、App Secret、Verification Token。5.2 配置权限在「权限管理」里申请以下权限并提交审批im:message:readonly读取消息im:message:send_as_bot以机器人身份发送消息contact:user:readonly读取用户信息企业管理员审批通过后权限才真正生效。5.3 配置事件订阅 URL事件接收 URL 填http://你的服务器公网IP:3000/feishu/webhook订阅“接收消息”“消息已读”等核心事件。点击保存后飞书会验证 URL确保 OpenClaw 服务正常运行否则会出现“验证失败”。这一步不受 TaoToken 影响只要 OpenClaw 服务活着就没问题。5.4 安装飞书插件并写入凭证进入 OpenClaw 容器docker exec -it openclaw-core /bin/bash安装飞书插件cd /app/plugins git clone https://github.com/openclaw-team/feishu-connector.git cd feishu-connector npm install写配置文件 config.json{ appId: 你的飞书App ID, appSecret: 你的飞书App Secret, verificationToken: 你的飞书Verification Token, webhookUrl: http://你的服务器公网IP:3000/feishu/webhook, autoReply: true, allowedChatIds: [允许访问的飞书群ID可选], adminUserIds: [管理员飞书ID] }保存后启动插件并退出容器npm run start exit docker-compose restart如果你不习惯命令行还有可视化路径进入 OpenClaw 管理后台“集成中心”→“飞书配置”把 App ID、App Secret、Verification Token 粘贴进去点“测试连接”提示连接成功就保存。这就是原教程里的双路径二选一即可。6. 联动验证在飞书里发一条指令试试6.1 发指令前的检查清单在飞书客户端搜索“OpenClaw-AI助手”添加为联系人。确认三件事TaoToken Key 已经写入 OpenClaw飞书插件已经启动服务器 3000 端口能公网访问。6.2 发送测试指令给机器人发一句“帮我生成一份周工作总结模板”。正常情况下 10 秒内会收到模板回复。这时打开 TaoToken 官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end控制台能看到这一次调用的用量记录。这一步非常重要日志只能证明请求发出去了用量记录才能说明模型调用真的走了 TaoToken。7. 常见问题排查卡在哪个环节就查哪里7.1 飞书消息无响应顺着链路查。先测端口telnet 你的服务器公网IP 3000 netstat -tulpn | grep 3000端口通再查飞书插件日志docker exec -it openclaw-core cat /app/plugins/feishu-connector/logs/error.log日志里如果出现 401说明 API Key 不对出现 404先检查 Base URL 是不是写成了 https://taotoken.net/api/v1 把 /v1 去掉。如果提示模型不存在就去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 的模型广场核对你在 OpenClaw 里填的模型 ID。7.2 OpenClaw 启动失败systemctl status docker docker-compose logs openclaw df -h启动失败大多是 Docker 没起来或者磁盘空间不足。确保可用空间在 10GB 以上。7.3 飞书权限验证失败事件订阅 URL 要填 http://你的服务器公网IP:3000/feishu/webhook而不是 https。飞书如果配置了 IP 白名单记得把服务器公网 IP 加进去。还不行就重新生成 Verification Token更新到 OpenClaw 配置里再测。7.4 模型调用没记录如果在 TaoToken 控制台看不到用量但飞书能回复说明 OpenClaw 可能走了自己内置的默认模型而不是我们配的 TaoToken。检查环境变量是否真的传进了容器docker exec openclaw-core env | grep OPENAI没有输出说明 compose 里的 environment 没生效回到第 4.1 节确认配置后重新 docker-compose up -d。8. 跑通之后的运维与最佳实践8.1 安全加固TaoToken 的 Key 等同于你账号的通行证不要写进前端页面或提交到公开仓库。建议在 OpenClaw 的配置里单独使用环境变量不要把明文 Key 留在业务代码里。飞书那边每 3 个月轮换一次 App SecretOpenClaw 管理员密码也要定期改。8.2 按场景控制权限个人使用机器人只对你自己开放企业使用按照部门划分 allowedChatIds 和 adminUserIds避免敏感信息泄露到非授权群聊。8.3 日常运维命令docker-compose ps docker exec -it openclaw-core tail -f /app/plugins/feishu-connector/logs/app.log cp -r /opt/openclaw/data /opt/openclaw/data-backup-$(date %Y%m%d) docker-compose pull docker-compose up -d8.4 让 AI 只在它该在的地方干活OpenClaw 可以生成代码、SQL、运维脚本但不要让它在你的生产服务器上直接操作数据库或业务系统。诊断 SQL、编译运行、修改配置这类操作由你在本地或服务器终端执行再把结果贴回对话里避免 AI 误操作。最后留两个小任务给你先去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册并创建一个 API Key然后把第 2.3 节的参数填进 OpenClaw在飞书里发一条“帮我整理今日待办”的指令。等你在 TaoToken 控制台看到第一笔调用记录这套链路就算彻底跑通了。之后无论是换模型、加群聊机器人还是做权限隔离都只是配置层面的微调。