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 4gateway是 OpenClaw 的后台服务负责接收指令并调度模型dashboard是 Web UI 面板openclawdashboard命令启动的就是它。端口如果被占用改成其他值即可比如 18791。auto_start true表示网关随面板一起启动省得你每次手动开两个窗口。4.3 安装脚本与首次 setupWindows 用户以管理员身份打开 PowerShell执行官方安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex这一步会拉取 OpenClaw 主体和依赖静等结束。首次安装完成后会自动进入 setup 配置阶段如果已经装过用下面这条命令重新进入openclaw onboard --install-daemon配置过程中会遇到几个提示I understand this is personal-by-default...选 YesSetup mode选 QuickStartModel/auth provider选 DeepSeekEnter DeepSeek API key填入你的 TaoToken KeyDefault 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 面板。把这几件事理顺下次再装新工具或者接新模型你就有了一套可复用的配置习惯而不是每次从零踩坑。