ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

Windows 安装 OpenClaw 龙虾:TaoToken 配置文件与 PowerShell 验证清单

Windows 安装 OpenClaw 龙虾:TaoToken 配置文件与 PowerShell 验证清单 1. Windows 跑 OpenClaw 龙虾为什么我最后选了 WSL2 TaoTokenOpenClaw 龙虾是一个能在本地跑起来的 AI 编码助手支持对话、读写文件、执行命令适合想在自己电脑上折腾 Agent 的 Windows 新手。它本身不绑定模型你可以接任意兼容 OpenAI 协议的服务这也是我推荐用 TaoToken 统一 Key 的原因——一个 Key 打通多家模型配置一次就能在 OpenClaw 里切换。这篇聚焦一件事在 Windows 上把 OpenClaw 龙虾跑通并且用 TaoToken 的 API 通道接上模型装完就能直接对话。路径分两条原生 PowerShell 一键装最快WSL2 Ubuntu 最稳。我会把两条路都走一遍重点给出config.toml骨架和settings.json示例再附上逐步验证命令确保你装完不是「看起来成功」而是真的能发消息收到回复。适合谁看Windows 10/11 用户没写过多少命令行但愿意复制粘贴想用 OpenClaw 做本地编码助手手里有 TaoToken 的 Key 或者准备去申请一个。全程不需要额外网络工具命令都是官方或通用做法。先说结论新手先用方案 A 原生 PowerShell 试水五分钟能跑起来如果你打算长期用、经常跑 Agent 任务直接上方案 B 的 WSL2环境干净、依赖不打架。两条路的配置部分完全一样TaoToken 的 Key 和config.toml可以复用。2. 前置准备TaoToken Key 与 OpenClaw 安装环境2.1 拿到 TaoToken 的 API KeyTaoToken 是一个模型 API 聚合通道兼容 OpenAI 的接口格式所以 OpenClaw 这类支持自定义 base_url 的工具可以直接接。你需要先去官网注册然后在控制台创建一个 API Key。官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content创建 Key 的页面在控制台里路径是 console 下的 api-keys控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content创建完复制那串sk-开头的 Key先存到记事本后面配置要用。注意别把它提交到 Git 仓库也别贴到公开群里。TaoToken 的 API 基地址是https://taotoken.net/api这个地址不加任何查询参数配置时直接填。OpenClaw 里填 base_url 的时候通常要带上/v1也就是https://taotoken.net/api/v1具体看下面配置章节。2.2 系统与依赖检查Windows 10/11 64 位内存 2GB 起步推荐 4GB 以上。网络能正常访问外网即可。安装前临时关掉 360、电脑管家、Windows Defender 的实时防护避免安装脚本被拦截装完再开回来。OpenClaw 依赖 Node.js 和 Git。方案 A 的一键脚本会自动装 Node.js但 Git 建议手动装因为后面拉依赖可能用到。Git 下载地址用官方那个安装时务必勾选「Add Git to PATH」其他保持默认。如果你走方案 B 的 WSL2Node.js 和 Git 都在 Ubuntu 里装Windows 这边只需要装好 WSL2 本身。3. 方案 A原生 PowerShell 一键安装 OpenClaw3.1 解锁脚本执行权限按 Win 键搜索 PowerShell右键「以管理员身份运行」弹出用户账户控制点「是」。然后执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser回车后输入Y确认。这一步是让 PowerShell 允许运行本地脚本不做的话后面安装脚本会被拦。3.2 一键安装复制下面这行回车耐心等 3 到 5 分钟脚本会自动装 Node.js 和 OpenClaw 依赖iwr -useb https://openclaw.ai/install.ps1 | iex看到OpenClaw installed successfully就成功了。如果中途网络超时先配一下 npm 国内镜像再重试npm config set registry https://registry.npmmirror.com npm i -g openclaw3.3 验证安装openclaw --version显示版本号比如2026.3.x就对了。如果提示openclaw 不是内部或外部命令关掉所有终端重新开一个管理员 PowerShell再执行npm install -g openclawlatest。4. 方案 BWSL2 Ubuntu 安装 OpenClaw4.1 装 WSL2管理员 PowerShell 里执行wsl --install装完重启电脑。重启后开始菜单打开 Ubuntu设置用户名和密码密码输入时不显示正常现象然后更新sudo apt update sudo apt upgrade -y4.2 在 Ubuntu 里装 OpenClawcurl -fsSL https://openclaw.ai/install.sh | bash openclaw --version版本号出来就说明装好了。WSL2 里的 OpenClaw 和 Windows 原生的是两套环境配置要单独做但配置文件格式一样。5. TaoToken 配置config.toml 骨架与 settings.json 示例5.1 config.toml 骨架OpenClaw 的主配置在~/.openclaw/config.tomlWindows 下是C:\Users\你的用户名\.openclaw\config.toml。用 TaoToken 接模型骨架如下[model] provider openai-compatible base_url https://taotoken.net/api/v1 api_key sk-你的TaoToken密钥 model gpt-4o-mini [agent] name openclaw max_tokens 4096 temperature 0.7 [server] host 127.0.0.1 port 18789几个关键点base_url填 TaoToken 的 API 地址加/v1api_key换成你控制台创建的那串model填你想用的模型名TaoToken 支持多家模型具体名字在模型对话页面能看到。5.2 settings.json 示例有些版本的 OpenClaw 用settings.json存运行时偏好放在同目录下{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api/v1, apiKey: sk-你的TaoToken密钥, modelName: gpt-4o-mini }, ui: { theme: dark, language: zh-CN }, agent: { autoApprove: false, workspace: C:\\Users\\你的用户名\\openclaw-workspace } }autoApprove建议先设false让 Agent 每次执行命令前问你一下确认没问题再放开。workspace是 Agent 读写文件的目录别指到系统盘根目录。5.3 用 onboard 交互式配置不想手写配置的话跑openclaw onboard按提示选模型服务商这里选「自定义 OpenAI 兼容」然后填 base_url 和 API Key。方向键选 Yes 回车确认。如果界面和你预期不一样CtrlC 退出重来。6. 验证请求确认 OpenClaw 真的能对话6.1 启动服务openclaw start openclaw dashboard浏览器会自动打开http://127.0.0.1:18789用生成的 Token 登录。6.2 命令行验证先确认配置读到了openclaw config show看输出的 base_url 和 model 是不是你填的。然后发一条测试消息openclaw chat 你好用一句话介绍你自己如果返回了模型回复说明 TaoToken 通道打通了。没返回的话看下一节排错。6.3 面板里验证在 dashboard 的对话窗口发一条消息能收到回复就说明整条链路 OK。这时候你可以试试让它读一个文件、写一段代码确认 Agent 能力正常。7. 本篇常见报错排查7.1 openclaw 命令找不到关掉所有终端重新开管理员 PowerShell执行npm install -g openclawlatest还不行就检查 Node.js 是否装好node -v和npm -v都要有版本号。7.2 安装卡住或失败先关杀毒和防火墙换手机热点重试。npm 镜像配好npm config set registry https://registry.npmmirror.com7.3 401 或鉴权失败检查config.toml里的api_key是不是完整的sk-开头字符串有没有多余空格。base_url 确认是https://taotoken.net/api/v1别漏了/v1。7.4 模型名不对报model not found的话去 TaoToken 的模型对话页面确认可用模型名填到配置里。不同模型名字不一样别照抄别人的。7.5 WSL2 里连不上 127.0.0.1WSL2 的网络和 Windows 是隔离的如果你在 Windows 浏览器访问 WSL2 里的服务需要用 WSL2 的 IP。执行hostname -I拿到 IP再访问http://那个IP:18789。8. 接下来怎么用模型对话、Coding Plan 与接入文档配置跑通之后日常用 OpenClaw 就是三件事对话、写代码、跑 Agent 任务。TaoToken 这边有几个入口可以配合用。想先试试模型效果直接去模型对话页面发消息不用装任何东西https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content如果你打算长期用 OpenClaw 做编码助手或者跑 Claude Code 这类 Agent 工具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_contentClaude Code 用户看这个专门页https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content我自己的习惯是Windows 上用 WSL2 跑 OpenClaw配置里 base_url 固定填 TaoToken模型按任务换。写代码用强一点的模型日常问答用便宜的。Key 只存本地配置文件不提交 Git。装完先跑openclaw chat验证通了再开 dashboard省得在浏览器里瞎点找不到问题。
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进