1. 为什么要在本地跑 OpenClaw以及它到底解决什么问题OpenClaw 是一个能自主操控电脑的 AI 智能体圈内因为它的红色龙虾 Logo 叫它「小龙虾」部署过程也被戏称为「养虾」。它和普通聊天 AI 最大的区别在于普通对话模型只能给你文字回复而 OpenClaw 能读懂自然语言指令后自动拆解任务、启动软件、模拟鼠标键盘操作、整理本地文件、生成表格、做浏览器自动化检索。适合谁用适合需要批量处理本地文件、做重复性办公自动化、又对数据外发有顾虑的人。本地隐私运行是它最核心的卖点。你的文件路径、文档内容、操作记录都在自己机器上完成不需要把涉密材料上传到第三方。但这里有个现实问题智能体本身要「思考」思考就得调用大模型。如果模型通道也走本地对显存要求极高如果走云端 API又得管理一堆厂商的 Key。我实测下来比较省心的做法是OpenClaw 本地跑模型调用统一走 TaoToken 一个 Key这样既保留了本地操作的隐私边界又不用在 settings.json 里塞七八个不同厂商的密钥。这篇就按「从零安装 → settings.json 接入统一 Key → 启动验证 → 隐私边界检查」的顺序走一遍重点给出可以直接复制的 settings.json 骨架。全程不需要你懂编程命令和配置我都会写清楚。2. 安装前的环境准备与 TaoToken 统一 Key 的前置动作2.1 本地环境要求OpenClaw 对系统环境有一定要求先确认这几项项目要求说明操作系统Windows 10/11 64 位也支持 macOS本篇以 Windows 为主运行依赖Python / Node / Git / pnpm一键包会自带手动装则需补齐安装路径纯英文、无空格例如D:\OpenClaw禁止中文路径杀毒软件临时关闭实时防护模拟键鼠和读写文件容易被误判拦截磁盘空间建议预留 5GB 以上依赖和浏览器自动化组件占空间关于杀毒软件这一条我要多说一句OpenClaw 需要获取系统操控权限、模拟键盘鼠标、读写本地文件这些行为在杀毒软件眼里和风险程序高度相似很容易被拦截甚至直接删除核心文件导致 Gateway 离线。安装前把 360、腾讯电脑管家、火绒、Windows Defender 实时防护都关掉装完确认能跑起来再按需加白名单。2.2 拿到 TaoToken 统一 KeyTaoToken 的作用是把多家模型的调用通道收敛成一个 Key 和一个 API 地址这样 OpenClaw 的 settings.json 里只需要维护一份凭证换模型时改个模型名就行不用动 Key。操作路径打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录后进入控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 创建一个新 Key。创建后立刻复制保存页面关闭后通常不再完整显示。API 基础地址统一用https://taotoken.net/api这个地址不加 UTM 参数直接填进配置。注意Key 属于敏感凭证不要提交到 Git 仓库也不要贴到公开的配置文件里。本地 settings.json 建议放在用户目录下并做好备份。3. 安装 OpenClaw 并写出可复制的 settings.json 骨架3.1 安装与首次启动如果你用的是一键部署包解压后进入Openclaw-win文件夹双击启动程序按提示选择纯英文路径如D:\OpenClaw勾选许可协议后点开始安装。程序会自动检测并补齐 Python/Node/Git/pnpm 依赖、部署核心文件、安装浏览器自动化工具、生成配置文件和桌面快捷方式耗时大约 3 到 5 分钟。安装过程中不要关闭窗口中断了就得重来。第一次启动时 Gateway 需要初始化环境等 1 到 3 分钟属于正常现象之后启动就只要几秒。右上角显示「Gateway 在线」就说明部署完成了。3.2 settings.json 接入 TaoToken 的完整骨架OpenClaw 的模型通道配置集中在settings.json。下面这份骨架可以直接复制把sk-你的TaoToken密钥替换成你刚才创建的真实 Key 即可{ gateway: { host: 127.0.0.1, port: 18789, autoStart: true }, providers: { taotoken: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, models: [ { name: claude-sonnet-4-5, displayName: Claude Sonnet 4.5, contextWindow: 200000 }, { name: gpt-4o, displayName: GPT-4o, contextWindow: 128000 }, { name: deepseek-chat, displayName: DeepSeek Chat, contextWindow: 64000 } ] } }, agent: { defaultProvider: taotoken, defaultModel: claude-sonnet-4-5, maxSteps: 30, allowShell: true, allowFileWrite: true, workspaceDir: D:/OpenClaw/workspace }, privacy: { localOnly: true, telemetry: false, logLevel: warn, maskSensitiveInLog: true } }几个关键字段解释一下。providers.taotoken.type填openai-compatible因为 TaoToken 的 API 通道兼容 OpenAI 的请求格式这样 OpenClaw 不需要额外适配层。baseUrl就是https://taotoken.net/api注意结尾不要多加斜杠。models数组里列出你打算用的模型名具体可用模型以控制台模型列表为准改这里就能切换不用动 Key。agent.workspaceDir建议单独指定一个目录让智能体的文件操作都限制在这个工作区里避免它误动系统盘其他位置。privacy.localOnly设为 true 表示操作行为只在本地执行telemetry关掉可以避免额外的数据上报。3.3 配置文件的存放位置Windows 下一般放在%USERPROFILE%\.openclaw\settings.json也就是C:\Users\你的用户名\.openclaw\settings.json。如果一键包已经生成了配置文件直接用上面的内容覆盖对应字段保留原有的 gateway 端口等本地设置即可。改完保存重启 OpenClaw 让配置生效。4. 启动验证确认请求真的走通了4.1 用命令行做一次最小请求验证在配置生效后先用一条 curl 命令确认 TaoToken 通道本身是通的排除网络和 Key 的问题curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -d { model: claude-sonnet-4-5, messages: [ {role: user, content: 只回复两个字通了} ], max_tokens: 20 }如果返回的 JSON 里choices[0].message.content是「通了」说明 Key 和通道都没问题。如果返回 401检查 Key 是否复制完整返回 404检查 baseUrl 是否写成了https://taotoken.net/api而不是别的路径。4.2 在 OpenClaw 界面里跑一个真实任务命令行通了之后回到 OpenClaw 主界面在底部输入框下达一个简单指令比如帮我在 D:/OpenClaw/workspace 下新建一个 test 文件夹并在里面创建一个 hello.txt内容写「本地运行成功」观察右上角 Gateway 状态是否保持在线任务执行日志里是否出现模型调用记录。执行完成后去对应目录确认文件是否真的生成了。这一步能同时验证三件事模型通道可用、文件操作权限正常、工作区限制生效。4.3 验证模型切换把 settings.json 里agent.defaultModel改成deepseek-chat重启后再跑一个简单问答。如果也能正常返回说明多模型切换走的是同一个 Key配置骨架是通用的。这一步对后面按任务类型选模型很有用比如文件整理用便宜快的模型复杂推理再切到能力强的。5. 本篇常见错误排查Gateway 一直显示离线。先确认杀毒软件是否全部关闭安装路径是否为纯英文无空格。然后点界面右上角的重启 Gateway还不行就关掉程序重新启动。如果之前文件被隔离过去杀毒软件的隔离区恢复文件再重试。请求返回 401 Unauthorized。九成是 Key 的问题。检查 settings.json 里apiKey字段有没有多余空格Key 是否已经过期或在控制台被删除。重新去 API Keys 页面生成一个替换即可。返回 404 或 model not found。检查baseUrl是否为https://taotoken.net/api以及models数组里的模型名是否和控制台里可用的名称一致。模型名写错是最常见的原因。安装提示路径包含中文或特殊字符。改成D:\OpenClaw这种纯英文无空格路径重新安装。中文路径会导致部分依赖加载失败。第一次启动特别慢。属于正常现象Gateway 要初始化各类配置文件等 1 到 3 分钟。后续启动会快很多。如果超过 5 分钟还没起来检查是否有杀毒软件在后台扫描拦截。任务执行到一半卡住。大概率是maxSteps设得太小复杂任务步骤不够用。把它从 30 调到 50 再试。同时确认workspaceDir目录存在且有写入权限。6. 隐私边界检查与后续接入建议跑通之后建议做一次隐私边界自查。打开 settings.json确认privacy.localOnly为 true、telemetry为 false、maskSensitiveInLog为 true这样日志里不会明文记录敏感内容。再确认agent.workspaceDir指向的是一个独立目录智能体的文件读写被限制在里面不会波及系统盘其他位置。最后检查一下你的指令里有没有包含绝对路径指向涉密目录有的话改成工作区内的相对路径。模型通道这边统一 Key 的好处是凭证只有一份泄露风险面小换模型也不用重新配置。如果你后面要长期跑编码类或 Agent 类任务可以了解下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 按用量规划更划算。想先在网页里试试模型对话效果可以用模型对话 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 。接入过程中遇到配置问题接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里有各语言的完整示例Claude Code 相关接入可以参考 ClaudeCodeAnthropic https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。最后提醒一句本地隐私运行的价值在于数据不出机器但前提是配置里的隐私开关真的生效了。装完别急着跑复杂任务先按第 4 节的验证步骤走一遍确认通道通、权限对、边界清再放心交给它干活。