1. OpenClaw 是什么五种安装路径怎么选OpenClaw 是一个能在本地跑起来的 AI Agent 运行框架社区里习惯叫它「龙虾」。它和普通聊天机器人的区别在于它能直接读写你机器上的文件、执行命令、调用本地程序把大模型的推理能力接到真实的工作目录里。适合谁想在自己电脑或云主机上跑一个能动手干活的 AI 助手、又不想把数据全交给在线服务的开发者。但第一次部署 OpenClaw 的人八成会卡在同一个地方到底该装在哪儿。Windows 直接装、Ubuntu 直接装、Windows 走 Docker、Ubuntu 走 Docker、Windows 用 WSL 加 Docker 源码装——这五条路各有各的依赖清单和坑选错了后面全是报错。我见过有人在一台日常办公的 Windows 上直接装结果 Agent 权限太高误删了工作文件也见过有人在云主机上折腾源码编译卡在 Node 版本上两小时。这篇把五条路径拆开讲清楚每条路需要什么系统、装哪些依赖、跑什么命令、装完怎么验证服务真的起来了。你可以按自己的系统对号入座也可以先看下面的对照表再决定。安装方式系统要求难度隔离性本机访问能力推荐场景Windows 直接安装Windows 10/11中低最强专用工作机追求本机控制Ubuntu 直接安装Ubuntu 20.04中低强Linux 熟练用户本地或云端Windows Docker 镜像Windows WSL2低中中快速上手兼顾便捷与隔离Ubuntu Docker 镜像Ubuntu Docker低中中最快部署云端首选WSL Docker 源码Windows WSL2高最高可控安全要求高的长期运行选路的核心逻辑就一句话你要 Agent 碰本机文件就直接装你只想让它干活又怕它乱来就上容器你既要安全又要源码可控就 WSL 套 Docker 再编译。不管走哪条路装完之后都要接一个大模型 API 才能真正跑起来。这一步我会在每条路径里都给出可复制的配置片段统一用 TaoToken 的接口做示例因为它的 Base URL 和 Key 格式对 OpenClaw 这类工具比较友好配置项少。2. 装之前先把 TaoToken 的 Key 和接口准备好OpenClaw 本身只是个壳它需要一个大模型后端来驱动。你在安装过程中会反复填三个东西Base URL、API Key、Model ID。这三个值提前拿到手后面每条安装路径都能直接套。先说 Base URL。TaoToken 的 API 入口是https://taotoken.net/api注意这个地址不带任何查询参数直接填进配置里就行。官网是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册和看文档都从这里进。拿 Key 的步骤不复杂进控制台创建一个 API Key复制出来。这个 Key 只显示一次建议先存到密码管理器里。控制台地址是https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 管理页在https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite。Model ID 这块要注意不同模型的名字不一样你得在文档里查当前支持的模型列表。文档入口是https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite。填错 Model ID 是后面 401 和reading choices报错的高频原因先确认再往下走。如果你只是想先验证 Key 能不能用不用装 OpenClaw直接开模型对话页面测一下https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite。能正常出结果说明 Key 和模型都没问题再去折腾安装。对于打算长期跑 Agent、频繁调用的场景可以看下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite。它的计费方式对持续编码类任务更划算具体额度以页面说明为准。把这三个值记下来Base URL: https://taotoken.net/api API Key: 你的 Key控制台创建 Model ID: 按文档填例如 claude-sonnet-4-5 之类下面五条安装路径每条装完都会回到这三个值来配置。你可以先把它们写在一个临时文本里省得来回切页面。3. 五条安装路径的可复制配置与命令这一节是全文的核心五条路径按顺序给命令。每条都包含依赖清单、安装命令、配置片段、启动方式。你只需要看自己系统对应的那一段。3.1 Windows 直接安装依赖清单Node.js 18、Git Bash、pnpm或 npm。先去 Node 官网装 LTS 版本装完在 Git Bash 里验证node -v npm -v拉源码并安装依赖git clone https://github.com/openclaw/openclaw.git cd openclaw npm install -g pnpm pnpm install pnpm build配置大模型参数。OpenClaw 一般读项目根目录下的配置文件创建一个config.json{ provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 你的_API_Key, model: 你的_Model_ID, gateway: { port: 3000 } }启动服务pnpm start看到监听 3000 端口的日志就算起来了。这种方式 Agent 能直接访问 Windows 文件系统权限很高建议在专用机器上跑。3.2 Ubuntu 直接安装依赖清单Node.js 18、git、build-essential。一键脚本思路是先装依赖再拉源码sudo apt update sudo apt install -y git curl build-essential curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt install -y nodejs node -v拉源码编译git clone https://github.com/openclaw/openclaw.git cd openclaw npm install -g pnpm pnpm install pnpm build配置文件同样是config.json内容与上面 Windows 段一致把 Base URL、Key、Model ID 填进去。启动pnpm start云端 Ubuntu 实例记得在安全组放行你配置的端口否则本地浏览器访问不到。3.3 Windows Docker 镜像安装前提先装 WSL2。在管理员 PowerShell 里执行wsl --install wsl --set-default-version 2装完重启再装 Docker Desktop安装时勾选「使用 WSL2 后端」。验证docker --version docker run hello-world加载 OpenClaw 镜像并启动容器docker load -i openclaw-image.tar docker run -d --name openclaw \ -p 3000:3000 \ -v /your/data:/data \ -e OPENCLAW_BASE_URLhttps://taotoken.net/api \ -e OPENCLAW_API_KEY你的_API_Key \ -e OPENCLAW_MODEL你的_Model_ID \ openclaw:latest用环境变量传参比改配置文件更适合容器场景。启动后docker logs openclaw看日志。3.4 Ubuntu Docker 镜像安装依赖Docker Engine。安装sudo apt update sudo apt install -y docker.io sudo systemctl enable --now docker sudo usermod -aG docker $USER重新登录后验证docker ps不报权限错。加载镜像并启动命令与 Windows Docker 段一致docker load -i openclaw-image.tar docker run -d --name openclaw \ -p 3000:3000 \ -v /opt/openclaw/data:/data \ -e OPENCLAW_BASE_URLhttps://taotoken.net/api \ -e OPENCLAW_API_KEY你的_API_Key \ -e OPENCLAW_MODEL你的_Model_ID \ openclaw:latest这是云端部署最快的一条路镜像加载完基本就能用。3.5 Windows WSL Docker 源码安装这是隔离性最强的方案。先装 WSL2 并安装 Ubuntu 22.04wsl --install -d Ubuntu-22.04进入 WSL 后在 Ubuntu 里装 Docker 和 Nodesudo apt update sudo apt install -y docker.io git curl build-essential curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt install -y nodejs拉源码编译步骤同 Ubuntu 直接安装。编译完成后用 Docker 打包运行或者直接在 WSL 里pnpm start。配置文件config.json里填{ provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 你的_API_Key, model: 你的_Model_ID }WSL 的文件系统和 Windows 是隔离的Agent 在 WSL 里操作不会直接碰到 Windows 主系统文件安全性最高。4. 装完怎么验证服务真的可用装完不代表能用。很多人卡在「服务起来了但请求不通」。这一节给你一套验证动作按顺序做。第一步确认进程在监听。直接装的方式看终端日志Docker 方式看容器状态docker ps docker logs --tail 50 openclaw第二步本地 curl 打一下健康检查或首页curl -i http://localhost:3000/返回 200 或正常 HTML 就说明服务活着。第三步验证大模型链路。这一步最关键因为服务活着不代表能调通模型。用一个最小的请求测curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的_API_Key \ -H Content-Type: application/json \ -d { model: 你的_Model_ID, messages: [{role: user, content: ping}] }如果返回里有choices字段和内容说明 Key、Base URL、Model ID 三者都对。如果报 401是 Key 问题如果报模型不存在是 Model ID 问题如果连接超时检查网络和 Base URL 是否写错。第四步在 OpenClaw 界面里发一条真实指令比如让它列一下当前目录文件。能正确返回整条链路就通了。我实测下来最容易出问题的是第三步。很多人服务起来了就直接用结果 Agent 一直转圈最后发现是 Model ID 填了个不存在的名字。所以务必先用 curl 单独验证模型接口再回到 OpenClaw 里用。5. 常见报错排查401、local proxy failed、reading choices这一节按真实报错来对。你遇到哪个直接找对应段落。401 Unauthorized。九成是 API Key 的问题。检查三件事Key 有没有复制完整前后有没有空格、Key 是不是已经失效或被删、请求头里Authorization格式对不对。正确格式是Bearer 你的Key中间一个空格。如果你用的是环境变量传参确认变量名和代码里读的名字一致Docker 里-e传的变量名写错也会导致读到空值。local proxy failed。这个报错通常出现在你本地配了代理但代理没起来或者端口不对。OpenClaw 请求模型接口时走了本地代理代理挂了就报这个。排查检查系统代理设置确认代理进程在跑如果不需要代理把相关环境变量清掉unset http_proxy unset https_proxyDocker 容器里如果继承了宿主机的代理变量也会出这个问题启动时显式覆盖掉。reading choices 报错。这个一般是大模型返回结构不符合预期。常见原因Model ID 填错接口返回的是错误信息而不是正常的choices数组或者 Base URL 少了/v1路径。先确认你的 Base URL 是https://taotoken.net/api再确认 Model ID 在文档里存在。用第 4 节的 curl 命令单独测一次能快速定位是接口问题还是 OpenClaw 配置问题。OAuth 相关报错。如果你用的是需要 OAuth 的模型接入方式报错通常是 token 过期或回调地址不对。检查你的 OAuth 配置里的回调 URL 是否和实际访问地址一致token 是否需要刷新。这类问题在文档里有对应说明建议对照文档逐项核对。容器启动后立刻退出。docker ps -a看到状态是 Exited。用docker logs openclaw看退出前的日志多半是环境变量没传全或者挂载目录权限不对。挂载目录建议用绝对路径并确保容器内用户有读写权限。端口被占用。启动时报address already in use。换一个端口或者找到占用进程杀掉lsof -i :3000排查的核心思路是分层先确认服务进程活着再确认本地接口能通最后确认模型接口能通。哪一层断了就修哪一层不要一上来就重装。6. 按场景选路与后续接入回到最开始的问题五条路到底选哪条。给你几个直接的建议。如果你有一台专门的 Windows 机器想让 Agent 最大程度控制本机选 Windows 直接安装。如果你在云上有 Ubuntu 实例想最快跑起来选 Ubuntu Docker 镜像。如果你在 Windows 上日常办公又不想让 Agent 碰你的工作文件选 Windows Docker 镜像或者 WSL Docker 源码。安全要求最高的选最后一条。装完之后真正让 OpenClaw 干活还需要接模型。前面反复用到的三个值——Base URLhttps://taotoken.net/api、API Key、Model ID——在每条路径的配置片段里都出现了。如果你还没拿 Key去控制台创建https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite。接入细节和模型列表看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite。想先不装 OpenClaw、直接验证模型能不能用开模型对话页测一条https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite。打算长期跑编码类 Agent 任务看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite。最后提醒一个实操细节不管哪条路径装完先用第 4 节的 curl 命令验证模型接口再去 OpenClaw 里发指令。这一步能帮你省掉大量「服务起来了但用不了」的排查时间。配置文件里的 Model ID 一定要以文档为准别凭记忆填。