1. Windows 上装完 OpenClaw 小龙虾为什么第一件事是改 settingsOpenClaw 小龙虾是一个跑在本地、能调用大模型来操作文件和文档的智能体工具你可以把它理解成一个「住在你电脑里的文档助理」你告诉它「把飞书里这周的会议纪要整理成一份周报」它就去读文档、抽取要点、生成新文件。它适合谁适合每天被飞书文档、会议记录、需求清单淹没又不想手动复制粘贴的 Windows 用户。但很多人装完之后卡在同一个地方默认配置指向的模型服务要么连不上要么额度不够用任务跑到一半就报错。这篇教程就解决这个问题——把settings改到 TaoToken让文档整理任务真正跑通。我自己第一次装的时候Node.js 版本差了一个小版本号openclaw onboard直接拒绝启动折腾了半小时才发现是 v22.18 和 v22.19 的区别。所以下面每一步我都会把版本要求、命令、预期输出写清楚你照着敲就行。整体流程分四块先把 Node.js/npm 环境检查干净再全局安装 OpenClaw然后配置openclaw.json把模型指向 TaoToken最后跑一次飞书文档整理任务验证。中间会附上 401、local proxy failed、reading choices这几类真实报错的对照表。先说清楚 TaoToken 在这里的角色它是一个兼容 OpenAI 接口规范的模型聚合服务OpenClaw 通过baseUrlapiKeymodel id三件套就能接上。你不需要改 OpenClaw 的源码只需要改配置文件里的 provider 段。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 两个都记一下后面配置要用。环境检查这一步别跳过。OpenClaw 对 Node.js 版本有硬性要求v22.19 及以上。低一个补丁号都可能触发Node.js v22.19 is required的报错。打开 PowerShell普通权限即可安装全局包时再提权依次执行node -v npm -v如果node -v输出的是 v22.18.0 或更低用 nvm 升级最省事nvm install 22 nvm use 22 nvm alias default 22升级完再node -v确认一次。这里有个坑如果你之前用旧版本 Node 装过 OpenClaw升级后一定要先卸载再重装否则脚本执行权限会残留问题。卸载和重装的命令在下一节。另外Windows 默认的 PowerShell 执行策略会拦截 npm 的脚本建议提前放开当前用户的策略Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned这一步是「必选」不然后面npm install -g可能静默失败。做完这些环境就算干净了可以进入安装环节。2. OpenClaw 全局安装与 npm 路径迁移到 D 盘安装本身只有一行命令但 Windows 上有个隐藏问题npm 全局包默认装在 C 盘用户目录下OpenClaw 加上依赖动辄几百 MBC 盘空间紧张的话很快就红了。所以我把 npm 的全局路径和缓存都迁到 D 盘这一步是可选的但强烈建议做。先建目录mkdir D:\OpenClaw\npm-global -Force mkdir D:\OpenClaw\npm-cache -Force然后改 npm 配置npm config set prefix D:\OpenClaw\npm-global npm config set cache D:\OpenClaw\npm-cache改完之后全局安装的包和命令都会落到 D 盘。注意改完 prefix 后你需要把D:\OpenClaw\npm-global加到系统 PATH 里否则openclaw命令找不到。在 PowerShell 里临时加当前会话有效$env:Path ;D:\OpenClaw\npm-global想永久生效就去「系统属性 → 环境变量 → 用户变量 Path」里加一条。这一步做完重新开一个 PowerShell 窗口让 PATH 生效。接下来以管理员身份打开 PowerShell右键「Windows PowerShell」→ 以管理员身份运行执行全局安装npm install -g openclawlatest正常的话会看到类似added 656 packages in 3m的输出。如果你之前装过旧版本先卸载再装并且要显式允许脚本执行否则某些原生依赖比如tree-sitter-bash、protobufjs不会编译npm uninstall -g openclaw npm install -g --allow-scriptsopenclaw,google/genai,protobufjs,tree-sitter-bash openclawlatest安装完成后验证openclaw --version能输出版本号就说明安装成功。如果报「无法将 openclaw 识别为 cmdlet」八成是 PATH 没配好回到上面检查D:\OpenClaw\npm-global是否在 PATH 里。还有一种情况是安装过程中卡在node-gyp编译这通常是缺少 Visual Studio Build Tools装一个「Desktop development with C」工作负载即可或者直接用--allow-scripts跳过不需要编译的可选依赖。装完之后先别急着配模型跑一次openclaw doctor它会自动检测配置问题并给出修复建议openclaw doctor这个命令会检查 Node 版本、配置文件完整性、网关端口占用等。如果它提示Runtime: not running那是正常的因为网关还没启动。到这里OpenClaw 本体就装好了接下来是最关键的 settings 配置。3. 把 settings 改到 TaoTokenopenclaw.json 完整配置片段OpenClaw 的核心配置在用户目录下的.openclaw\openclaw.json。用记事本打开notepad $env:USERPROFILE\.openclaw\openclaw.json如果文件不存在先跑一次openclaw onboard生成默认配置或者手动创建。下面是一份可以直接复制的完整配置把模型 provider 指向 TaoToken。注意baseUrl用https://taotoken.net/apiapiKey换成你在 TaoToken 控制台创建的 Keymodel id填你要用的模型{ models: { mode: merge, providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-YOUR_TAOTOKEN_KEY_HERE, api: openai-completions, models: [ { id: claude-sonnet-4-5, name: Claude Sonnet 4.5, contextWindow: 200000, maxTokens: 8192 } ] } } }, agents: { defaults: { model: { primary: taotoken/claude-sonnet-4-5 }, workspace: C:\\Users\\你的用户名\\.openclaw\\workspace } }, tools: { profile: full, exec: { host: gateway, security: full, ask: off } }, commands: { native: auto, nativeSkills: auto, restart: true, bash: true }, gateway: { port: 18789, mode: local, bind: loopback, auth: { mode: token, token: 自己设一个复杂字符串 } } }几个关键点解释一下。models.mode设为merge表示合并模式不会覆盖其他 provider。api字段必须是openai-completions因为 TaoToken 兼容 OpenAI 的 completions 接口。agents.defaults.model.primary的格式是provider名/model id这里就是taotoken/claude-sonnet-4-5两者必须对应上写错了会报model not found。workspace路径里的「你的用户名」要换成实际的 Windows 用户名比如C:\Users\Administrator\.openclaw\workspace。这个目录是 OpenClaw 读写文件的根目录文档整理任务生成的文件都会落在这里。gateway.auth.token是本地网关的鉴权 token随便设一个复杂字符串就行它只在本机 loopback 上生效不对外暴露。tools.exec.security设为full是让智能体能执行文件操作命令文档整理需要这个权限。改完保存重启网关让配置生效openclaw gateway restart然后检查状态openclaw gateway status必须看到Runtime: running和RPC probe: ok才算成功。如果RPC probe失败多半是端口 18789 被占用改gateway.port换个端口再重启。如果你用的是 Claude Code 或者 Cline 这类工具配置逻辑是一样的Base URL 填https://taotoken.net/apiKey 填 TaoToken 的 KeyModel ID 填claude-sonnet-4-5。三件套对齐任何兼容 OpenAI 接口的客户端都能接上。想快速验证模型通不通可以直接用模型对话页面发一条测试消息比在终端里调试快得多。4. 跑通一次飞书文档整理任务从配对到结果验证配置改好之后我们来跑一个真实任务把飞书里的一批文档整理成结构化摘要。这一步会用到 OpenClaw 的飞书渠道和 file-manager 技能。先安装技能商店和文件管理技能npm install -g clawhub npx clawhublatest install file-manager预期输出是✔ OK. Installed file-manager - C:\Users\你的用户名\.openclaw\workspace\skills\file-manager。验证技能装好了openclaw skills list应该能看到✔ ready │ file-manager这一行。接下来配对飞书机器人。在飞书开放平台创建一个应用权限里勾选im相关权限订阅方式选「长连接」然后发布。回到终端执行openclaw pairing list --channel feishu把飞书应用的 App ID 和 App Secret 填进去。如果给机器人发消息没回复检查网关是否在运行以及飞书应用是否发布了新版本。现在启动 OpenClaw 并打开 Web UIopenclaw dashboard浏览器会自动打开控制台。在对话框里输入任务指令比如读取 workspace 下 feishu-docs 目录里的所有 markdown 文件按主题分类生成一份 summary.md每个主题下列出文档标题和一句话摘要。OpenClaw 会调用 file-manager 技能读取文件再通过 TaoToken 的模型生成摘要最后写出summary.md。任务执行过程中终端会打印模型请求日志你能看到POST https://taotoken.net/api/v1/chat/completions这样的记录说明请求确实走了 TaoToken。验证结果打开C:\Users\你的用户名\.openclaw\workspace\summary.md如果内容是按主题分好类的摘要说明整条链路跑通了。如果文件是空的或者报错看下一节的排查表。这里补充一个实用技巧文档整理任务对上下文长度要求高如果文档很多建议在指令里加一句「分批处理每批不超过 5 个文件」避免单次请求超出模型的contextWindow。TaoToken 的模型上下文窗口在配置里设的是 200000一般够用但分批更稳。5. 常见报错对照401、local proxy failed、reading choices 怎么修跑不通的时候报错信息往往很模糊。下面是我踩过的几类真实报错和对应的修法。401 Unauthorized模型请求返回 401说明apiKey不对或者没生效。先确认openclaw.json里的apiKey是 TaoToken 控制台创建的 Key没有多余空格。然后确认baseUrl是https://taotoken.net/api不是首页地址。改完记得openclaw gateway restart配置不会热加载。如果还报 401去 TaoToken 控制台看这个 Key 是否被禁用或额度耗尽。local proxy failed这个报错通常出现在网关启动阶段意思是本地代理绑定失败。九成是端口 18789 被占用。用netstat -ano | findstr 18789找到占用进程要么杀掉要么在配置里把gateway.port改成 18790 之类。改完重启网关。reading choices 相关报错类似Cannot read properties of undefined (reading choices)这是模型返回体格式不符合预期。原因通常是api字段写错了比如写成了openai-responses而不是openai-completions。TaoToken 走的是 completions 接口api必须是openai-completions。另外确认model id在 TaoToken 的模型列表里真实存在写错模型名也会导致返回体异常。OAuth 相关报错如果你之前配过其他 provider 的 OAuth 登录切换 provider 后可能残留 token 冲突。删掉.openclaw目录下的auth缓存文件重新openclaw onboard走一遍配置流程。Node 版本报错Node.js v22.19 is required回到第 1 节用 nvm 升级升级后必须重装 OpenClaw因为旧版本的脚本权限绑定在旧 Node 上。技能未加载openclaw skills list里看不到 file-manager检查技能是否装在workspace\skills目录下以及commands.nativeSkills是否为auto。排查顺序建议先openclaw doctor自动检测再看网关状态openclaw gateway status最后看模型请求日志。大部分问题集中在配置文件的三个字段baseUrl、apiKey、api。把这三个对齐八成报错都能解决。6. 把文档整理变成日常TaoToken 接入后的稳定用法跑通一次之后你可以把文档整理做成日常任务。我的做法是在 workspace 下建一个feishu-docs目录每天把飞书导出的文档丢进去然后让 OpenClaw 批量处理。指令模板可以固定下来比如「读取 feishu-docs 下所有文件按项目分类生成日报」。模型选择上文档整理这类任务对推理要求中等但对上下文长度和稳定性要求高。TaoToken 的模型列表里可以按需切换配置里改model id就行不用动其他字段。想验证某个模型效果直接用模型对话页面测一条长文档摘要比在 OpenClaw 里反复跑任务快。长期做编码或 Agent 类任务的话可以考虑 Coding Plan额度和稳定性更适合高频调用。接入文档里有各客户端的配置示例Claude Code、Cline、Codex 的auth.json写法都有照着改 Base URL 和 Key 即可。最后提醒一句openclaw.json改完一定要重启网关配置不热加载。任务跑不通先看日志里的请求 URL确认走的是https://taotoken.net/api这一步能排除大半问题。