ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Windows 下 OpenClaw 安装与卸载全流程:从 NodeJS/npm 到 cmd 配置 TaoToken

Windows 下 OpenClaw 安装与卸载全流程:从 NodeJS/npm 到 cmd 配置 TaoToken 1. Windows 下 OpenClaw 到底能做什么适合谁OpenClaw 是一个跑在本地命令行里的 AI 网关工具你可以把它理解成一个「中转站」它把飞书、网页聊天界面、浏览器插件这些入口统一收拢再通过一份配置把请求转发给大模型。对 Windows 用户来说它的价值在于不用折腾服务器装好 NodeJS 之后用 cmd 就能把整套本地 AI 助手跑起来还能让飞书机器人实时调用你本机的大模型。这篇内容面向三类人一是刚接触命令行、想在自己电脑上跑通 AI 网关的新手二是已经用过 OpenClaw 但想换成 TaoToken 统一 Key 通道的老用户三是装完之后想彻底卸载、不留残留文件的人。我会把安装、配置、验证、排障、卸载整条链路走一遍命令都可以直接复制。需要提前说清楚的是OpenClaw 本身不提供模型能力它只是一个调度层。你真正调用大模型时要么填某个厂商的 API Key要么走一个兼容 OpenAI 协议的统一通道。TaoToken 就是后者它提供统一的 Key 和 API 地址省得你在多个厂商后台之间来回切换。下面所有配置我都会给出可复制的骨架。环境要求很简单Windows 10 或 11NodeJS 版本大于 v22.0.0npm 随 NodeJS 一起装好。低于这个版本会在安装阶段报错别跳过版本检查。2. 前置准备NodeJS、npm 与 TaoToken Key2.1 安装并验证 NodeJS先去 NodeJS 官网下载 LTS 版本安装时勾选「Add to PATH」这样 cmd 里才能直接调用。装完之后用管理员身份打开 cmd这一步很关键普通权限在全局安装时可能写不进目录。node -v npm -v正常会输出类似v22.11.0和10.9.0的版本号。如果node -v报「不是内部或外部命令」说明 PATH 没配好重装并确认勾选项或者手动把 NodeJS 安装目录加进系统环境变量。2.2 拿到 TaoToken 的 Key 和 API 地址TaoToken 的官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录后进控制台创建 API Key。API 基础地址统一用 https://taotoken.net/api 注意这个地址后面不加任何查询参数。创建 Key 的时候复制出来存好很多平台只显示一次。这个 Key 后面会填进 OpenClaw 的配置里作为统一调用凭证。如果你打算长期跑编码类任务或者接 Agent可以顺带看下 Coding Plan 页面按需选择只是临时验证模型通不通用模型对话页面测一下就行。注意Key 属于敏感信息别直接提交到 Git 仓库。本地配置文件建议放在用户目录下不要放在会被同步的文件夹里。3. 可复制配置安装 OpenClaw 并接入 TaoToken3.1 全局安装 OpenClaw在管理员 cmd 里执行npm install -g openclaw-cnlatest openclaw-cn --version第二条命令能打印出版本号就说明安装成功了。如果卡在下载阶段多半是 npm 源的问题可以临时切到国内镜像再装。3.2 运行安装向导openclaw-cn onboard --install-daemon向导里用左右箭头选 yes 回车上下箭头选「手动」再选「本地网关」工作区目录直接回车用默认值。模型选择这一步如果你走 TaoToken 统一通道就选兼容 OpenAI 协议的选项然后把 API 地址填成https://taotoken.net/apiKey 填你在 TaoToken 控制台创建的那串。端口保持默认绑定地址选Loopback (127.0.0.1)认证方式选Token自动更新选Off。网关名称自己起一个比如MyGatewayToken这个名字后面访问网页界面时要用到别随便写。3.3 config.toml 配置骨架OpenClaw 的主配置一般在工作区目录下的config.toml核心段落长这样[gateway] name MyGatewayToken host 127.0.0.1 port 18789 auth token [model] provider openai-compatible base_url https://taotoken.net/api api_key 你的TaoToken Key model deepseek-chat [workspace] dir C:/Users/你的用户名/.openclawbase_url一定不要带多余路径api_key换成你自己的。model字段填你在 TaoToken 里能调用的模型名不确定就先填deepseek-chat试。3.4 settings.json 配置骨架部分版本会把通道和插件设置放在settings.json{ gateway: { name: MyGatewayToken, endpoint: http://127.0.0.1:18789 }, channels: { feishu: { enabled: true, app_id: 你的AppID, app_secret: 你的AppSecret } }, plugins: [boot-md, command-logger, session-memory] }插件那三个是多选项配置向导里要用空格键勾选直接回车会漏选后面容易出问题。4. 验证请求从命令行到网页界面4.1 启动网关openclaw-cn gateway run窗口保持打开关掉就等于停服务。然后浏览器访问http://localhost:18789/chat?sessionmaintokenMyGatewayTokentoken参数必须和你配置里的网关名称一致写错了会提示鉴权失败。4.2 用 curl 验证 TaoToken 通道在另一个 cmd 窗口里发一条测试请求确认 Key 和地址都通curl https://taotoken.net/api/v1/chat/completions ^ -H Content-Type: application/json ^ -H Authorization: Bearer 你的TaoToken Key ^ -d {\model\:\deepseek-chat\,\messages\:[{\role\:\user\,\content\:\你好\}]}返回里带choices字段就说明通道正常。如果返回 401检查 Key 有没有复制完整返回 404检查地址是不是写成了带斜杠的版本。4.3 飞书通道补充配置飞书机器人要实时交互还得在开放平台加事件、重新发布版本。权限用批量导入的方式粘贴 JSON事件名按官方文档填。AppID 和 AppSecret 填进settings.json的channels.feishu段。发布之后机器人才能收到消息。4.4 浏览器插件可选想让 OpenClaw 操作 Chrome先装插件openclaw-cn browser extension install openclaw-cn browser extension path拿到路径后在chrome://extensions里加载已解压的扩展填入网关 Token。注意插件页面不能关否则控制会断。5. 本篇常见错排查报错一openclaw-cn不是内部或外部命令。全局安装目录没进 PATH。执行npm config get prefix看路径把它加进系统环境变量重启 cmd。报错二NodeJS 版本过低。安装阶段直接报 engine 不匹配。升级到 v22 以上卸载旧版再装。报错三网页界面提示 token 无效。检查 URL 里的 token 是否和config.toml里的gateway.name完全一致大小写敏感。报错四调用模型返回 401。TaoToken Key 没填对或者配置文件里还留着旧厂商的 Key。统一改成 TaoToken 的地址和 Key。报错五飞书机器人没反应。事件没加、版本没重新发布或者 AppSecret 填错。回开放平台核对一遍。报错六开机自启残留。卸载前先删计划任务schtasks /Delete /F /TN OpenClaw Gateway6. 卸载清理与后续接入入口停服务有两种情况配过开机自启的先执行openclaw-cn gateway stop或openclaw-cn service stop没配过的直接关掉 cmd 网关窗口就行。然后新开一个 cmd 执行卸载npm uninstall -g openclaw-cn openclaw-cn --version第二条命令如果报「不是内部或外部命令」说明卸载干净了。最后手动删掉工作区目录比如C:/Users/你的用户名/.openclaw这里面存着对话历史、API Key 和钩子设置。想保留数据就先备份再删。如果你在接入阶段卡在 Key 或地址配置上直接去 API Keys 页面重新生成一个对照接入文档逐项核对想先确认模型能不能通用模型对话页面发一条消息最快打算长期跑编码和 Agent 任务Coding Plan 页面有对应的方案说明。整条链路跑通之后你会发现本地网关的好处是配置一次、多个入口复用卸载时也只要清掉一个目录。
返回列表