拓十年匠心定制 · 商业建站与技术教学双线并行 咨询热线:400-886-1026 service@lmnt.cn
ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

让Mac mini全天替你干活:OpenClaw接入飞书与公网发布实战(TaoToken统一Key版)

让Mac mini全天替你干活:OpenClaw接入飞书与公网发布实战(TaoToken统一Key版)

1. 为什么要把 Mac mini 改造成 OpenClaw 常驻主机

Mac mini 这类设备放在桌角长期通电,功耗低、噪音小,如果只是偶尔开机办公,其实挺浪费。把它当成一台家庭 AI 服务器来用,反而更符合它的定位。OpenClaw 就是能把这台小主机盘活的那类工具——它不是浏览器里的聊天框,而是一套能读写文件、执行命令、调用系统工具的本地智能体。部署在 Mac mini 上之后,它可以整理资料、生成代码、做文档,甚至按指令打开应用处理本地任务。

但只在浏览器里用,还没真正发挥“全天在线”的价值。真正的痛点是:你人在外面,想让它干活,却还得回家打开控制页面。解决办法是把 OpenClaw 接入飞书机器人,再用 cpolar 做公网发布。这样你在手机飞书里发一条消息,家里的 Mac mini 就会执行任务并把结果回传给你。整套链路是:飞书消息 → OpenClaw 网关 → 本地模型调用 → 执行工具 → 回传结果。

这篇教程面向的是手里有 Mac mini、想搭一套“随叫随到”本地智能体的朋友。我会交付可复制的 OpenClaw 配置文件、飞书应用凭证填写步骤、cpolar 隧道启动命令,以及用 TaoToken 统一 Key 管理模型调用的验证动作。模型调用这块,我建议用 TaoToken 做统一入口,一个 Key 就能切换不同模型,省得在多个平台之间来回注册、复制密钥。下面从环境准备开始,一步步走完。

2. TaoToken 统一 Key 与 OpenClaw 模型通道准备

在配置 OpenClaw 的模型提供商之前,先把模型调用通道理清楚。OpenClaw 支持 OpenAI 兼容接口,所以只要有一个兼容 OpenAI 协议的 Base URL 和 API Key,就能接进去。TaoToken 提供的正是这种统一通道:官网是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,API 地址是 https://taotoken.net/api 。它的价值在于,你不用为每个模型单独注册平台、单独管密钥,一个 Key 就能在多个模型之间切换,对 OpenClaw 这种需要频繁调模型的场景很友好。

具体操作上,先到 TaoToken 控制台创建一个 API Key。控制台入口在 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console 。创建好之后复制下来,后面填进 OpenClaw 的配置里。如果你还不确定用哪个模型,可以先到模型对话页面试一下 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=model ,确认模型 ID 再填进配置。API Key 管理页面在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys ,接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc 。

这里要强调一个概念:OpenClaw 配置模型时,需要三件套——Base URL、API Key、Model ID。Base URL 填 TaoToken 的 API 地址,API Key 填刚才创建的 Key,Model ID 填你要用的模型标识。这三样缺一不可,后面在 OpenClaw 的配置向导里会依次用到。如果你打算长期跑编码类任务或 Agent 工作流,可以考虑 Coding Plan,入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan ,它更适合高频调用场景。

环境准备方面,Mac mini 上需要先装好 Homebrew、Node.js 22 和 Git。Homebrew 是 macOS 的包管理器,装好之后 Node 和 Git 都能一行命令搞定。先确认 Homebrew 是否已安装:

brew -v

如果提示版本信息就跳过安装,否则执行官方脚本:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后按终端提示把 brew 加入 PATH。接着装 Node.js 22:

brew install node@22 echo 'export PATH="/opt/homebrew/opt/node@22/bin:$PATH"' >> ~/.zshrc source ~/.zshrc node -v npm -v git --version

看到 v22.x.x 和 git version 2.x.x 就说明环境就绪。Node 版本必须 22 及以上,Git 没有硬性要求。这一步踩过的坑是:如果 Node 版本低于 22,OpenClaw 安装脚本会报错退出,所以务必先确认版本。

