1. 为什么第一次装 OpenClaw 总卡在 Node.js 和模型接入OpenClaw 是一个能在本地跑起来的 AI 助手支持命令行和图形界面两种玩法适合想在自己电脑上搭一套「能干活」的智能体、又不想被某个云平台绑死的开发者。它的核心能力是连接不同模型提供商通过 Gateway 统一调度再配合 Skill 扩展做具体任务。听起来很美好但第一次部署的人十有八九会卡在两件事上一是 Node.js 版本不对导致安装直接失败二是模型接入时不知道该填哪个 Base URL、哪个模型 ID配完发现请求发不出去。我自己第一次装的时候Node 用的是 18pnpm add -g openclaw跑完看着像成功结果openclaw onboard一执行就报模块加载错误折腾半天才发现是版本门槛。后来把 Node 升到 22 才顺过去。模型接入这块更绕OpenClaw 默认向导里列的是 Anthropic、OpenAI、Google 这些DeepSeek 需要走自定义提供商或者选对应入口Base URL 和模型 ID 填错一个字符就是 401 或 404。这篇就按「从零到能用」的顺序走一遍先把 Node.js 环境弄干净再装 OpenClaw然后搭好配置文件骨架最后通过统一 Key/API 通道把 DeepSeek 接进来每一步都给可复制的命令和配置片段配完能直接验证。如果你手上还没有可用的 API Key可以先去 TaoToken 拿一个后面接入部分会用到它的统一通道。2. 前置准备Node.js 22 环境与 TaoToken Key2.1 Node.js 版本检查与安装OpenClaw 要求 Node.js 22 或更高。先查当前版本node -v如果输出是 v18.x 或 v20.x就得升级。Linux/macOS 推荐用 nvm 管理curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash source ~/.bashrc nvm install 22 nvm use 22 node -vWindows 用户直接去 Node.js 官网下 22 的 LTS 安装包装完在 PowerShell 里node -v确认。包管理器方面OpenClaw 官方推荐 pnpm先装npm install -g pnpm pnpm -v注意如果你之前用 npm 全局装过旧版 openclaw先npm uninstall -g openclaw清掉避免两个包管理器打架。2.2 获取统一 Key模型接入需要一个 API Key。TaoToken 提供统一 Key/API 通道一个 Key 可以走多个模型省得每个提供商单独注册。去控制台创建一个控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Key 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite创建完把 Key 复制下来形如sk-xxxxxxxx后面配置里要用。API 基础地址是https://taotoken.net/api注意这个地址不带任何查询参数直接填。3. 安装 OpenClaw 与配置文件骨架3.1 命令行安装Linux/macOS 下用 pnpm 全局安装pnpm add -g openclaw openclaw --version能打印出版本号就说明装上了。Windows 如果不想碰命令行也有图形化整合版解压后双击启动程序选纯英文路径比如D:\OpenClaw它会自动把 Git、Node.js、Python、浏览器驱动一起部署好3 到 5 分钟完事。不过图形版和命令行版的配置文件位置略有差异下面以命令行版为准。3.2 初始化与目录结构装完先跑初始化向导openclaw onboard --install-daemon向导会依次问你是否理解默认个人使用、Setup mode 选 QuickStart、模型提供商选哪个、填 API Key、默认模型名。第一次可以先随便选一个跳过我们后面手动改配置文件。初始化完成后配置目录在~/.openclaw/结构大致是~/.openclaw/ ├── config.toml # 主配置 ├── settings.json # 运行时设置 ├── gateway/ # Gateway 相关 └── logs/ # 日志3.3 config.toml 骨架config.toml是主配置模型提供商、Gateway 端口都在这。一个可用的骨架长这样[gateway] port 18789 host 127.0.0.1 [providers.deepseek] type openai-completions base_url https://taotoken.net/api api_key sk-你的Key default_model deepseek-chat [models] default deepseek-chat这里type填openai-completions因为 DeepSeek 的接口兼容 OpenAI 格式。base_url用 TaoToken 的统一地址api_key换成你刚创建的那个。default_model先填deepseek-chat后面可以换成别的。3.4 settings.json 骨架settings.json管运行时行为比如日志级别、超时、是否自动重连{ log_level: info, request_timeout: 60000, auto_reconnect: true, gateway: { port: 18789, host: 127.0.0.1 }, providers: { deepseek: { enabled: true, model: deepseek-chat } } }两个文件里的端口保持一致都是 18789。改完保存别急着启动先做语法检查。4. 接入 DeepSeek 并验证请求4.1 通过向导接入如果不想手改配置也可以重新跑向导openclaw onboard --install-daemon遇到I understand this is personal-by-default...选 YesSetup mode选 QuickStartModel/auth provider选 DeepSeekEnter DeepSeek API key粘贴你的 KeyDefault model选Enter model手动填deepseek-chat。其余消息频道、Skill 之类新手先 Skip for now。4.2 启动 Gateway 并验证配置就绪后启动openclaw gateway start openclaw gateway statusstatus应该显示 running端口 18789。然后发一条测试请求curl -X POST http://127.0.0.1:18789/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的Key \ -d { model: deepseek-chat, messages: [{role: user, content: 用一句话说明你是什么模型}] }如果返回里带choices和模型回复内容说明链路通了。返回 401 就是 Key 不对404 多半是 Base URL 或模型 ID 写错。4.3 打开 Control UI想用图形界面看对话跑openclaw dashboard浏览器会自动打开 Control UI在 Settings 或 Models 区域能看到当前提供商和模型。想换模型直接在界面里改或者回到config.toml把default_model换成deepseek-reasoner再重启 Gateway。5. 本篇常见报错排查5.1 Node 版本不达标报错关键词Unsupported engine或requires Node 22。解决就是升 Node别想着绕过OpenClaw 用了 22 的新 API低版本跑不起来。5.2 Gateway 起不来或端口占用openclaw gateway status显示 unreachable先看端口lsof -i :18789有别的进程占着就换端口改config.toml和settings.json里的 port然后openclaw gateway stop openclaw gateway start openclaw gateway status --deep5.3 模型请求 401 / 404401 是 Key 问题检查api_key有没有多余空格、是不是复制全了。404 是地址或模型名问题确认base_url是https://taotoken.net/api模型 ID 拼写正确。可以用openclaw doctor做一次自检openclaw doctor openclaw doctor --fix5.4 升级后插件不兼容升级用openclaw gateway stop openclaw update --yes --no-restart openclaw gateway start如果升级后插件报兼容问题绕过内置升级器直接装指定版本npm install -g openclaw2026.9.5 openclaw --version openclaw gateway start openclaw plugins update parallel --dry-run openclaw update repair新版本有问题就回滚npm install -g openclaw2026.9.4 openclaw gateway start5.5 守护进程相关不想让它开机自启openclaw daemon stop openclaw daemon disable重启 Gateway 时如果正在跑任务用安全重启等它收尾openclaw gateway restart --safe急着重启就--force。6. 后续怎么用模型对话、Coding Plan 与文档链路通了之后日常使用有几个方向。想快速验证模型效果、做对话测试直接开模型对话页面https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 。如果你打算把 OpenClaw 长期挂在本地做编码助手或 Agent 任务Coding Plan 更划算入口在https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入过程中遇到参数细节查接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。Key 管理和新建还是走 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。配置这块最容易踩的坑是改完config.toml忘了重启 Gateway导致新模型不生效。养成习惯改配置 →openclaw gateway restart→openclaw gateway status --deep确认三步走完再发请求。另外~/.openclaw/logs/里的日志比终端输出详细得多请求失败先翻日志比瞎猜快。 
长河君 · 2026/9/28 19:14:24 · 阅读 1.2k OpenClaw 安装与配置完整指南：从 Node.js 环境到 DeepSeek 命令行接入 TaoToken
1. 为什么第一次装 OpenClaw 总卡在 Node.js 和模型接入OpenClaw 是一个能在本地跑起来的 AI 助手支持命令行和图形界面两种玩法适合想在自己电脑上搭一套「能干活」的智能体、又不想被某个云平台绑死的开发者。它的核心能力是连接不同模型提供商通过 Gateway 统一调度再配合 Skill 扩展做具体任务。听起来很美好但第一次部署的人十有八九会卡在两件事上一是 Node.js 版本不对导致安装直接失败二是模型接入时不知道该填哪个 Base URL、哪个模型 ID配完发现请求发不出去。我自己第一次装的时候Node 用的是 18pnpm add -g openclaw跑完看着像成功结果openclaw onboard一执行就报模块加载错误折腾半天才发现是版本门槛。后来把 Node 升到 22 才顺过去。模型接入这块更绕OpenClaw 默认向导里列的是 Anthropic、OpenAI、Google 这些DeepSeek 需要走自定义提供商或者选对应入口Base URL 和模型 ID 填错一个字符就是 401 或 404。这篇就按「从零到能用」的顺序走一遍先把 Node.js 环境弄干净再装 OpenClaw然后搭好配置文件骨架最后通过统一 Key/API 通道把 DeepSeek 接进来每一步都给可复制的命令和配置片段配完能直接验证。如果你手上还没有可用的 API Key可以先去 TaoToken 拿一个后面接入部分会用到它的统一通道。2. 前置准备Node.js 22 环境与 TaoToken Key2.1 Node.js 版本检查与安装OpenClaw 要求 Node.js 22 或更高。先查当前版本node -v如果输出是 v18.x 或 v20.x就得升级。Linux/macOS 推荐用 nvm 管理curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash source ~/.bashrc nvm install 22 nvm use 22 node -vWindows 用户直接去 Node.js 官网下 22 的 LTS 安装包装完在 PowerShell 里node -v确认。包管理器方面OpenClaw 官方推荐 pnpm先装npm install -g pnpm pnpm -v注意如果你之前用 npm 全局装过旧版 openclaw先npm uninstall -g openclaw清掉避免两个包管理器打架。2.2 获取统一 Key模型接入需要一个 API Key。TaoToken 提供统一 Key/API 通道一个 Key 可以走多个模型省得每个提供商单独注册。去控制台创建一个控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Key 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite创建完把 Key 复制下来形如sk-xxxxxxxx后面配置里要用。API 基础地址是https://taotoken.net/api注意这个地址不带任何查询参数直接填。3. 安装 OpenClaw 与配置文件骨架3.1 命令行安装Linux/macOS 下用 pnpm 全局安装pnpm add -g openclaw openclaw --version能打印出版本号就说明装上了。Windows 如果不想碰命令行也有图形化整合版解压后双击启动程序选纯英文路径比如D:\OpenClaw它会自动把 Git、Node.js、Python、浏览器驱动一起部署好3 到 5 分钟完事。不过图形版和命令行版的配置文件位置略有差异下面以命令行版为准。3.2 初始化与目录结构装完先跑初始化向导openclaw onboard --install-daemon向导会依次问你是否理解默认个人使用、Setup mode 选 QuickStart、模型提供商选哪个、填 API Key、默认模型名。第一次可以先随便选一个跳过我们后面手动改配置文件。初始化完成后配置目录在~/.openclaw/结构大致是~/.openclaw/ ├── config.toml # 主配置 ├── settings.json # 运行时设置 ├── gateway/ # Gateway 相关 └── logs/ # 日志3.3 config.toml 骨架config.toml是主配置模型提供商、Gateway 端口都在这。一个可用的骨架长这样[gateway] port 18789 host 127.0.0.1 [providers.deepseek] type openai-completions base_url https://taotoken.net/api api_key sk-你的Key default_model deepseek-chat [models] default deepseek-chat这里type填openai-completions因为 DeepSeek 的接口兼容 OpenAI 格式。base_url用 TaoToken 的统一地址api_key换成你刚创建的那个。default_model先填deepseek-chat后面可以换成别的。3.4 settings.json 骨架settings.json管运行时行为比如日志级别、超时、是否自动重连{ log_level: info, request_timeout: 60000, auto_reconnect: true, gateway: { port: 18789, host: 127.0.0.1 }, providers: { deepseek: { enabled: true, model: deepseek-chat } } }两个文件里的端口保持一致都是 18789。改完保存别急着启动先做语法检查。4. 接入 DeepSeek 并验证请求4.1 通过向导接入如果不想手改配置也可以重新跑向导openclaw onboard --install-daemon遇到I understand this is personal-by-default...选 YesSetup mode选 QuickStartModel/auth provider选 DeepSeekEnter DeepSeek API key粘贴你的 KeyDefault model选Enter model手动填deepseek-chat。其余消息频道、Skill 之类新手先 Skip for now。4.2 启动 Gateway 并验证配置就绪后启动openclaw gateway start openclaw gateway statusstatus应该显示 running端口 18789。然后发一条测试请求curl -X POST http://127.0.0.1:18789/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的Key \ -d { model: deepseek-chat, messages: [{role: user, content: 用一句话说明你是什么模型}] }如果返回里带choices和模型回复内容说明链路通了。返回 401 就是 Key 不对404 多半是 Base URL 或模型 ID 写错。4.3 打开 Control UI想用图形界面看对话跑openclaw dashboard浏览器会自动打开 Control UI在 Settings 或 Models 区域能看到当前提供商和模型。想换模型直接在界面里改或者回到config.toml把default_model换成deepseek-reasoner再重启 Gateway。5. 本篇常见报错排查5.1 Node 版本不达标报错关键词Unsupported engine或requires Node 22。解决就是升 Node别想着绕过OpenClaw 用了 22 的新 API低版本跑不起来。5.2 Gateway 起不来或端口占用openclaw gateway status显示 unreachable先看端口lsof -i :18789有别的进程占着就换端口改config.toml和settings.json里的 port然后openclaw gateway stop openclaw gateway start openclaw gateway status --deep5.3 模型请求 401 / 404401 是 Key 问题检查api_key有没有多余空格、是不是复制全了。404 是地址或模型名问题确认base_url是https://taotoken.net/api模型 ID 拼写正确。可以用openclaw doctor做一次自检openclaw doctor openclaw doctor --fix5.4 升级后插件不兼容升级用openclaw gateway stop openclaw update --yes --no-restart openclaw gateway start如果升级后插件报兼容问题绕过内置升级器直接装指定版本npm install -g openclaw2026.9.5 openclaw --version openclaw gateway start openclaw plugins update parallel --dry-run openclaw update repair新版本有问题就回滚npm install -g openclaw2026.9.4 openclaw gateway start5.5 守护进程相关不想让它开机自启openclaw daemon stop openclaw daemon disable重启 Gateway 时如果正在跑任务用安全重启等它收尾openclaw gateway restart --safe急着重启就--force。6. 后续怎么用模型对话、Coding Plan 与文档链路通了之后日常使用有几个方向。想快速验证模型效果、做对话测试直接开模型对话页面https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 。如果你打算把 OpenClaw 长期挂在本地做编码助手或 Agent 任务Coding Plan 更划算入口在https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入过程中遇到参数细节查接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。Key 管理和新建还是走 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。配置这块最容易踩的坑是改完config.toml忘了重启 Gateway导致新模型不生效。养成习惯改配置 →openclaw gateway restart→openclaw gateway status --deep确认三步走完再发请求。另外~/.openclaw/logs/里的日志比终端输出详细得多请求失败先翻日志比瞎猜快。