1. 先搞清楚 OpenClaw 是什么以及这篇能帮你跑通什么OpenClaw 是一个面向开发者的命令行 AI 编程助手你可以把它理解成「跑在终端里的结对程序员」它能读你当前项目的文件、按你的指令改代码、执行命令、解释报错。适合谁适合已经在用 VS Code、习惯命令行、想让 AI 直接动项目文件而不是只在网页里聊天的开发者。它和网页版对话最大的区别是OpenClaw 有本地文件读写权限能真正把「帮我改这个函数」落到磁盘上。但第一次装 OpenClaw 的人八成会卡在三个地方Node.js 版本不够、npm 装包卡住、以及装完之后不知道怎么把模型通道接进去。这篇就按「装环境 → 装 OpenClaw → 配 TaoToken 通道 → 验证调用」的顺序走一遍Windows 和 macOS 都给命令。目标很明确一次跑通并且确认 API 调用真的通了而不是装完一个空壳。我试过在一台干净的 Windows 备用机上从零走这套流程全程大概 15 分钟其中 npm 下载依赖占了大头。下面每一步都给可复制的命令和预期输出你照着敲就行。2. 装 OpenClaw 之前先把 Node.js 22 和 TaoToken 通道准备好2.1 环境要求先对一遍OpenClaw 对运行环境有几个硬性要求先确认再动手能省掉后面一半的报错项目要求说明操作系统Windows / macOS / Linux本篇覆盖 Win 和 macOSNode.js 22低于 22 会在装依赖时报语法错误内存建议 4GB 以上编译原生模块时吃内存磁盘至少 500MB依赖包体积不小网络能访问 npm 源用国内镜像更稳注意如果你主电脑上已经有一堆全局 npm 包和自定义配置建议开一个独立用户账户来装或者干脆用备用机。OpenClaw 会装全局命令和现有环境混在一起排查起来很烦。2.2 为什么先配 TaoTokenOpenClaw 本身只是个「壳」它需要接一个大模型通道才能真正干活。TaoToken 提供统一的 Key 和 API 通道你申请一个 Key就能在 OpenClaw 里通过一份配置把模型调用接上不用在多个平台之间来回切。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。先把 Key 拿到手后面配置文件里直接填省得装完再回头找。Key 在控制台的 API Keys 页面创建https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。创建后复制那串 sk- 开头的字符串只显示一次记得存好。3. 可复制配置从装 Node 到写 settings.json 和 config.toml3.1 Windows用 winget 装 Node.js 22打开管理员权限的 PowerShellWin X 选「终端(管理员)」先看当前版本node -v如果显示低于 v22.0.0 或者提示「命令未找到」就装winget install OpenJS.NodeJS.22装完关掉当前窗口重新开一个 PowerShell再验证node -v npm -v预期输出是v22.x.x和对应的 npm 版本号。这一步没出 v22 就别往下走后面必炸。3.2 macOS用 nvm 装 Node.js 22macOS 上更推荐 nvm方便以后切版本touch ~/.zshrc curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.zshrc nvm --version nvm install 22 nvm use 22 node -vnvm --version能打印出版本号说明 nvm 装好了node -v显示 v22.x.x 就对了。3.3 配 npm 镜像源装包不再卡国内直连 npm 官方源经常超时换成华为云镜像npm config set registry https://mirrors.huaweicloud.com/repository/npm/ npm config get registry第二条命令应该回显https://mirrors.huaweicloud.com/repository/npm/。如果公司网络有内网源换成你们自己的地址也行。3.4 安装 OpenClaw 本体环境就绪后一条命令装npm install -g openclaw过程会先下 OpenClaw 包再拉依赖最后编译原生模块。正常 2–5 分钟网络慢可能 5–10 分钟。装完验证openclaw --version能打印出版本号说明命令已经进 PATH 了。如果提示「不是内部或外部命令」多半是 npm 全局目录没进 PATH用npm config get prefix看路径手动加进环境变量。3.5 写 settings.json 骨架OpenClaw 的用户级配置放在用户目录下的.openclaw/settings.json。Windows 是C:\Users\你的用户名\.openclaw\settings.jsonmacOS 是~/.openclaw/settings.json。没有这个目录就手动建mkdir -p ~/.openclaw然后写入下面这份骨架把sk-你的Key换成你在控制台创建的那串{ provider: taotoken, apiKey: sk-你的Key, baseUrl: https://taotoken.net/api, model: claude-sonnet-4-5, maxTokens: 8192, temperature: 0.2 }几个字段说明baseUrl固定填 TaoToken 的 API 地址不要带结尾斜杠model填你要用的模型名具体可用模型在模型对话页能看到https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content temperature写代码建议 0.2 左右别太高。3.6 写 config.toml 骨架有些 OpenClaw 版本或插件走 TOML 配置放在项目根目录的.openclaw/config.toml用于覆盖项目级设置[provider] name taotoken base_url https://taotoken.net/api api_key sk-你的Key [model] default claude-sonnet-4-5 max_tokens 8192 temperature 0.2 [behavior] auto_context true max_file_size 1048576auto_context true让 OpenClaw 自动把当前目录相关文件带进上下文max_file_size限制单文件读取上限避免它去啃几 MB 的日志文件。项目级配置优先级高于用户级团队协作时把这份提交到仓库Key 用环境变量注入别硬编码。4. 验证请求确认 API 调用真的通了配置写完不算完得实际发一次请求。OpenClaw 一般带一个自检或对话命令先跑openclaw doctor这个命令会检查 Node 版本、配置文件是否存在、Key 是否可读、以及能不能连上baseUrl。如果输出里 provider 和 model 都识别到了说明配置被正确加载。接着发一条最小请求openclaw chat 用一句话说明这个项目是做什么的预期是终端里流式打印出模型回复。如果卡住不动多半是网络或 Key 问题看下一节排查。想单独验证 TaoToken 通道本身通不通可以直接用 curl 打一次curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d {model:claude-sonnet-4-5,messages:[{role:user,content:ping}]}返回 JSON 里带choices字段就说明 Key 和通道都没问题问题只可能在 OpenClaw 的配置读取上。这一步能把「网络问题」和「配置问题」彻底分开排障时特别有用。5. 本篇常见错排查报错一node: command not found或版本低于 22。装完 Node 一定要重开终端PATH 才会刷新。Windows 上如果 winget 装完还是旧版本检查是不是有多个 Node 安装路径用where node看实际调用的是哪个。报错二npm install -g openclaw卡在idealTree或超时。九成是源的问题确认npm config get registry是华为云镜像。如果公司网络限制严格检查是否需要走内部源。报错三openclaw --version提示命令不存在。全局包装了但 PATH 没配。跑npm config get prefix把那个路径加进系统环境变量重开终端。报错四openclaw doctor显示 provider 未识别。检查settings.json的 JSON 格式多一个逗号都会解析失败。用cat ~/.openclaw/settings.json看内容或者拿 JSON 校验工具过一遍。报错五chat 命令卡住无输出。先用上面那条 curl 单独测通道。curl 通、OpenClaw 不通就是配置文件路径不对——确认文件在~/.openclaw/下而不是项目目录里用户级和项目级别搞混。报错六返回 401。Key 复制时带了空格或者创建后没保存。回控制台重新生成一个https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。报错七模型名报 not found。model字段填的名字和平台实际提供的对不上。去模型对话页确认可用模型名别凭记忆写。6. 装完之后把通道用顺到这一步OpenClaw 应该已经能在终端里正常对话和改代码了。如果你打算长期用它做项目开发、跑 Agent 任务建议把调用方式从按次切到 Coding Plan额度更划算适合高频编码场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入细节和参数说明都在文档里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后留一个我踩过的坑settings.json里的baseUrl千万别手滑写成https://taotoken.net/api/带结尾斜杠有些 HTTP 客户端会把路径拼成//v1/...服务端直接 404排查半天以为是 Key 的问题。配置改完记得重开终端再测别在旧会话里反复试。
OpenClaw（一）：安装教程与 TaoToken 配置骨架
1. 先搞清楚 OpenClaw 是什么以及这篇能帮你跑通什么OpenClaw 是一个面向开发者的命令行 AI 编程助手你可以把它理解成「跑在终端里的结对程序员」它能读你当前项目的文件、按你的指令改代码、执行命令、解释报错。适合谁适合已经在用 VS Code、习惯命令行、想让 AI 直接动项目文件而不是只在网页里聊天的开发者。它和网页版对话最大的区别是OpenClaw 有本地文件读写权限能真正把「帮我改这个函数」落到磁盘上。但第一次装 OpenClaw 的人八成会卡在三个地方Node.js 版本不够、npm 装包卡住、以及装完之后不知道怎么把模型通道接进去。这篇就按「装环境 → 装 OpenClaw → 配 TaoToken 通道 → 验证调用」的顺序走一遍Windows 和 macOS 都给命令。目标很明确一次跑通并且确认 API 调用真的通了而不是装完一个空壳。我试过在一台干净的 Windows 备用机上从零走这套流程全程大概 15 分钟其中 npm 下载依赖占了大头。下面每一步都给可复制的命令和预期输出你照着敲就行。2. 装 OpenClaw 之前先把 Node.js 22 和 TaoToken 通道准备好2.1 环境要求先对一遍OpenClaw 对运行环境有几个硬性要求先确认再动手能省掉后面一半的报错项目要求说明操作系统Windows / macOS / Linux本篇覆盖 Win 和 macOSNode.js 22低于 22 会在装依赖时报语法错误内存建议 4GB 以上编译原生模块时吃内存磁盘至少 500MB依赖包体积不小网络能访问 npm 源用国内镜像更稳注意如果你主电脑上已经有一堆全局 npm 包和自定义配置建议开一个独立用户账户来装或者干脆用备用机。OpenClaw 会装全局命令和现有环境混在一起排查起来很烦。2.2 为什么先配 TaoTokenOpenClaw 本身只是个「壳」它需要接一个大模型通道才能真正干活。TaoToken 提供统一的 Key 和 API 通道你申请一个 Key就能在 OpenClaw 里通过一份配置把模型调用接上不用在多个平台之间来回切。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。先把 Key 拿到手后面配置文件里直接填省得装完再回头找。Key 在控制台的 API Keys 页面创建https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。创建后复制那串 sk- 开头的字符串只显示一次记得存好。3. 可复制配置从装 Node 到写 settings.json 和 config.toml3.1 Windows用 winget 装 Node.js 22打开管理员权限的 PowerShellWin X 选「终端(管理员)」先看当前版本node -v如果显示低于 v22.0.0 或者提示「命令未找到」就装winget install OpenJS.NodeJS.22装完关掉当前窗口重新开一个 PowerShell再验证node -v npm -v预期输出是v22.x.x和对应的 npm 版本号。这一步没出 v22 就别往下走后面必炸。3.2 macOS用 nvm 装 Node.js 22macOS 上更推荐 nvm方便以后切版本touch ~/.zshrc curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.zshrc nvm --version nvm install 22 nvm use 22 node -vnvm --version能打印出版本号说明 nvm 装好了node -v显示 v22.x.x 就对了。3.3 配 npm 镜像源装包不再卡国内直连 npm 官方源经常超时换成华为云镜像npm config set registry https://mirrors.huaweicloud.com/repository/npm/ npm config get registry第二条命令应该回显https://mirrors.huaweicloud.com/repository/npm/。如果公司网络有内网源换成你们自己的地址也行。3.4 安装 OpenClaw 本体环境就绪后一条命令装npm install -g openclaw过程会先下 OpenClaw 包再拉依赖最后编译原生模块。正常 2–5 分钟网络慢可能 5–10 分钟。装完验证openclaw --version能打印出版本号说明命令已经进 PATH 了。如果提示「不是内部或外部命令」多半是 npm 全局目录没进 PATH用npm config get prefix看路径手动加进环境变量。3.5 写 settings.json 骨架OpenClaw 的用户级配置放在用户目录下的.openclaw/settings.json。Windows 是C:\Users\你的用户名\.openclaw\settings.jsonmacOS 是~/.openclaw/settings.json。没有这个目录就手动建mkdir -p ~/.openclaw然后写入下面这份骨架把sk-你的Key换成你在控制台创建的那串{ provider: taotoken, apiKey: sk-你的Key, baseUrl: https://taotoken.net/api, model: claude-sonnet-4-5, maxTokens: 8192, temperature: 0.2 }几个字段说明baseUrl固定填 TaoToken 的 API 地址不要带结尾斜杠model填你要用的模型名具体可用模型在模型对话页能看到https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content temperature写代码建议 0.2 左右别太高。3.6 写 config.toml 骨架有些 OpenClaw 版本或插件走 TOML 配置放在项目根目录的.openclaw/config.toml用于覆盖项目级设置[provider] name taotoken base_url https://taotoken.net/api api_key sk-你的Key [model] default claude-sonnet-4-5 max_tokens 8192 temperature 0.2 [behavior] auto_context true max_file_size 1048576auto_context true让 OpenClaw 自动把当前目录相关文件带进上下文max_file_size限制单文件读取上限避免它去啃几 MB 的日志文件。项目级配置优先级高于用户级团队协作时把这份提交到仓库Key 用环境变量注入别硬编码。4. 验证请求确认 API 调用真的通了配置写完不算完得实际发一次请求。OpenClaw 一般带一个自检或对话命令先跑openclaw doctor这个命令会检查 Node 版本、配置文件是否存在、Key 是否可读、以及能不能连上baseUrl。如果输出里 provider 和 model 都识别到了说明配置被正确加载。接着发一条最小请求openclaw chat 用一句话说明这个项目是做什么的预期是终端里流式打印出模型回复。如果卡住不动多半是网络或 Key 问题看下一节排查。想单独验证 TaoToken 通道本身通不通可以直接用 curl 打一次curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d {model:claude-sonnet-4-5,messages:[{role:user,content:ping}]}返回 JSON 里带choices字段就说明 Key 和通道都没问题问题只可能在 OpenClaw 的配置读取上。这一步能把「网络问题」和「配置问题」彻底分开排障时特别有用。5. 本篇常见错排查报错一node: command not found或版本低于 22。装完 Node 一定要重开终端PATH 才会刷新。Windows 上如果 winget 装完还是旧版本检查是不是有多个 Node 安装路径用where node看实际调用的是哪个。报错二npm install -g openclaw卡在idealTree或超时。九成是源的问题确认npm config get registry是华为云镜像。如果公司网络限制严格检查是否需要走内部源。报错三openclaw --version提示命令不存在。全局包装了但 PATH 没配。跑npm config get prefix把那个路径加进系统环境变量重开终端。报错四openclaw doctor显示 provider 未识别。检查settings.json的 JSON 格式多一个逗号都会解析失败。用cat ~/.openclaw/settings.json看内容或者拿 JSON 校验工具过一遍。报错五chat 命令卡住无输出。先用上面那条 curl 单独测通道。curl 通、OpenClaw 不通就是配置文件路径不对——确认文件在~/.openclaw/下而不是项目目录里用户级和项目级别搞混。报错六返回 401。Key 复制时带了空格或者创建后没保存。回控制台重新生成一个https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。报错七模型名报 not found。model字段填的名字和平台实际提供的对不上。去模型对话页确认可用模型名别凭记忆写。6. 装完之后把通道用顺到这一步OpenClaw 应该已经能在终端里正常对话和改代码了。如果你打算长期用它做项目开发、跑 Agent 任务建议把调用方式从按次切到 Coding Plan额度更划算适合高频编码场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入细节和参数说明都在文档里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后留一个我踩过的坑settings.json里的baseUrl千万别手滑写成https://taotoken.net/api/带结尾斜杠有些 HTTP 客户端会把路径拼成//v1/...服务端直接 404排查半天以为是 Key 的问题。配置改完记得重开终端再测别在旧会话里反复试。
