1. 为什么要在 macOS 上折腾 OpenClaw 加通义千问先说清楚这套东西到底能干什么。OpenClaw 是一个跑在你 Mac 本地的 AI 代理程序它跟网页版对话工具最大的区别是它能真的动手操作你的电脑。你在飞书里发一句“帮我把下载文件夹里的图片挑出来”它会调用本机命令去执行然后把结果整理成中文回给你。整个过程你人可以在外面手机有网就行。适合谁用三类人最合适。第一类是经常需要远程处理 Mac 上杂事的开发者比如临时要看某个日志、重启某个服务又不想开远程桌面。第二类是想入门 AI Agent 但不想花钱买 API 额度的朋友通义千问的 OAuth 模式有免费额度个人用完全够。第三类是做自动化小工具的同学OpenClaw 的工具链可以直接当执行层用。我试过把这套链路跑通中间踩了几个坑主要集中在 Node 版本、飞书长连接和插件依赖这三块。下面按顺序把每一步都写清楚你照着做基本能复现。核心检索词先记住OpenClaw 部署、通义千问接入、飞书机器人控制 Mac这三个是整条链路的关键节点。整套方案的费用是零。OpenClaw 本身开源免费通义千问走 OAuth 免费额度飞书基础消息 API 免费。你唯一要付出的是一台能联网的 Mac 和一点折腾时间。在开始之前先确认你的机器满足条件Apple Silicon 或 Intel 都行内存 8GB 起步推荐 16GB系统 macOS 14 以上Node.js 必须是 v22 及以上。网络方面飞书和通义千问在国内都能直连不需要额外网络配置。2. 前置准备Node 22 与 OpenClaw 安装避坑这一章是整篇最容易翻车的地方我见过太多人卡在 Node 版本上。OpenClaw 对 Node 的要求是 v22而 macOS 上如果你之前装过 node18 或者更早的版本终端里的 node 命令很可能还指向旧版。即使你 brew install node22 成功了PATH 没改对跑 openclaw 照样报错。先装 Node 22brew install node22 brew link node22 --overwrite --force关键一步是改 shell 配置。很多人忽略这里导致新开的终端还是旧版本。编辑 ~/.zshrc确保 PATH 指向 node22echo export PATH/opt/homebrew/opt/node22/bin:$PATH ~/.zshrc source ~/.zshrc node --version输出应该是 v22.x.x。如果还是旧版本用which node看看指向哪里大概率是 /usr/local/bin/node 或者旧的 homebrew 路径在作怪手动把 PATH 顺序调一下。Node 搞定后装 OpenClawcurl -fsSL https://openclaw.ai/install.sh | bash openclaw --version正常会输出类似 2026.2.9 的版本号。如果卡在下载或者权限报错检查一下 curl 是否能正常访问外网以及当前用户对 /opt/homebrew 有没有写权限。安装完成后OpenClaw 的配置目录在 ~/.openclaw/主配置文件是 ~/.openclaw/openclaw.json。后面所有模型和渠道的配置都写在这里。建议先备份一份原始文件改坏了能回滚。还有一个前置动作容易被漏掉确认你的 Mac 允许终端执行系统命令。macOS 的隐私与安全性里如果之前限制过终端可能导致 OpenClaw 调用 exec 工具时被拦截。到「系统设置 - 隐私与安全性 - 完全磁盘访问权限」里把终端和 OpenClaw 相关进程加进去省得后面执行文件操作时莫名其妙失败。3. 可复制配置通义千问与飞书接入片段这一章给你可以直接抄的配置。先配 AI 大脑再配消息渠道。通义千问的接入推荐用配置向导它会自动帮你写好 OAuth 相关字段openclaw onboard --install-daemon向导里选择模型提供商时选 Qwen然后按提示登录通义千问账号。完成后 ~/.openclaw/openclaw.json 里会生成类似这样的片段{ models: { providers: { qwen-portal: { baseUrl: https://portal.qwen.ai/v1, apiKey: qwen-oauth, api: openai-completions, models: [ { id: coder-model, name: Qwen Coder, contextWindow: 128000, maxTokens: 8192 } ] } } } }注意 apiKey 是 qwen-oauth这表示走 OAuth 免费认证不需要你手动去申请 API Key也不用充值。如果你后面想换成别的模型服务把 baseUrl、apiKey、model id 三件套替换掉就行结构不变。接下来配飞书。先在飞书开放平台创建企业自建应用添加机器人能力然后在权限管理里批量开通以下权限{ scopes: { tenant: [ im:message, im:message.group_at_msg:readonly, im:message.p2p_msg:readonly, im:message:send_as_bot, im:resource ] } }事件订阅那里一定要选「使用长连接接收事件」这是 WebSocket 模式不需要公网 IP 和内网穿透。添加事件 im.message.receive_v1。然后把 App ID 和 App Secret 写进配置文件{ channels: { feishu: { enabled: true, domain: feishu, dmPolicy: pairing, accounts: { main: { appId: cli_xxxxxxxxxxxxx, appSecret: 你的AppSecret, botName: openClaw } } } } }这里的三件套是 Base URL飞书用长连接不需要填但模型那边是 https://portal.qwen.ai/v1、Keyqwen-oauth 或你的 App Secret、Model IDcoder-model。配置类操作最怕字段名写错appId 和 appSecret 大小写要跟飞书后台一致。启动 Gateway 并装成后台服务openclaw gateway openclaw gateway install看到[feishu] feishu[main]: WebSocket client started和ws client ready就说明连上了。4. 验证请求从飞书发消息到 Mac 执行配置写完必须验证不然你不知道哪一环断了。验证分两步先确认模型能通再确认飞书消息能触发执行。第一步本地直接测模型。OpenClaw 一般带一个测试命令或者你可以直接在 Gateway 日志里看模型调用。更直观的方式是打开模型对话页面用同样的通义千问配置发一条消息确认能返回内容。这一步能排除掉模型配置错误。第二步飞书端验证。在手机飞书 App 里找到你创建的机器人发一句简单的我的电脑配置参数是怎样的几秒后应该收到中文回复内容是 Mac 的硬件信息。这背后 OpenClaw 执行了类似 system_profiler 的命令通义千问负责理解意图和整理结果。再测一个带文件操作的帮我在桌面上建一个叫 openclaw-test 的文件夹正常会返回创建成功的提示。你可以回到 Mac 上确认 ~/Desktop/openclaw-test 是否真的存在。这一步验证的是 exec 工具和文件操作链路。如果想看完整执行过程开一个终端窗口盯着 Gateway 日志openclaw gateway status tail -f ~/.openclaw/logs/gateway.log日志里会显示消息接收、模型调用、工具执行、结果回传的完整流程。看到 Tool Call 相关的记录说明通义千问正确决策了要调用哪个工具。验证通过后你可以试试更复杂的组合指令比如“在桌面建个文件夹然后下载一张图片放进去”。OpenClaw 会拆成多步执行先 mkdir再 curl 下载。这个过程能跑通说明整条链路完全打通了。5. 常见报错排查401、长连接失败与依赖问题这一章按真实报错来。我把踩过的坑列出来你对照着查。报错一401 Unauthorized 或模型调用被拒。大概率是通义千问的 OAuth 凭证过期或者配置里 apiKey 写错了。检查 openclaw.json 里 qwen-portal 的 apiKey 是不是 qwen-oauthbaseUrl 是不是 https://portal.qwen.ai/v1。如果用的是手动申请的 Key确认 Key 没有多余空格。重新跑一次 openclaw onboard 可以刷新凭证。报错二飞书事件订阅保存时报「应用未建立长连接」。这是顺序问题。飞书会检查当前有没有活跃的 WebSocket 连接所以你必须先启动 Gateway再回飞书网页点保存。操作顺序是终端跑 openclaw gateway看到 ws client ready 后再去飞书后台保存事件订阅。报错三飞书插件 npm install failed。OpenClaw 某些版本的飞书插件 package.json 里用了 pnpm 的 workspace:* 协议而系统用的是 npm导致依赖装不上。解决方法是进插件目录手动修cd /opt/homebrew/lib/node_modules/openclaw/extensions/feishu # 编辑 package.json把 devDependencies 里的 openclaw: workspace:* 删掉或改成 {} npm install rm -rf ~/.openclaw/extensions/feishu最后那行是删掉用户目录下的重复副本避免加载到旧版本。报错四local proxy failed 或连接超时。检查你的网络是否能正常访问 portal.qwen.ai 和飞书开放平台。如果公司网络有出口限制可能需要换网络环境。另外确认 Gateway 的 bind 配置是 loopback本地回环不会被防火墙拦。报错五电脑重启后机器人没反应。守护进程没装好。跑 openclaw gateway install 装 LaunchAgent然后用 openclaw gateway status 看状态openclaw gateway restart 重启。报错六执行命令时提示权限不足。到 macOS 隐私设置里给终端和 OpenClaw 开完全磁盘访问权限。文件操作类工具对权限比较敏感。排查思路统一是先看 Gateway 日志定位是哪一环断的再针对性检查配置。日志在 ~/.openclaw/logs/ 下tail 着看最直接。6. 长期使用建议与接入文档跑通之后如果你想长期用有几个点值得注意。第一把 Gateway 装成开机自启的守护服务这样 Mac 重启后机器人自动上线不用每次手动开终端。openclaw gateway install 就是干这个的。第二通义千问的免费额度个人日常用足够但如果你要跑高频自动化任务建议关注额度消耗。模型对话页面可以随时测模型可用性接入文档里有完整的配置字段说明改配置前先翻一下。第三安全配置别省。OpenClaw 默认 bind 在 loopback只允许本地访问这个不要改。命令黑名单里默认禁了摄像头、屏幕录制这类敏感操作如果你不需要也别放开。首次聊天需要终端批准配对这个机制能防止陌生人拿到机器人后乱操作你的电脑。第四飞书机器人的权限按最小化原则给。上面那份权限 JSON 只开了消息收发和资源读取够用了。不要图省事开一堆用不上的权限。如果你后面想把这套链路用到编码场景比如让 Agent 帮你跑构建、查日志、改配置可以了解下 Coding Plan 相关的接入方式配合 API Keys 和接入文档能快速把模型能力接到自己的工具链里。模型对话入口适合随时验证模型是否正常排障时先用它确认模型层没问题再去查渠道层。整套链路的核心就三件事Node 版本对、模型配置对、飞书长连接顺序对。这三关过了剩下的就是你想让 Mac 帮你干什么的问题了。