3. OpenClaw 安装与可复制配置文件

环境打好地基后,把 OpenClaw 装进 Mac mini。官方提供一键安装脚本:

curl -fsSL https://openclaw.ai/install.sh | bash

安装完成后会进入配置向导。如果中途误选 NO 退出,可以用openclaw onboard --install-daemon重新进入。向导里选择 QuickStart 快速开始,然后来到 Model/auth provider 模型提供商选择界面。这里选 Custom Provider 自定义配置,因为我们要接 TaoToken 的统一通道。

接下来依次填写三件套。API Base URL 填:

https://taotoken.net/api

然后选择 Paste API key now,粘贴你在 TaoToken 控制台创建的 API Key。接口兼容性选 OpenAI-compatible。Model ID 填你要用的模型标识,比如你在模型对话页面确认过的那个。填完等待验证,出现 Verification successful 就代表通道打通了。

除了向导,OpenClaw 也支持直接编辑配置文件。配置文件通常位于~/.openclaw/config.json,你可以用下面的 JSON 片段作为参考,把三件套写进去:

{ "models": { "provider": "custom", "baseUrl": "https://taotoken.net/api", "apiKey": "你的TaoToken_API_Key", "modelId": "你的模型ID", "endpoints": "openai-compatible" }, "tools": { "profile": "coding" }, "gateway": { "enabled": true } }

如果你更习惯 TOML 风格,也可以用等价的配置结构:

[models] provider = "custom" baseUrl = "https://taotoken.net/api" apiKey = "你的TaoToken_API_Key" modelId = "你的模型ID" endpoints = "openai-compatible" [tools] profile = "coding" [gateway] enabled = true

改完配置后重启网关生效:

openclaw gateway restart

这里有个细节:tools.profile默认是 coding,包含文件读写、执行命令等基础工具。如果你后面要让 OpenClaw 发图片、控制浏览器、操作飞书文档,需要切到 full。切换命令是:

openclaw config set tools.profile full openclaw gateway restart

注意 full 模式下 OpenClaw 拥有几乎全部工具权限,包括发消息、读写文件、执行命令、浏览器控制。建议只在受信任环境使用,不要暴露给不可信人员。配置完成后,可以用openclaw config get models检查三件套是否写入正确。

4. 飞书机器人接入与 cpolar 公网发布验证

模型通道打通后,接下来接飞书。在 OpenClaw 配置向导的 Select channel 页面选 Feishu/飞书,然后选 Download from npm 下载插件。下载完成后会提示输入 App Secret,这时需要先去飞书开放平台创建应用。

打开飞书开放平台 https://open.feishu.cn/?lang=zh-CN ,登录后进入开发者后台,点击创建企业自建应用,填写应用名称、描述和图标。创建完成后进入应用详情,在添加应用能力页面点机器人 > 添加。然后在权限管理页面点批量导入,粘贴下面的 JSON 一键导入所需权限:

{ "scopes": { "tenant": [ "aily:file:read", "aily:file:write", "application:application.app_message_stats.overview:readonly", "application:application:self_manage", "application:bot.menu:write", "cardkit:card:write", "contact:user.employee_id:readonly", "corehr:file:download", "docs:document.content:read", "event:ip_list", "im:chat", "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:message", "im:message.group_at_msg:readonly", "im:message.group_msg", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "im:resource", "sheets:spreadsheet", "wiki:wiki:readonly" ], "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"] } }

导入后点申请开通、确认。接着到凭证与基础信息页面,复制 App Secret 和 App ID,回到 Mac mini 终端依次粘贴。提示 client ready 代表连接成功。后续步骤依次选 WebSocket (default)、Feishu - China、Allowlist,群聊白名单直接回车跳过。

回到飞书开放平台,在事件与回调页面把订阅方式改为长连接并保存。注意:如果 OpenClaw 网关未启动或渠道未添加,长连接会保存失败。然后添加事件,搜索接收消息并勾选确认。最后到版本管理与发布页面创建版本、保存、确认发布。

