手把手教你装OpenClaw！从零基础到成功运行，一篇就够（TaoToken 配置版）

1. 为什么零基础装 OpenClaw 总卡在第一步

OpenClaw 这个被社区叫“龙虾”的开源工具，最近在 GitHub 趋势榜和开发者社群里讨论度涨得很快。它能做什么？一句话概括：你用自然语言下指令，它帮你操作电脑完成自动化办公，比如批量整理文件、定时抓取网页数据、把重复的表格处理流程串起来。适合谁？适合不想写大量脚本、但又想让电脑“自己干活”的普通用户和刚入门的开发者。

但问题也出在这里。官方文档对新手不算友好，依赖项说明写得模糊，编译步骤一笔带过；网上能搜到的教程要么是旧版本，命令对不上，要么跳步太多，看完还是不知道下一步点哪里。我试过在 Windows 上从零走一遍，最容易卡住的地方其实就三个：node.js 和 git 没装对、模型接入的 Key 不知道怎么填、装完之后openclawdashboard打不开。这篇就按“先装环境 → 再拉项目 → 配 DeepSeek 模型 → 启动面板验证”的顺序，把每一步拆到能直接复制执行，顺带把 settings.json 和 config.toml 的骨架给你，最后用 TaoToken 的统一 Key 通道把模型接入这一步简化掉。

2. 装 OpenClaw 前先把 node.js 和 git 备好

OpenClaw 的运行依赖两个基础工具：node.js 和 git。你可以把 node.js 理解成“解析并执行 OpenClaw 代码的引擎”，把 git 理解成“帮你把 OpenClaw 项目及其依赖从仓库拉下来的搬运工”。这两个没装好，后面执行安装脚本一定报错。

2.1 node.js 安装与版本确认

去 nodejs.org 下载 LTS 版本，Windows 用户选.msi安装包，一路下一步即可。装完后打开 PowerShell，执行：

node -v npm -v

正常会输出类似v20.11.0和10.2.4的版本号。如果提示“不是内部或外部命令”，说明环境变量没生效，重启一次终端，或者手动把 node.js 安装目录加进 PATH。OpenClaw 对 node.js 版本有要求，建议 18 以上，低于这个版本后面 npm 安装依赖会报engine相关错误。

2.2 git 安装与镜像源处理

git 官网在国内访问不稳定，直接搜“git 国内镜像”找可信的镜像站下载对应系统版本。安装时注意勾选“Add to PATH”，装完同样验证：

git --version

输出git version 2.4x.x就说明可用。git 的作用不只是拉代码，OpenClaw 后续更新、切换分支、拉取 Skill 插件都靠它，所以这一步别跳过。

2.3 硬件与系统的最低门槛

个人体验的话，4-5K 价位的电脑基本够用。内存 16GB 起步比较稳，存储留 50GB 以上，安装过程需要联网。显卡不是必须的，因为我们可以走云端 API 模式，把模型推理交给远端，本地只负责调度和界面。这样即使没有独立显卡，也能把 OpenClaw 跑起来。

3. TaoToken 前置：用统一 Key 打通 DeepSeek 接入

OpenClaw 支持多种模型提供商，DeepSeek 是社区里用得比较多的一个。但如果你同时还想试别的模型，一个个去申请 Key、改配置会很烦。TaoToken 在这里的作用是提供一个统一的 API 通道和 Key 管理入口，你可以在一个地方拿到兼容格式的 Key，然后填进 OpenClaw 的模型配置里，不用为每个模型单独折腾一套接入流程。

具体操作上，先到 TaoToken 官网注册并进入控制台，在 API Keys 页面创建一个新 Key。这个 Key 就是后面填进 OpenClaw 配置里的凭证。TaoToken 的 API 地址是https://taotoken.net/api，它兼容常见的 OpenAI 风格调用格式，所以 OpenClaw 里凡是让你填base_url和api_key的地方，都可以用这套。

提示：Key 创建后只显示一次，复制下来存到安全的地方。不要直接提交到 git 仓库里，后面我们会用配置文件的方式引用。

如果你后面要长期跑编码类任务或者 Agent 工作流，可以顺带看一下 Coding Plan 的额度说明；只是先验证模型能不能通，用按量计费的 Key 就够了。模型对话的入口在控制台的模型对话页，可以先用它测一下 Key 是否有效，再去配 OpenClaw。

4. 可复制配置：settings.json 与 config.toml 骨架

OpenClaw 的配置分两块：一块是项目级的settings.json，管模型提供商和默认模型；一块是config.toml，管网关、面板端口和运行时参数。下面给的是能直接改改就用的骨架。

4.1 settings.json 模型接入配置

在 OpenClaw 项目根目录下找到或新建settings.json，填入：

{ "model": { "provider": "deepseek", "api_key": "你的_TaoToken_Key", "base_url": "https://taotoken.net/api", "default_model": "deepseek-v4-pro", "fallback_model": "deepseek-v4-flash" }, "ui": { "theme": "dark", "language": "zh-CN" } }

