1. 为什么要在 MacOS 上把 OpenClaw 接进飞书OpenClaw 是一个开源的 AI Agent 框架你可以把它理解成一个「会自己动手干活」的助手它能挂载大模型、调用工具、跑自动化流程还能通过插件接入飞书、Slack 这类协作平台。接进飞书之后最直接的收益是——群里 一下机器人它就能自动回复、总结消息、生成日报甚至触发脚本任务。对个人开发者和小团队来说这相当于用一台 Mac 当常驻服务器把重复沟通成本压下去。但真到落地这一步坑比想象中多。MacOS 上装 OpenClaw 本身不难难的是三件事第一终端里compdef: command not found、zsh compinit: insecure directories这类补全报错会打断安装节奏第二飞书机器人要配对授权、要配长连接、要开权限少一步消息就石沉大海第三Mac 一关机或重启网关进程就没了机器人直接失联。这篇就按「安装 → 接模型 → 接飞书 → 配对 → 开机自启 → 排错」的顺序把每一步的可复制配置和真实报错对照都写清楚目标是一次跑通并稳定常驻。适合谁看手里有 Mac、想搭一个常驻 AI 助手的开发者已经在用 OpenClaw 但飞书侧收不到消息的人以及被 zsh 补全报错卡住、想彻底解决的人。下面所有命令和配置片段都可以直接抄路径按你自己的用户名替换即可。2. TaoToken 统一 Key 与 API 通道前置准备在配模型之前先把「模型通道」这件事定下来。OpenClaw 支持多种 provider配置写在models节点里格式是 OpenAI 兼容的openai-completions。如果你每个模型都去单独申请 Key、单独记 Base URL后面换模型、加模型会非常乱。我自己的做法是用 TaoToken 做统一入口一个 Key、一个 Base URL模型 ID 按需切换OpenClaw 侧只改id字段就行。TaoToken 在这里扮演的是「统一 API 通道」的角色不是替代 OpenClaw也不是替代编辑器。它的价值在于你不需要为每个模型维护一套凭证配置源文件里baseUrl和apiKey保持一份模型列表里想加哪个加哪个。对 OpenClaw 这种要长期常驻、可能频繁换模型的场景维护成本会低很多。前置准备分三步走。第一步拿到统一 Key进入控制台创建 API Key建议单独建一个给 OpenClaw 用方便后续轮换和排查。第二步确认 Base URL 用https://taotoken.net/api注意这个地址不带任何查询参数直接填在baseUrl字段。第三步想好你要挂哪些模型把对应的 Model ID 记下来比如Qwen3.5-397B-A17B、DeepSeek系列等填到models[].id里。这里有个容易踩的点OpenClaw 的models节点用的是mode: merge意思是「合并」而不是「覆盖」。如果你之前配过别的 provider新加的会并进去不会把旧的冲掉。所以改配置时先看一眼根节点有没有models有就改没有就新建。另外api字段固定写openai-completions这是 OpenClaw 对 OpenAI 兼容接口的标识写错了模型会加载不出来。把 Key 和 Base URL 准备好之后后面的配置就只是「填空」。我建议你先把这两个值写在一个临时文本里因为下面models配置和agents.defaults配置都要用到来回切窗口复制容易出错。准备好就进入下一步。3. 可复制配置models 与 agents.defaults 片段这一节是全文的核心配置写对了后面基本就顺了。OpenClaw 的配置源文件可以在 WebUI 里点「配置」→ 右侧「open」按钮打开也可以直接编辑本地文件。下面给的是完整可复制的 JSON 片段路径和字段名保持和 OpenClaw 一致你只需要替换apiKey和workspace里的用户名。先看models节点。它的结构是modeproviders每个 provider 下有baseUrl、apiKey、api和models数组{ models: { mode: merge, providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken统一Key, api: openai-completions, models: [ { id: Qwen3.5-397B-A17B, name: Qwen3.5-397B-A17B, reasoning: false, input: [text], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 202752, maxTokens: 16384 } ] } } } }几个字段说明一下。baseUrl填https://taotoken.net/api不要带斜杠结尾也不要加多余路径。apiKey填你在控制台创建的那把 Key。api固定openai-completions。models数组里每个对象就是一个可选模型id是调用时用的标识name是显示名contextWindow和maxTokens按模型实际能力填填小了会截断长对话填大了可能报错建议查一下模型文档。再看agents.defaults它决定默认用哪个模型、工作空间在哪{ agents: { defaults: { model: { primary: taotoken/Qwen3.5-397B-A17B }, models: { taotoken/Qwen3.5-397B-A17B: {} }, workspace: /Users/你的用户名/.openclaw/workspace } } }注意primary的写法是provider名/模型id也就是taotoken/Qwen3.5-397B-A17B中间用斜杠连接和上面providers里的 key 对应。workspace换成你自己的登录用户名路径不存在的话 OpenClaw 启动时会自己建。改完保存回到 WebUI 点「Update」让配置生效然后重启一次网关。如果你后面要加第二个模型只需要在models数组里再追加一个对象然后在agents.defaults.models里加上对应的provider/id键即可primary不动就还是用默认那个。这种「一份 Key 多模型 ID」的结构就是统一通道最省心的地方。4. 飞书机器人接入与配对授权验证模型通了之后接飞书。先去飞书开放平台创建「企业自建应用」填应用名称和描述创建完进入「凭证与基础信息」把 App ID 和 App Secret 记下来。接着开权限左侧「开发配置」→「权限管理」应用身份权限里搜im:message全部勾选开通用户身份权限里搜contact:user.base:readonly勾选开通。然后配事件订阅订阅方式选「长连接」添加接收消息事件im.message.receive_v1。最后去「应用发布」→「版本管理与发布」创建版本并申请发布。飞书侧配好回到终端装插件并写参数openclaw plugins install m1heng-clawd/feishu openclaw config set channels.feishu.appId 你的App ID openclaw config set channels.feishu.appSecret 你的App Secret openclaw config set channels.feishu.enabled true openclaw config set channels.feishu.connectionMode websocket openclaw config set channels.feishu.dmPolicy pairing openclaw config set channels.feishu.groupPolicy allowlist openclaw config set channels.feishu.requireMention true openclaw gateway restart这里connectionMode用websocket飞书推荐长连接模式不需要公网回调地址Mac 在内网也能跑。dmPolicy设pairing表示单聊要配对授权groupPolicy设allowlist表示群聊走白名单requireMention设true表示群里必须 机器人才响应避免刷屏。配对授权是很多人卡住的地方。配置完重启网关后在飞书里给机器人发任意一条消息机器人会回一条带配对码的消息。拿到配对码后执行openclaw pairing approve feishu 你的配对码 openclaw gateway restart重启完再发一条消息能正常回复就说明通了。实测下来第一次回复可能偏慢多等几秒别急着判定失败。如果一直不回先看网关日志有没有收到事件再对照下一节的报错表排查。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节按真实报错来对照遇到问题直接查表。401 Unauthorized最常见。先确认apiKey有没有复制完整、有没有多余空格再确认baseUrl是https://taotoken.net/api不要写成别的路径最后确认 Key 本身没过期或被禁用。改完配置记得点 Update 并重启网关配置不生效也会一直 401。local proxy failed / connection refused通常是网关没起来或者端口被占。先openclaw gateway restart再看进程在不在。如果是开机自启后失联多半是 LaunchAgent 里的可执行文件路径不对/usr/local/bin/openclaw在 Apple Silicon 上可能是/opt/homebrew/bin/openclaw用which openclaw确认真实路径再改 plist。reading choices / cannot read property choices这是模型返回结构不符合预期一般是api字段没写openai-completions或者baseUrl指向了非 OpenAI 兼容接口。检查 provider 配置确认api和baseUrl匹配。OAuth 相关报错如果你用的是需要 OAuth 的 provider凭证过期会报这个。统一走 API Key 通道可以绕开这类问题把 provider 换成taotokenopenai-completions即可。compdef: command not found / zsh compinit: insecure directories这是 zsh 补全系统没启用或目录权限不安全导致的和 OpenClaw 本身无关但会打断安装。解决方式brew install zsh-completions nano ~/.zshrc在.zshrc最顶部加autoload -Uz compinit compinit -i -u if type brew /dev/null; then fpath($(brew --prefix)/share/zsh-completions $fpath) fi然后修权限并清缓存sudo chmod -R go-w $(brew --prefix)/share/zsh-completions sudo chown -R $(whoami) $(brew --prefix)/share/zsh-completions sudo chmod -R go-w /usr/share/zsh sudo chown -R root:wheel /usr/share/zsh rm -f ~/.zcompdump* source ~/.zshrc重开终端openclaw加 TAB 能补全就说明好了。如果不需要补全也可以直接export OPENCLAW_COMPLETIONS_DISABLE1禁用。开机自启配置推荐用官方守护进程openclaw onboard --install-daemon重启自动拉起。备用方案是手写 LaunchAgentplist 里ProgramArguments填真实路径RunAtLoad和KeepAlive都设true然后launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.openclaw.gateway.plist加载用launchctl list | grep openclaw验证。6. 把通道固定下来让机器人稳定常驻跑通之后真正决定体验的是「稳定性」。我的做法是把模型通道固定成一份配置Base URL 用https://taotoken.net/apiKey 用统一的那把模型 ID 按需在models数组里增减。这样无论你后面换 Qwen 还是 DeepSeekOpenClaw 侧只动id和primary不用重新折腾凭证。如果你还在选模型阶段可以先去模型对话页面把几个候选模型都试一遍确认回复质量和速度再写进配置。长期跑编码类或 Agent 类任务的话Coding Plan 会更合适额度和调用方式都更贴合常驻场景。Key 的管理和轮换在 API Keys 页面操作接入细节和字段说明看接入文档遇到配置问题对照文档比盲改快得多。最后留一个实用习惯每次改完配置先openclaw gateway restart再在飞书发一条测试消息确认回复正常再关终端。开机自启配好后Mac 重启也不用管机器人会自己回来。把这几步固化成流程后面加模型、加渠道都只是填空而已。