下载飞书客户端登录后,在开发小助手找到机器人,发一条消息会收到授权信息,里面有 Pairing code。复制命令回终端执行:

openclaw pairing approve feishu 你的授权码

授权成功后,在飞书对话测试,机器人能正常响应就说明接入完成。

接下来做公网发布。先装 cpolar:

brew tap probezy/core && brew install cpolar sudo cpolar service install sudo cpolar service start cpolar version

然后访问 http://127.0.0.1:9200 登录 cpolar 后台。假设 OpenClaw 在本地 8080 端口跑了一个页面,在隧道管理里编辑 website 隧道,协议选 http,本地地址填 8080,地区选 China Top,更新后到在线隧道列表就能看到公网地址。验证请求时,在浏览器访问https://你的公网地址/页面路径,能打开就说明穿透成功。如果想让域名固定,到预留页面保留二级子域名,再回隧道编辑里把域名类型改为二级子域名即可。

5. 本篇常见报错排查

配置过程中最容易遇到几类报错,这里逐个对照。

第一类是 401 未授权。表现是 OpenClaw 调用模型时返回 401,或者飞书机器人回复 access not configured。模型侧 401 通常是 API Key 填错或过期,检查~/.openclaw/config.json里的 apiKey 是否和 TaoToken 控制台一致,Base URL 是否为https://taotoken.net/api。飞书侧 401 则是用户未配对,需要执行openclaw pairing approve feishu 授权码。

第二类是 local proxy failed。这通常出现在网关启动阶段,原因是端口被占用或网关未正确安装。可以先openclaw gateway restart,如果还不行,检查 8080 等端口是否被其他进程占用,用lsof -i :8080查看并释放。

第三类是 reading choices 相关报错。这多发生在模型返回格式不符合预期时,比如 Model ID 填错导致接口返回的不是标准 OpenAI 格式。回到 TaoToken 模型对话页面确认模型 ID,重新填入配置。如果用的是自定义 Provider,确认 endpoints 选的是 openai-compatible。

第四类是 OAuth 相关报错。飞书长连接保存失败、提示 OAuth 校验不通过,一般是网关没启动或渠道没添加。先确认 OpenClaw 网关在运行,再回飞书事件配置页面重新保存长连接。

如果你用的是 CC Switch、Cline MCP 或 Codex 这类工具,配置时同样要写全三件套:Base URL 填https://taotoken.net/api,API Key 填 TaoToken 的 Key,Model ID 填确认过的模型标识。Codex 的 auth.json 里对应字段也要一致,否则会出现认证失败。Cline MCP 场景下,Base URL 和 Key 填错会直接导致工具调用超时。

排查顺序建议是:先确认三件套,再确认网关状态,最后确认飞书权限和事件订阅。大部分问题都出在前两步。

6. 长期运行与统一 Key 管理建议

整套链路跑通后,Mac mini 就不再只是桌面上的小电脑,而是 OpenClaw 长期运行的家庭 AI 主机。飞书提供远程入口,cpolar 负责把本地成果发布出去。这里给几个长期运行的建议。

模型调用统一走 TaoToken 的 Key,好处是切换模型时只改 Model ID,不用动 Key 和 Base URL。如果你后面要跑长期编码任务或 Agent 工作流,Coding Plan 入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan ,适合高频场景。日常验证模型是否可用,可以到模型对话页面 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=model 快速试一下。API Key 管理和接入文档分别在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys 和 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc 。

安全方面,切到 full 工具集后 OpenClaw 权限很高,飞书用户授权、API Key、配置文件和公网地址都要妥善保护。不要把机器人开放给不可信人员,也不要让高权限 AI 直接接触未备份的重要文件。cpolar 免费随机域名 24 小时失效,长期服务建议保留二级子域名。

最后一步实操:在飞书里给机器人发一条消息,让它截一张当前屏幕图片并发回来。如果它能正常执行并回传,说明飞书消息触发本地 OpenClaw 执行并回传结果的完整链路已经打通。到这一步,你的 Mac mini 就真正变成了一个随时在线、可以远程调动的私人 AI 助手。

返回列表