1. 为什么零基础也要把 OpenClaw 部署到阿里云并接上飞书
OpenClaw(原 Clawdbot,中间还叫过 Moltbot)是一个能跑在服务器上的 AI 任务执行框架,你可以把它理解成一个「住在云端的机器人管家」:飞书里发一句话,它在后台调用大模型干活,再把结果发回聊天窗口。2026 年这波更新之后,它的镜像更轻、插件生态更全,尤其是飞书连接器已经能覆盖消息收发、群聊监听、文档处理这些高频场景,所以越来越多非技术岗位的同学也想自己搭一套。
但零基础直接上手,最容易卡在三个地方:一是服务器环境不会配,Docker 装不上、端口没放行;二是飞书开放平台的应用权限和事件订阅填错,机器人收不到消息;三是模型调用的 Key 和 API 通道没打通,日志里全是 401 或者连接超时。这篇教程就按「阿里云环境准备 → OpenClaw 部署 → 飞书接入 → TaoToken 统一模型通道 → 验证与排障」的顺序走一遍,命令和配置都能直接复制,你跟着敲就行。
适合谁看:完全没碰过 Linux 的办公自动化爱好者、想给团队搭内部 AI 助手的运营同学、以及被各种 Key 管理搞烦了想统一通道的开发者。全程不需要你懂深度学习,只要会复制粘贴、会看日志报错,就能把「飞书发指令、AI 做执行」这条链路跑通。下面先从最核心的模型通道准备讲起,因为这一步决定了后面机器人能不能真正「说话」。
2. TaoToken 前置准备:统一 Key 与 API 通道怎么拿
OpenClaw 本身不绑定某一家模型,它通过 OpenAI 兼容的接口去调用后端模型。问题在于,如果你同时用几家模型,就得在配置文件里塞好几套 Key 和 Base URL,改起来容易漏、排障也麻烦。TaoToken 的作用就是把这些通道统一成一个入口:一个 Key、一个 Base URL,后面切换模型只改 Model ID 就行。对零基础来说,这能省掉大量「到底该填哪个地址」的纠结。
第一步,打开官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 注册并登录。进入控制台后找到 API Keys 页面,路径是 https://taotoken.net/console/api-keys ,点「创建新密钥」,起个能认出来的名字,比如openclaw-feishu,生成后立刻复制保存——这个 Key 只显示一次,关掉页面就看不到了。
第二步,确认你要用的模型 ID。在模型对话页面 https://taotoken.net/models 可以先试聊几句,确认这个模型能正常响应,再把它写进 OpenClaw 配置。常见的比如gpt-4o-mini、claude-3-5-sonnet这类,具体以你账号里可用的为准。记住三个要素:Base URL 填https://taotoken.net/api(注意这个地址不加任何 UTM 参数),API Key 填刚才复制的那串,Model ID 填你验证过的模型名。
第三步,如果你打算长期跑编码类或 Agent 类任务,可以顺手看一下 Coding Plan 页面 https://taotoken.net/coding-plan ,它更适合高频调用场景,额度策略和按量付费不太一样。接入文档在 https://taotoken.net/doc ,遇到参数不确定的时候翻一下,比在群里问快。这里要提醒一句:TaoToken 是合规的 API 聚合通道,不是所谓的中转代理,配置时按官方文档填就行,别去改什么奇怪的 hosts。
拿到这三样东西之后,先别急着部署 OpenClaw,可以在本地用 curl 测一下通道是否通:
curl https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer 你的TaoTokenKey" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-4o-mini", "messages": [{"role": "user", "content": "回复ok"}] }'如果返回的 JSON 里有choices字段和正常内容,说明 Key 和通道没问题,可以进入下一步。如果返回 401,先检查 Key 有没有复制全、有没有多余空格;如果返回模型不存在,回模型对话页面确认 Model ID 拼写。这一步花两分钟,能省掉后面在容器里反复重启的半小时。
3. 阿里云 ECS 环境准备与 OpenClaw 可复制配置
服务器这块,零基础建议直接用阿里云轻量应用服务器或者 ECS,镜像选 CentOS 8.x 或 Ubuntu 22.04 都行,内存至少 2GiB,低于这个 OpenClaw 跑起来会频繁 OOM。地域如果主要在国内用飞书,选华东或华北延迟更低;安全组要放行 22(SSH)、3000(OpenClaw 面板)、443(如果后面配 HTTPS)。买完之后记下公网 IP 和登录密码,用 SSH 连上去。
登录后先装 Docker 和 Docker Compose,这是 OpenClaw 的运行底座:
# 更新系统 yum update -y # 安装 Docker yum 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 --version # 安装 Docker Compose 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接着创建 OpenClaw 的工作目录和docker-compose.yml。这里我把 TaoToken 的环境变量直接写进去,这样容器启动时就能读到统一的 Key 和 Base URL:
mkdir -p /opt/openclaw && cd /opt/openclaw tee docker-compose.yml <<-'EOF' version: '3.8' services: openclaw: image: openclaw/openclaw:2026-latest container_name: openclaw-core restart: unless-stopped ports: - "3000:3000" environment: - NODE_ENV=production - PORT=3000 - LOG_LEVEL=info - OPENAI_API_KEY=你的TaoTokenKey - OPENAI_BASE_URL=https://taotoken.net/api - DEFAULT_MODEL=gpt-4o-mini volumes: - ./data:/app/data networks: - openclaw-network networks: openclaw-network: driver: bridge EOF注意OPENAI_BASE_URL后面不要加/v1,OpenClaw 内部会自己拼路径,加了反而会 404。DEFAULT_MODEL填你在 TaoToken 模型对话页面验证过的那个 ID。写完之后启动:
docker-compose up -d docker-compose logs curl http://localhost:3000/health看到{"status":"ok"}就说明服务起来了。如果日志里出现local proxy failed或者连接超时,八成是 Base URL 写错或者服务器出网被限制,先curl https://taotoken.net/api测一下网络。面板地址是http://你的公网IP:3000,首次登录默认账号admin、密码openclaw2026,进去第一件事就是改密码。
4. 飞书机器人接入与消息收发验证
飞书这边分两步:先在开放平台建应用拿凭证,再在 OpenClaw 里配连接器。打开 https://open.feishu.cn ,进「企业自建应用」→「创建应用」,类型选机器人,填个名字比如OpenClaw-AI助手。创建完在「凭证与基础信息」里记下 App ID、App Secret、Verification Token,这三个后面都要用。
权限管理里至少加这几个:im:message:readonly(读消息)、im:message:send_as_bot(以机器人身份发消息)、contact:user:readonly(读用户信息)。加完提交审批,企业管理员通过后才生效。事件订阅里,接收 URL 填http://你的公网IP:3000/feishu/webhook,订阅「接收消息」事件,保存时飞书会发一个验证请求,所以 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 tee config.json <<-'EOF' { "appId": "你的飞书App ID", "appSecret": "你的飞书App Secret", "verificationToken": "你的飞书Verification Token", "webhookUrl": "http://你的公网IP:3000/feishu/webhook", "autoReply": true, "model": "gpt-4o-mini", "apiBase": "https://taotoken.net/api", "apiKey": "你的TaoTokenKey" } EOF npm run start & exit docker-compose restart这里model、apiBase、apiKey三件套要和前面docker-compose.yml里保持一致,否则会出现「飞书能收到消息但机器人不回」的情况。配完之后在飞书里搜索你创建的机器人,加为联系人,发一句「帮我生成一份周工作总结模板」。正常的话十秒内会收到回复,同时服务器上docker exec -it openclaw-core tail -f /app/plugins/feishu-connector/logs/app.log能看到请求记录。
如果不想敲命令,OpenClaw 面板的「集成中心」→「飞书配置」也能填这些参数,点「测试连接」提示成功再保存,效果一样。群聊场景把机器人拉进群,在群设置里开启「允许机器人接收消息」即可。
5. 常见报错排查:401、local proxy failed、reading choices、OAuth
部署过程中最容易撞上的几类报错,我按实际遇到的频率排一下,你对照日志定位。
401 Unauthorized:出现在 OpenClaw 日志或飞书连接器日志里,说明 Key 不对。先确认OPENAI_API_KEY和连接器config.json里的apiKey是不是同一个、有没有多余空格或换行。如果 Key 没错,检查 Base URL 是不是写成了https://taotoken.net/api/v1,多这一层/v1会导致鉴权路径错位。改完docker-compose restart再试。
local proxy failed / connection refused:通常是服务器出网问题或者 Base URL 域名解析失败。在服务器上执行curl -v https://taotoken.net/api,如果卡住或报错,检查安全组出方向规则、DNS 配置。也有一种情况是容器内 DNS 没继承宿主机,可以在docker-compose.yml的 service 下加dns: 223.5.5.5再重启。
reading 'choices' of undefined:这个报错说明请求发出去了,但返回体里没有choices字段,一般是 Model ID 写错或者该模型在你账号下不可用。回 https://taotoken.net/models 确认模型名,注意大小写和连字符。还有一种可能是返回了错误 JSON,比如{"error": "..."},把完整返回打出来看error.message就行。
OAuth / token 相关报错:飞书侧如果提示 OAuth 失败,检查 App Secret 是否重新生成过、Verification Token 是否和开放平台一致。飞书事件订阅的 URL 验证失败时,先telnet 你的公网IP 3000确认端口通,再看 OpenClaw 是否在运行。如果用了 HTTPS 但证书没配好,飞书会拒绝回调,建议先用 HTTP 把链路跑通再上证书。
排查时养成看日志的习惯:OpenClaw 主日志用docker-compose logs -f openclaw,飞书连接器日志在容器内/app/plugins/feishu-connector/logs/。把报错原文复制出来搜,比盲猜快得多。
6. 部署完成后的通道选择与后续维护
链路跑通之后,日常维护其实不复杂。模型调用这块,如果你只是偶尔用飞书机器人处理文档、生成模板,按量付费的 API Key 就够了;如果团队里多人高频使用,或者要跑编码类、Agent 类长任务,可以看看 Coding Plan https://taotoken.net/coding-plan ,额度策略更适合持续调用。需要换模型时,只改DEFAULT_MODEL和连接器里的model字段,Base URL 和 Key 都不用动,这就是统一通道的好处。
安全方面,飞书 App Secret 和 TaoToken Key 每三个月轮换一次,轮换后同步更新docker-compose.yml和config.json再重启。服务器快照定期打,/opt/openclaw/data目录也建议每周备份一次。端口方面,3000 面板尽量不要直接暴露公网,可以只放行飞书回调需要的路径,或者前面挂一层 Nginx 做访问控制。
后续如果要扩展,OpenClaw 的插件目录支持自己写连接器,飞书文档协作、多维表格联动这些场景都能接。遇到配置问题优先翻接入文档 https://taotoken.net/doc ,参数含义和示例都有。整套跑下来,从买服务器到飞书收到第一条回复,顺利的话四十分钟左右,卡住的地方基本都在权限和端口上,按上面的排查顺序走一遍就能通。