这里provider写deepseek是因为 OpenClaw 的 provider 枚举里有这个选项，但base_url指向 TaoToken 的 API 地址，Key 也用 TaoToken 创建的。这样模型请求会先到 TaoToken 的通道，再转发到对应模型，你不需要在本地存 DeepSeek 官方的 Key。default_model和fallback_model按你实际能用的模型名填，deepseek-v4-pro适合复杂任务，deepseek-v4-flash适合快速响应。

4.2 config.toml 网关与面板配置

同目录下新建config.toml：

[gateway] host = "127.0.0.1" port = 18789 auto_start = true [dashboard] enabled = true port = 18790 open_browser = true [runtime] log_level = "info" max_concurrent_tasks = 4

gateway是 OpenClaw 的后台服务，负责接收指令并调度模型；dashboard是 Web UI 面板，openclawdashboard命令启动的就是它。端口如果被占用，改成其他值即可，比如 18791。auto_start = true表示网关随面板一起启动，省得你每次手动开两个窗口。

4.3 安装脚本与首次 setup

Windows 用户以管理员身份打开 PowerShell，执行官方安装脚本：

iwr -useb https://openclaw.ai/install.ps1 | iex

这一步会拉取 OpenClaw 主体和依赖，静等结束。首次安装完成后会自动进入 setup 配置阶段；如果已经装过，用下面这条命令重新进入：

openclaw onboard --install-daemon

配置过程中会遇到几个提示：I understand this is personal-by-default...选 Yes；Setup mode选 QuickStart；Model/auth provider选 DeepSeek；Enter DeepSeek API key填入你的 TaoToken Key；Default model选Enter model后填deepseek-v4-pro或deepseek-v4-flash。消息频道、Skill 这些新手先选Skip for now，后面随时能补。

5. 验证请求：openclawdashboard 启动与成功结果

配置写完后，先别急着开面板，用一条命令验证模型通道是否通：

openclaw model test --provider deepseek

如果返回类似model response: pong或者一段正常的模型回复，说明 Key 和 base_url 都对了。如果报 401，回去检查 Key 有没有复制完整；报 404，检查base_url是不是写成了https://taotoken.net/api而不是别的路径。

模型通了之后，启动网关和面板：

openclaw gateway run

这个窗口保持开着，它是后台服务。然后新开一个终端窗口，执行：

openclawdashboard

浏览器会自动打开http://127.0.0.1:18790，看到 Chat 页面就说明成功了。在输入框里打一句“帮我列出当前目录下的文件”，如果 OpenClaw 能返回结果，整条链路——node.js 运行环境、git 拉取的项目、TaoToken 的 Key 通道、DeepSeek 模型、dashboard 面板——就全部打通了。

注意：openclawdashboard依赖网关在运行。如果你只开面板不开网关，Chat 页面会一直转圈或者提示连接失败。所以顺序是：先gateway run，再openclawdashboard。

6. 本篇常见错排查：从报错到跑通

装 OpenClaw 的过程中，报错基本集中在下面几类，逐条对一下就能定位。

第一类：node或npm不是内部命令。这是 node.js 没装好或 PATH 没生效。重新装一遍，安装时勾选“Add to PATH”，装完重启终端。如果还不行，手动把 node.js 安装目录加到系统环境变量里。

第二类：安装脚本执行到一半报git clone failed。多半是 git 没装或者网络拉取超时。先git --version确认 git 可用，然后检查项目目录是否有写权限。如果是公司网络限制，换一个网络环境重试。

第三类：openclaw model test返回 401。Key 错了或者没填对。去 TaoToken 控制台的 API Keys 页面重新复制一次，注意不要带空格。如果 Key 没问题，检查settings.json里api_key字段有没有被引号包住，JSON 格式对不对。

第四类：openclawdashboard打开后页面空白。先确认gateway run那个窗口还在运行，没有报错退出。然后检查config.toml里dashboard.port和gateway.port有没有冲突，两个端口不能一样。如果端口被其他程序占用，改成 18791、18792 这类不常用的端口。

第五类：模型回复很慢或者超时。把default_model从deepseek-v4-pro换成deepseek-v4-flash试试，flash 版本响应更快，适合先验证链路。如果还是慢，检查本地网络到 TaoToken API 地址的连通性，用curl https://taotoken.net/api看能不能返回正常状态码。

第六类：setup 阶段选错了 provider。不用重装，直接编辑settings.json把provider和base_url改回来，然后重新执行openclaw onboard --install-daemon进入配置阶段覆盖即可。

7. 跑通之后：把 Key 和配置管好，后续接入更省事

OpenClaw 装好只是起点，真正影响后续体验的是 Key 和配置的管理方式。把settings.json和config.toml放在项目根目录，不要提交到公开仓库；Key 统一走 TaoToken 的 API Keys 页面管理，需要换模型时只改default_model字段，不用动 Key。接入文档里有完整的参数说明和示例，遇到字段不确定的时候对着查比猜快。

如果你后面要长期跑编码任务或者 Agent 工作流，Coding Plan 的额度模式会比按量计费更划算；只是日常问答和轻量自动化，按量 Key 足够。模型对话页面可以随时用来单独测某个模型通不通，不用每次都启动 OpenClaw 面板。把这几件事理顺，下次再装新工具或者接新模型，你就有了一套可复用的配置习惯，而不是每次从零踩坑。