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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。它的价值在于你不用为每个模型单独注册平台、单独管密钥一个 Key 就能在多个模型之间切换对 OpenClaw 这种需要频繁调模型的场景很友好。具体操作上先到 TaoToken 控制台创建一个 API Key。控制台入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsole 。创建好之后复制下来后面填进 OpenClaw 的配置里。如果你还不确定用哪个模型可以先到模型对话页面试一下 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel 确认模型 ID 再填进配置。API Key 管理页面在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keys 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdoc 。这里要强调一个概念OpenClaw 配置模型时需要三件套——Base URL、API Key、Model ID。Base URL 填 TaoToken 的 API 地址API Key 填刚才创建的 KeyModel ID 填你要用的模型标识。这三样缺一不可后面在 OpenClaw 的配置向导里会依次用到。如果你打算长期跑编码类任务或 Agent 工作流可以考虑 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-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 22brew install node22 echo export PATH/opt/homebrew/opt/node22/bin:$PATH ~/.zshrc source ~/.zshrc node -v npm -v git --version看到 v22.x.x 和 git version 2.x.x 就说明环境就绪。Node 版本必须 22 及以上Git 没有硬性要求。这一步踩过的坑是如果 Node 版本低于 22OpenClaw 安装脚本会报错退出所以务必先确认版本。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/?langzh-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 你的授权码授权成功后在飞书对话测试机器人能正常响应就说明接入完成。接下来做公网发布。先装 cpolarbrew 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/apiAPI Key 填 TaoToken 的 KeyModel 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_sourcetaotoken_aicg_blog_endutm_contentcoding-plan 适合高频场景。日常验证模型是否可用可以到模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel 快速试一下。API Key 管理和接入文档分别在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keys 和 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdoc 。安全方面切到 full 工具集后 OpenClaw 权限很高飞书用户授权、API Key、配置文件和公网地址都要妥善保护。不要把机器人开放给不可信人员也不要让高权限 AI 直接接触未备份的重要文件。cpolar 免费随机域名 24 小时失效长期服务建议保留二级子域名。最后一步实操在飞书里给机器人发一条消息让它截一张当前屏幕图片并发回来。如果它能正常执行并回传说明飞书消息触发本地 OpenClaw 执行并回传结果的完整链路已经打通。到这一步你的 Mac mini 就真正变成了一个随时在线、可以远程调动的私人 AI 助手。