1. 为什么我想在本地跑一只 OpenClaw 龙虾OpenClaw 是一个让 AI 真正“动手操作”你电脑的开源 Agent 框架。它和普通对话工具最大的区别在于ChatGPT 这类工具只能给你建议而 OpenClaw 能自己打开浏览器、翻本地文件夹、批量改文件名、填表单把一串重复动作真正执行完。你只需要用自然语言说一句“把下载目录里的截图按日期归类”它就会自己规划步骤、调用工具、把活干完。它适合谁我觉得有三类人特别值得试一是每天要处理大量重复文件、报表、表单的运营和行政同学二是想研究 Agent 工具调用机制、Skills 编排的开发者三是像我这样想先低成本体验一把“AI 操作电脑”到底靠不靠谱的技术爱好者。这三类人有个共同点——都想先跑通再决定要不要投入。但现实里有个尴尬的门槛很多人卡在“要不要先申请 API Key”这一步。一听到要注册账号、绑卡、配 Key热情就凉了一半。我见过有人花 500 块找人上门装 OpenClaw其实安装本身十分钟就能搞定。这篇就聚焦一条零成本路径先用内置的免 Key 模型把 Agent 跑起来验证它能正常响应再通过 TaoToken 统一 Key/API 通道接管后续的模型调用。这样你既不用一开始就折腾 Key又能在需要更强模型时平滑切换。整篇我会按“环境准备 → 安装 → 设置 → Skills 配置 → 启动验证 → 排错 → 接入 TaoToken”的顺序走每一步都给可复制的命令和参数。你跟着敲十分钟内应该能看到龙虾动起来。2. Node 环境准备与 OpenClaw 安装前置检查OpenClaw 对运行环境的要求其实不复杂核心就一条Node v22 及以上。我试过在 Node 18 上跑安装脚本脚本会直接报版本不满足然后退出所以这一步别省。先确认你机器上的 Node 版本。打开终端Windows 用 PowerShellmacOS/Linux 用默认终端输入node -v如果输出是v22.x.x或更高直接跳到安装。如果低于 22 或者提示 command not found就需要先装或升级 Node。我推荐用 nvm 管理版本切换干净不会污染系统环境。macOS/Linux 装 nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash装完重开终端然后nvm install 22 nvm use 22 node -vWindows 用户可以用 nvm-windows或者直接去 Node 官网下 v22 的 LTS 安装包一路下一步即可。装完同样用node -v确认。这里有个我踩过的坑有些同学系统里同时装了多个 Nodenode -v显示 22但 npm 全局路径还指向旧版本导致后面openclaw命令找不到。保险起见再确认一下 npm 版本和全局路径npm -v npm config get prefixnpm -v建议 10 以上。npm config get prefix输出的目录要和你当前 Node 版本对应如果指向一个很老的路径说明环境变量没切干净重开终端或手动改 PATH。环境 OK 后正式安装 OpenClaw。官方首页给的命令是# macOS/Linux curl -fsSL https://openclaw.ai/install.sh | bash # Windows PowerShell powershell -c irm https://openclaw.ai/install.ps1 | iex运行后脚本会先检测环境包括 Node 版本、网络、磁盘空间然后开始下载依赖。这一步耐心等取决于网速一般两三分钟。安装完成后终端会提示你运行openclaw进入设置向导。如果提示 command not found先重开终端让 PATH 生效还不行就检查上一步的 npm prefix。注意安装脚本会往全局 npm 目录写东西如果你之前用 sudo 装过全局包可能会遇到权限报错。遇到 EACCES 时别急着加 sudo先按 npm 官方建议把全局目录改到用户目录下避免后续一堆权限问题。到这一步环境就算齐了。接下来进入设置向导这是决定龙虾“大脑”和“手脚”的关键环节。3. OpenClaw 设置向导模型、Skills 与网关配置在终端输入openclaw进入设置向导。整个过程是交互式的我用问答形式把每一步讲清楚。第一步是安全提示问你是否继续选 Yes。这是常规确认没有坑。第二步是 Onboarding 模式选 QuickStart。它会自动帮你配好网关端口 18789、绑定地址 127.0.0.1。这两个值后面排错会用到记一下端口 18789绑定本地回环。QuickStart 的好处是不用手动填一堆网络参数适合第一次跑通。第三步是选 AI 模型这是最关键的一步。模型相当于龙虾的大脑直接决定任务完成质量。向导里会列出几个可选模型其中阿里的千问Qwen支持登录认证不需要输入 API Key也不花钱。我们这篇主打零成本所以先选千问。选完后浏览器会自动打开认证页面登录一下即可回到终端选默认模型。如果你后面想换更强的模型可以打开 pinchbench.com 看排名。这个站点从任务成功率、速度、花费、每成功任务花费几个维度对比模型。任务成功率上 claude-sonnet-4.6 排第一但如果算“每成功任务花费”gpt-5-nano 更划算。我的建议是先用千问把流程跑通等确认 Agent 能正常干活再通过 TaoToken 接入你想要的模型这样切换成本最低。第四步是选通讯平台也就是你通过哪个软件和龙虾对话。这里先跳过跳过后 OpenClaw 会提供一个默认网页界面够用了。第五步是选搜索工具需要填 API Key先跳过。等真正需要联网搜索时再配。第六步是选 Skills。Skills 决定龙虾具备哪些能力可以跳过也可以先勾一个 clawhub。ClawHub 是 OpenClaw 的公共 Skills 注册中心装上能大幅扩展功能。但要注意公共注册中心里的 Skills 来源杂不排除有人塞恶意代码装之前最好看一眼来源和权限。这里我们用空格键勾选 clawhub然后下一步。接着是 Node 包管理器选择选默认的 npm 就行。最后是一些额外配置比如 GEMINI 的 API_KEY、NOTION 的 API_KEY 等一路跳过。这些是可选集成不影响核心功能。配置阶段如果要用配置文件方式固化可以参考下面这个结构路径按你实际安装目录调整通常是用户目录下的.openclaw{ gateway: { port: 18789, host: 127.0.0.1 }, model: { provider: qwen, modelId: qwen-default }, skills: { registry: clawhub, enabled: [clawhub] }, packageManager: npm }这个 JSON 只是示意字段结构实际字段名以你安装版本的向导生成为准。重点是三件套网关端口、模型 provider、Skills 注册中心。把这三样确认对后面启动就不会迷路。配置完成后向导会进入网关安装阶段耐心等它装完。装成功后浏览器会自动打开一个页面那就是你和龙虾对话的界面。4. 启动验证让龙虾执行第一个真实任务网关装完浏览器页面打开说明龙虾已经在线。这时候别急着关终端终端里跑着的是网关进程关了就断连。验证 Agent 是否正常响应最直接的办法是给它一个能观察结果的任务。我在对话框里输入的是查看下载目录有哪些文件发送后龙虾会先规划它需要调用文件系统工具定位下载目录列出内容。几秒后界面上会返回文件列表。如果这一步成功说明 Agent 的工具调用链路是通的。再试一个稍微复杂点的打开浏览器搜索 OpenClaw 教程它会自己启动浏览器、输入关键词、返回搜索结果页。你能看到浏览器被真实操作这就是 OpenClaw 和纯对话工具的本质区别。如果这两步都成功恭喜你已经有一只可用的龙虾了。如果失败别慌下一节专门讲常见报错。这里补充一个验证技巧在对话界面里Agent 每次调用工具都会打印中间步骤。你可以观察它“想了什么、调了什么工具、拿到什么结果”。这个中间过程是排查问题的关键——如果它规划对了但工具没执行多半是 Skills 没装或权限不够如果规划就错了那是模型能力问题可以考虑换模型。另外第一次跑任务时系统可能会弹权限确认比如“是否允许访问文件系统”。这是安全机制确认一次即可。如果你在无人值守场景跑要提前想好权限策略别把敏感目录暴露给 Agent。跑通之后你可以把常用任务存成固定指令比如“每天九点整理下载目录”。OpenClaw 支持定时任务这部分等基础跑顺了再折腾。5. 常见报错排查401、local proxy failed 与 OAuth 问题这一节把我遇到和收集到的典型报错列出来对照着查。报错一401 Unauthorized。这个通常出现在你切换到需要 Key 的模型之后。原因就一个Key 没配、配错、或者过期。排查顺序是先确认当前模型 provider 是不是需要 Key 的那个再检查 Key 有没有多余空格最后确认 Key 对应的账号额度是否正常。如果你是用 TaoToken 统一通道检查 Base URL 和 Key 是否配对Base URL 用https://taotoken.net/api不要带多余路径。报错二local proxy failed。这个报错一般和网关端口冲突或绑定地址有关。QuickStart 默认端口 18789如果你机器上这个端口被别的程序占了网关就起不来。排查方法# macOS/Linux lsof -i :18789 # Windows netstat -ano | findstr 18789如果发现被占用要么杀掉占用进程要么改 OpenClaw 的网关端口。改端口在配置文件里改gateway.port然后重启。报错三reading choices 相关错误。这类报错通常出现在模型返回格式不符合预期时比如你接了一个兼容 OpenAI 协议的第三方通道但返回结构有差异。排查时先看完整报错堆栈确认是请求阶段还是解析阶段。如果是解析阶段多半是模型 ID 填错或者通道不支持该模型的返回格式。换成标准模型 ID 再试。报错四OAuth 认证失败。选千问时会走浏览器 OAuth。如果浏览器没自动弹出手动复制终端里的链接到浏览器打开。认证完成后如果终端没反应回车一下刷新状态。如果反复失败检查系统时间是否准确OAuth 对时间偏差敏感。报错五Skills 装了但不生效。检查 Skills 是否在配置里 enabled以及是否需要重启网关。有些 Skills 依赖额外的系统权限比如浏览器自动化需要浏览器驱动缺了会静默失败。排查通用思路先看终端日志再看对话界面的中间步骤最后看配置文件。三层对照基本能定位。如果要用 TaoToken 接入记住三件套必须齐全Base URL、Key、Model ID。少一个都会报错。6. 用 TaoToken 统一 Key/API 通道接管模型调用前面我们用千问免 Key 跑通了流程但当你需要更强模型、或者想在多个模型间切换时一个个配 Key 很烦。这时候可以用 TaoToken 做统一通道一个 Key 管多个模型。接入方式很简单核心是把 OpenClaw 的模型 provider 指向 TaoToken 的 API 地址然后填上你的 Key 和想用的 Model ID。Base URL 用https://taotoken.net/api注意不要加多余路径。配置片段参考字段名以你版本为准{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 你的_TaoToken_Key, modelId: 你想用的模型ID } }三件套对照表配置项值说明Base URLhttps://taotoken.net/api统一 API 入口API Key在控制台生成一个 Key 管多模型Model ID按需填写决定实际调用哪个模型Key 在控制台的 API Keys 页面生成生成后妥善保存页面刷新后不再完整显示。模型 ID 可以参考接入文档里的模型列表填你需要的那个。配好后重启网关再发一条测试指令比如“查看当前目录”确认 Agent 正常响应。如果报 401回到上一节排查 Key如果报模型不存在检查 Model ID 拼写。需要说明的是TaoToken 在这里的角色是统一调用通道不是替代 OpenClaw 本身。OpenClaw 负责 Agent 编排和工具调用TaoToken 负责把模型请求统一转发。两者配合你就能在一个入口下灵活切换模型而不用每次改一堆配置。如果你只是长期做编码类任务可以关注 Coding Plan如果只是想验证某个模型效果直接用模型对话页面试接入和排障过程中需要的 Key 和文档分别在 API Keys 和接入文档里。按你的实际场景选入口别一上来就全配一遍。最后给个实用建议把配置文件备份一份改坏了能快速回滚。Agent 这类工具配置项多来回试错很正常有备份心里不慌。