1. 第一次跑 OpenClaw 到底卡在哪从 CLI 到网关的真实场景很多人第一次接触 OpenClaw卡住的地方往往不是“不会用”而是“装完之后不知道下一步该干嘛”。命令行敲完安装脚本终端里刷了一屏日志然后呢网关到底起没起控制台 UI 的地址是什么节点在线是什么意思这些问题在官方文档里散落在不同页面新手很容易在第一步就放弃。我自己第一次跑 OpenClaw 的时候就踩过一个很典型的坑安装脚本执行成功openclaw命令也能识别但打开浏览器访问http://127.0.0.1:18789/一直转圈。后来才发现是网关守护进程根本没启动openclaw onboard那一步我跳过了。所以这篇内容的核心目标很明确帮你把 OpenClaw 从 CLI 安装到控制台 UI 确认节点在线的全流程一次跑通每一步都有可复制的命令和明确的验证动作。OpenClaw 本质上是一个本地优先的 AI 网关工具。你可以把它理解成一个“中转站”它跑在你自己的机器上负责管理模型连接、渠道接入和会话状态然后通过一个控制台 UI 让你在浏览器里直接对话。它适合谁适合想在自己电脑上快速体验 AI 对话、又不想折腾复杂云端配置的开发者也适合需要把 AI 能力接入本地工作流的技术用户。Node.js 是它的运行基础CLI 是你操作它的主要入口网关是它的核心服务控制台 UI 是你最终看到界面的地方。这四个东西串起来就是这篇教程的主线。整个流程拆成三步验证CLI 版本确认安装成功、网关端口确认服务在跑、UI 节点状态确认一切就绪。下面按顺序来。2. 前置准备Node.js 22 与 TaoToken 接入配置在装 OpenClaw 之前先把运行环境确认好。OpenClaw 要求Node.js 22 或更新版本这个不是可选项版本低了会在启动网关时报错。你可以先跑一条命令看看当前版本node --version如果输出是v22.x.x或更高没问题。如果低于 22建议用 nvm 或官方安装包升级。Windows 用户如果用的是 PowerShell同样可以跑node --version确认。Node.js 搞定之后接下来是模型接入的配置。OpenClaw 本身是一个网关框架它需要连接一个模型服务才能对话。这里我用 TaoToken 来做接入因为它提供了兼容 OpenAI 格式的 API 接口配置起来比较直接。你需要准备三样东西Base URL、API Key、Model ID。这三个是任何 OpenAI 兼容接口的标准三件套缺一不可。Base URL 填https://taotoken.net/api注意这里不加任何多余路径。API Key 需要你去控制台生成地址是https://taotoken.net/console/api-keys登录后创建一个新的 Key复制出来保存好。Model ID 根据你实际要用的模型填比如gpt-4o或claude-sonnet-4-20250514这类标识符。如果你还没注册可以先从官网入口进https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。注册完之后直接进控制台创建 Key。注意API Key 只在创建时显示一次关掉页面就看不到了。建议创建后立刻粘贴到一个安全的地方比如本地的.env文件或密码管理器。环境变量这块OpenClaw 支持几个关键变量来控制路径解析。如果你是用服务账号运行或者想把配置和状态目录放到自定义位置可以设置export OPENCLAW_HOME/your/custom/home export OPENCLAW_STATE_DIR/your/custom/state export OPENCLAW_CONFIG_PATH/your/custom/config.json普通本地使用不设也行OpenClaw 会用默认路径。但如果你后面遇到“配置文件找不到”或“状态目录权限不足”这类报错回头检查这三个变量。3. 可复制配置安装 CLI、启动网关、打开控制台 UI这一节是整篇的核心操作部分每一步都给完整命令你直接复制粘贴就能跑。3.1 安装 OpenClaw CLImacOS 和 Linux 用户用官方安装脚本curl -fsSL https://openclaw.ai/install.sh | bashWindows 用户用 PowerShell 执行对应的安装命令。如果下载速度慢可以换国内镜像源。npm 安装方式也可以指定镜像源会快很多npm install -g openclaw --registryhttps://registry.npmmirror.com安装完成后验证 CLI 是否可用openclaw --version能输出版本号就说明 CLI 装好了。这是第一步验证动作。3.2 运行引导向导安装完 CLI 之后跑引导向导来配置认证、网关设置和可选的渠道接入openclaw onboard --install-daemon这个命令会做几件事配置认证信息、设置网关参数、安装守护进程。--install-daemon这个参数很关键它会让网关作为后台服务运行这样你关掉终端之后网关也不会停。如果你跳过这一步后面打开控制台 UI 会连不上。向导过程中会提示你输入 API Key 和 Base URL把前面准备好的 TaoToken 信息填进去。Model ID 也在这里配置。3.3 检查网关状态向导跑完之后检查网关是否已经在运行openclaw gateway status如果输出显示网关正在运行并且端口是18789说明服务已经起来了。这是第二步验证动作。如果状态显示未运行可以手动在前台启动网关来排查问题openclaw gateway --port 18789前台运行的好处是日志直接打在终端里报错一眼就能看到。适合快速测试和排障。3.4 打开控制台 UI网关确认在跑之后打开控制台 UIopenclaw dashboard这个命令会自动在浏览器中打开控制台界面。如果你在网关主机上直接操作也可以手动访问http://127.0.0.1:18789/控制台 UI 加载出来后你会看到节点状态面板。如果节点显示在线说明整个链路已经通了。这是第三步验证动作。3.5 配置文件参考OpenClaw 的配置文件通常是 JSON 格式路径由OPENCLAW_CONFIG_PATH决定。一个典型的配置片段长这样{ gateway: { port: 18789, host: 127.0.0.1 }, provider: { baseUrl: https://taotoken.net/api, apiKey: sk-your-key-here, model: gpt-4o } }如果你用的是 TOML 格式或者 settings 文件字段名基本对应。关键是baseUrl、apiKey、model这三个字段要和前面准备的三件套一致。4. 验证请求确认网关、端口与节点状态全部就绪配置写完不等于跑通得实际验证。这一节给你三个具体的验证动作每个都有明确的预期结果。验证一CLI 版本openclaw --version预期输出版本号比如1.x.x。如果报command not found说明安装没成功回头检查 npm 全局路径是否在 PATH 里。验证二网关端口openclaw gateway status预期输出网关运行中端口18789。如果显示未运行用openclaw gateway --port 18789前台启动看报错。你也可以用系统命令确认端口是否被监听lsof -i :18789或者netstat -tlnp | grep 18789有输出就说明端口在监听。验证三UI 节点状态打开http://127.0.0.1:18789/看控制台界面里的节点状态。如果显示“在线”或“connected”说明网关和 UI 之间的通信正常。三个验证都通过之后你可以发一条测试消息。如果已经配置了渠道可以用openclaw message send --target 15555550123 --message Hello from OpenClaw没有配置渠道的话直接在控制台 UI 里输入框打字发送就行。能收到回复说明模型接入也通了。提示如果你在控制台 UI 里发消息后一直转圈大概率是模型接入配置有问题。回头检查 Base URL 是否填了https://taotoken.net/apiAPI Key 是否有效Model ID 是否正确。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节列几个新手最常遇到的报错每个都给排查方向。401 Unauthorized这个基本就是 API Key 的问题。检查三件事Key 是否复制完整有没有漏字符、Key 是否已过期或被删除、Base URL 是否填对。如果你用的是 TaoToken 的 Key确认 Base URL 是https://taotoken.net/api不要多加/v1或其他路径。local proxy failed这个报错通常出现在网关启动阶段。原因可能是端口被占用或者守护进程没装好。先检查18789端口是否被其他程序占了lsof -i :18789如果有其他进程杀掉或者换一个端口启动openclaw gateway --port 18790换端口之后记得控制台 UI 的访问地址也要跟着改。reading choices 报错这个一般出现在模型返回格式不符合预期的时候。OpenClaw 期望的是 OpenAI 兼容的响应格式如果模型服务返回的结构不对就会在解析choices字段时报错。排查方向确认 Base URL 指向的是兼容 OpenAI 格式的接口Model ID 填的是服务端支持的模型标识。OAuth 相关报错如果你在引导向导里选了 OAuth 认证方式但回调地址或客户端配置不对会卡在授权环节。最简单的办法是改用 API Key 认证在openclaw onboard时选择 API Key 方式填入 TaoToken 的 Key 就行。Codex auth.json 相关如果你同时在用 Codex 或其他工具注意auth.json的路径不要和 OpenClaw 的配置冲突。OpenClaw 的认证信息存在自己的配置目录里由OPENCLAW_CONFIG_PATH控制。两个工具各用各的配置不要混在一起。CC Switch / Cline MCP 配置如果你在用 CC Switch 或 Cline 的 MCP 功能配置 OpenClaw 的时候同样需要三件套Base URL 填https://taotoken.net/apiAPI Key 填你生成的 KeyModel ID 填对应模型标识。这三个字段在任何 OpenAI 兼容客户端里都是通用的。6. 跑通之后从控制台 UI 到长期编码工作流控制台 UI 能打开、节点显示在线、发消息能收到回复这三件事都做到之后OpenClaw 的基础链路就算跑通了。接下来你可以根据自己的使用场景往下走。如果你只是想在浏览器里快速对话那控制台 UI 已经够用了。日常打开http://127.0.0.1:18789/就能用不需要每次敲命令。如果你想把 OpenClaw 接入长期编码工作流比如配合 Claude Code 或 Codex 做 Agent 任务那需要进一步配置渠道和认证。TaoToken 的 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。API Key 的管理页面在https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content随时可以创建新 Key 或吊销旧的。想先试试模型对话效果的话可以直接从https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content进模型对话页面体验。最后说一个实际经验OpenClaw 的网关守护进程装好之后开机自启是默认行为。如果你发现重启电脑后控制台 UI 打不开先跑openclaw gateway status看网关是不是没起来。大部分情况下是守护进程被系统安全策略拦了重新跑一次openclaw onboard --install-daemon就能修复。