1. OpenClaw 是什么Mac 上装它到底图什么OpenClaw 是一个能直接操作你电脑的 AI Agent不是那种只会聊天的助手。你给它一句话它可以自己打开软件、读写文件、跑脚本、整理数据甚至帮你把结果发出去。因为 Claw 在英文里是“爪子、龙虾钳”的意思社区里干脆叫它“龙虾”。它最早叫 Clawbot后来改名 Moltbot现在统一叫 OpenClaw由奥地利开发者 Peter Steinberger 开源短时间内就在 GitHub 上冲到了很靠前的位置。它适合谁适合手里有 Mac、想让 AI 真正替自己动手干活的人。比如你每天要重复整理表格、批量改文件名、定时抓数据、自动填表单这些 OpenClaw 都能接。它和聊天式 AI 最大的区别是聊天 AI 给你答案OpenClaw 给你结果。代价是它需要系统权限所以本地跑要谨慎很多人更愿意放到云主机上跑。这篇聚焦 Mac 本地从零到跑通的完整链路Homebrew、Git、Node.js 依赖准备再到 OpenClaw 安装、接入 TaoToken 统一 Key/API 通道最后给出可复制的config.toml骨架和settings.json片段以及验证它能否正常调用模型的命令。全程照着敲就行不需要你提前懂 Node.js。2. 装 OpenClaw 前先把 TaoToken 这条通道准备好OpenClaw 本身只是“身体”它的大脑要接大模型。你可以直接填各家厂商的 Key但那样每换一个模型就要改一次配置Agent 跑长任务时切换很麻烦。更省事的做法是走 TaoToken 的统一通道一个 Key 对应多个模型OpenClaw 里只配一次后面换模型只改模型名。TaoToken 的定位就是给 AI Agent、编码工具、脚本调用提供统一的 API 入口。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。注意 API 地址后面不加任何参数配置里填的就是这个纯基址。你需要提前做两件事。第一注册后进控制台拿到 API Key入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 的管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。第二想先确认模型通不通可以用模型对话页试一句地址是 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。如果你后面要长期跑编码类 Agent 任务可以了解 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。注意Key 只存在你本机配置文件里不要提交到 Git也不要贴到聊天窗口。OpenClaw 会读本地配置泄露等于别人能拿你的额度。3. Mac 依赖准备Homebrew、Git、Node.js 一条条来3.1 安装 Homebrew打开终端Launchpad 搜“终端”或 Spotlight 输入 Terminal。Homebrew 是 Mac 的包管理工具后面装 Git 和 Node.js 都靠它。官方脚本在国内网络下经常卡住建议用国内源脚本/bin/zsh -c $(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)执行后会让你选下载方式选 1 即可中途要输入开机密码问是否删除旧 Brew 选 Y。装完它会问镜像源选阿里云那一项。完成后重启终端验证brew --version能打印出版本号形如Homebrew 4.x.x就说明成功。如果提示command not found多半是环境变量没生效重开终端或执行source ~/.zprofile再试。3.2 安装 Gitbrew install git git --version第二条命令返回版本号即可。Git 在这里的作用是让 OpenClaw 拉取依赖时走 HTTPS避免 SSH 配置报错。3.3 安装 Node.jsOpenClaw 基于 Node.js 开发必须装。推荐用 Homebrew 装版本可控brew install node node -v npm -vnode -v建议在 18 以上npm -v能返回版本即可。如果你更习惯图形安装也可以去 Node.js 官网下 macOS 的.pkg双击安装效果一样。3.4 切换 npm 源并修正 Git 协议国内直连 npm 官方源很慢先切镜像npm config set registry https://registry.npmmirror.com/再把 GitHub 的 git 协议强制走 HTTPS避免拉依赖时卡在 SSHgit config --global url.https://github.com/.insteadOf gitgithub.com: git config --global url.https://github.com/.insteadOf ssh://gitgithub.com: git config --global url.https://.insteadOf git://然后清一下缓存sudo npm cache clean -f4. 安装 OpenClaw 并写入 TaoToken 配置4.1 全局安装sudo npm install -g openclawlatest --registryhttps://registry.npmmirror.com --unsafe-permtrue --force看到added N packages之类的输出就是装好了。验证openclaw --version能打印版本号说明命令已进 PATH。如果报command not found检查 npm 全局 bin 目录是否在 PATH 里执行npm config get prefix看路径再把它加进~/.zshrc。4.2 跑一次初始化向导openclaw onboard第一次会弹安全警告输入y继续。Onboarding mode 选 QuickStartConfig handling 选 Use existing values到 Model/auth provider 这一步先随便选一个占位因为我们马上要用手写配置覆盖它把通道指向 TaoToken。4.3 config.toml 骨架OpenClaw 的主配置一般在~/.openclaw/config.toml不同版本路径可能略有差异用openclaw config path可以确认。下面这份骨架把 provider 指向 TaoToken 的统一入口你只需要替换api_key# ~/.openclaw/config.toml [gateway] host 127.0.0.1 port 18789 [provider.taotoken] type openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 default_model claude-sonnet-4-5 [agent] name lobster provider taotoken workspace ~/openclaw-workspace几个关键点type用openai-compatible因为 TaoToken 暴露的是兼容 OpenAI 协议的接口base_url填https://taotoken.net/api不要加斜杠后缀default_model换成你在模型对话页确认可用的模型名。4.4 settings.json 片段部分版本或插件会读settings.json放在同目录下。给一份最小片段{ provider: taotoken, providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, models: [claude-sonnet-4-5, gpt-4o-mini] } }, gateway: { host: 127.0.0.1, port: 18789 } }models数组里放你常用的几个OpenClaw 切模型时就从这里挑。两份配置的 Key 保持一致避免出现“config 通了、settings 没通”的假故障。5. 验证 OpenClaw 能否正常调用统一 Key配置写完别急着上任务先做三步验证。第一步检查配置能否被解析openclaw config validate返回OK或类似成功提示说明 TOML/JSON 语法没问题。报错会直接指出行号照着改。第二步直接发一条最小请求确认通道通openclaw run 用一句话说明你现在能做什么如果模型正常返回内容说明 TaoToken 的 Key、base_url、模型名三者都对上了。这一步失败九成是 Key 写错或模型名不存在。第三步起网关和面板看状态openclaw gateway另开一个终端openclaw dashboard它会自动打开浏览器地址形如http://127.0.0.1:18789/#tokenxxx。在面板里能看到当前 provider、模型、最近请求记录。如果面板里请求状态是 200但内容为空多半是模型名写成了不存在的别名。想更直接地测通道本身可以绕过 OpenClaw 用 curl 打一发curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d {model:claude-sonnet-4-5,messages:[{role:user,content:ping}]}返回带choices的 JSON 就说明通道没问题此时若 OpenClaw 还报错问题一定在 OpenClaw 配置侧而不是 Key 侧。这个二分法能帮你省很多排查时间。6. 本篇常见报错排查报错一openclaw: command not found。安装成功但 PATH 没生效。执行npm config get prefix拿到全局路径把它加进~/.zshrc的export PATH...:$PATH然后source ~/.zshrc。报错二401 Unauthorized。Key 错了或带了多余空格。检查config.toml和settings.json里的api_key确认没有引号嵌套错误也没有把 Key 复制成带换行的形式。报错三404 model not found。模型名写错。去模型对话页确认可用模型名注意大小写和连字符别自己拼。报错四ECONNREFUSED 127.0.0.1:18789。网关没起。先跑openclaw gateway再开 dashboard。端口被占用就改config.toml里的port。报错五npm 安装卡在idealTree。源没切成功。重新执行npm config set registry https://registry.npmmirror.com/再npm cache clean -f后重装。报错六拉依赖时 SSH 报错。Git 协议没改。把第 3.4 节那三条git config命令重新执行一遍。报错七面板能开但请求一直 pending。多半是 base_url 写成了带/v1的完整路径。TaoToken 这里填https://taotoken.net/api即可路径由客户端补全。排查顺序建议固定成先 curl 测通道 → 再openclaw config validate→ 再openclaw run单句 → 最后看 dashboard。按这个顺序走基本不会绕圈。如果你在接入环节卡住优先去看接入文档和 Key 管理页文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite Key 在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。想先确认某个模型能不能用直接去模型对话页发一句最快https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。长期让龙虾跑编码和自动化任务的话Coding Plan 会更划算入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。Claude Code 相关接入可以看 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。最后提醒一句本地跑 OpenClaw 等于把电脑操作权交给它第一次别直接让它碰重要目录先在~/openclaw-workspace这种隔离目录里试任务确认行为符合预期再逐步放开权限。