1. 先搞清楚 OpenClaw 到底是个什么东西OpenClaw 是一个可以跑在你本机的 AI 智能体运行框架它能连接聊天软件比如飞书、Telegram或者本地客户端把大模型的对话能力、工具调用能力串起来做成一个随时能喊的“私人助理”。你可以把它理解成一个“本地大脑外壳”模型本身在云端但调度、记忆、技能、消息通道都跑在你自己的电脑上。适合谁适合想在自己电脑上折腾 AI Agent、又不想把数据全交给第三方平台的新手和进阶玩家。但新手第一次装 OpenClaw最容易卡在三个地方Node.js 版本不对、Git 没装导致拉代码失败、以及模型 API 通道配不明白。尤其是第三点OpenClaw 默认的模型服务商对国内用户不太友好Key 申请麻烦、计费也不透明。这篇就按 Windows 和 Mac 两条线从 Node.js 环境检查开始一路配到用 TaoToken 统一 Key 完成首次对话目标是一次跑通。我试过在 Windows 11 和 macOS Sonoma 上各装一遍踩过的坑基本都写在后面的排查章节里了。你跟着命令一条条敲大概率不用返工。2. 装 OpenClaw 之前先把 Node.js 和 Git 检查干净OpenClaw 对运行环境有硬性要求Node.js 22.0 或以上Git 任意较新版本。这两个没装好后面npm install一定报错。2.1 Windows 环境检查开始菜单搜Windows PowerShell右键“以管理员身份运行”。先查版本node -v git --version如果node -v输出v22.x.x或更高就合格。如果提示“不是内部或外部命令”说明没装或没进 PATH。去 Node.js 官网下载 LTS 版安装包安装时勾选“Add to PATH”。Git 去 git-scm.com 下载一路默认即可。装完关掉 PowerShell 重开一次再查一遍版本。这一步别偷懒PATH 不刷新是新手最常见的“装了却找不到”的原因。2.2 Mac 环境检查打开“终端”同样两条命令node -v git --versionMac 上如果没装 Git终端会提示你安装 Xcode Command Line Tools点“安装”等它跑完就行。Node.js 建议用 Homebrew 装brew install node22装完node -v确认版本。如果你之前用 nvm 管理过 Node记得nvm use 22切到 22 以上否则 OpenClaw 启动时会直接报引擎版本不匹配。2.3 全局安装 OpenClaw两个平台命令一样国内网络建议带上镜像源npm install -g openclawlatest --registryhttps://registry.npmmirror.com装完验证openclaw -v能打印出版本号就说明二进制已经就位。如果这一步卡住不动多半是 npm 源的问题换镜像源重试即可。3. 用 TaoToken 统一 Key 打通模型通道OpenClaw 本身不带模型它需要一个“模型服务商”来提供对话能力。默认引导流程里那些服务商国内申请和计费都比较绕。更省事的做法是走 TaoToken 的统一 API 通道一个 Key 就能调用多种主流模型Base URL 和 OpenAI 兼容格式一致OpenClaw 配置起来非常直接。3.1 拿到 TaoToken 的 Key 和接口地址先去官网注册账号https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content登录后进控制台创建 API Key入口在这里https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content创建完复制保存好Key 只显示一次。接口地址统一用https://taotoken.net/api注意这个地址末尾不带/v1OpenClaw 的 provider 配置里会自己拼路径你照抄就行。想先确认模型能不能用可以去模型对话页试一句https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content3.2 初始化 OpenClaw在终端执行openclaw onboard跟着提示走几个关键选择安全警告选 Yes这是正常的权限提示模式选“快速开始”重置配置选“重置”范围选“全部重置”模型服务选择这一步选“跳过”因为我们要手动写 TaoToken 的配置API Key 配置直接回车跳过后面的 Channel 选择可以先跳过或按需选飞书技能安装选 NOHooks 三个选项都勾上空格确认再回车最后点重启。初始化完成后配置文件就生成了。Windows 路径在C:\Users\你的用户名\.openclaw\Mac 在~/.openclaw/。3.3 写入 settings.json / config.toml 骨架OpenClaw 的模型配置写在openclaw.json部分版本读config.toml。打开文件把models.providers这一段合并进去注意替换成你自己的 Key{ models: { providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: 你的_TAOTOKEN_API_KEY, api: openai-completions, models: [ { id: claude-sonnet-4-5, name: Claude Sonnet 4.5, reasoning: false, input: [text], contextWindow: 200000, maxTokens: 8192 } ] } } } }如果你用的是 TOML 版本等价写法是[models.providers.taotoken] baseUrl https://taotoken.net/api apiKey 你的_TAOTOKEN_API_KEY api openai-completions [[models.providers.taotoken.models]] id claude-sonnet-4-5 name Claude Sonnet 4.5 contextWindow 200000 maxTokens 8192模型 id 按你在 TaoToken 模型列表里看到的实际名称填别照抄示例里的名字。填错 id 是后面“模型列表为空”的头号原因。3.4 把模型挂到 agent 上光配 provider 还不够得让 agent 知道用哪个模型。在openclaw.json的agents配置项里加上model: taotoken/claude-sonnet-4-5, fallbacks: [taotoken/claude-sonnet-4-5]taotoken/前缀加模型 id必须和上面 provider 里配的完全一致。建议先放进fallbacks这样即使主模型写错也不会直接崩掉。4. 验证请求确认模型真的通了配置写完先别急着开聊天窗口用命令行验证最直接。4.1 查看模型列表openclaw models list正常输出里应该能看到你刚配的taotoken/claude-sonnet-4-5。如果列表是空的说明 provider 段没被正确解析回去检查 JSON 括号有没有多一个少一个。4.2 发起首次对话在终端直接跑一句openclaw run 用一句话介绍你自己如果返回了模型生成的文本恭喜通道打通了。返回 401 就是 Key 错了返回 404 多半是 baseUrl 或模型 id 写错返回超时检查网络。4.3 在客户端里切换模型如果你用 Cherry Studio 这类客户端在设置里选“自定义 OpenAI 兼容服务”Base URL 填https://taotoken.net/apiKey 填 TaoToken 的 Key模型名填claude-sonnet-4-5。保存后新建对话能正常回复就说明客户端侧也通了。在 Web 端或聊天软件里临时切换模型输入/model taotoken/claude-sonnet-4-55. 本篇常见错排查报错npm ERR! engine Unsupported engineNode 版本低于 22。用node -v确认低了就升级nvm 用户记得nvm use 22。openclaw: command not found全局安装没成功或 PATH 没刷新。重开终端或检查 npm 全局 bin 目录是否在 PATH 里。models list为空openclaw.json格式错误。用 JSON 校验工具过一遍重点看逗号和括号。TOML 版本注意表头缩进。401 UnauthorizedKey 复制时带了空格或者 Key 已失效。重新去控制台生成一个。404 Not FoundbaseUrl 多写了/v1或者模型 id 拼错。TaoToken 的地址就是https://taotoken.net/api别自己加后缀。对话一直转圈检查本机网络能否访问taotoken.net以及防火墙有没有拦 Node 进程。飞书通道收不到消息App ID / App Secret 填错或开放平台没开对应权限。先跳过通道用命令行验证模型通了再回来配。6. 接下来怎么走模型通道跑通之后你可以按需往下走想长期挂机跑编码任务或 Agent 自动化建议上 Coding Plan额度更划算入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content需要管理多个 Key、看用量明细去控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content想新建或轮换 API Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入细节和参数说明看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content如果你用的是 Claude Code 这类 Anthropic 协议工具参考这个接入页https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后提醒一句OpenClaw 运行时的操作权限确实很大建议在隔离环境或专用机器上跑别在存着重要资料的主力机上直接开全权限。配置文件改之前先备份一份改坏了能秒回滚。