1. 先搞清楚 OpenClaw 到底装了什么，为什么零基础也能跑通
OpenClaw 是一个本地运行的 AI 自动化智能体，图标是只小龙虾，社区里管安装叫「养虾」。它能做的事很具体：自动整理文件夹、批量重命名文档、操控浏览器抓取页面内容、模拟键鼠完成重复点击。所有推理和文件读写都在你自己机器上完成，不往云端传数据，这也是它在 GitHub 上拿到 28 万星标的核心原因。
适合谁用？三类人最合适：一是每天要处理大量重复文件操作的办公族，二是想入门 AI Agent 但不想碰复杂环境配置的开发者，三是需要离线环境跑自动化任务、对数据隐私有硬要求的用户。你不需要会 Python，不需要提前装 Node.js，安装包已经把运行环境和依赖库全部打包好了。
但零基础部署 OpenClaw 最容易卡在三个地方：Windows 11 的 Defender 实时防护会把安装程序当可疑行为拦截；解压路径里带中文或空格会导致服务启动失败；SmartScreen 弹窗让很多人以为程序有毒直接删掉。这篇就按 Windows 11 和 macOS 两条线，从下载到验证服务在线，一步步走完。
我试过在一台全新 Win11 和一台 M2 MacBook 上各装一遍，下面把可复制的命令、配置片段和验证动作都列出来。你跟着做，10 分钟内能跑通。
2. 部署前的环境准备与 TaoToken 接入前置
OpenClaw 本身是本地智能体框架，但它的 AI 推理能力需要接一个大模型服务。你可以把它理解成：OpenClaw 是「手脚」，负责操控电脑；模型服务是「大脑」，负责理解你的指令。本地跑通 OpenClaw 之后，你需要给它配一个模型入口，否则它只能执行固定脚本，没法理解自然语言。
这里用 TaoToken 作为模型接入层。它的作用是提供统一的 API 入口，让你在 OpenClaw 的配置文件里填一个 Base URL 和一个 Key，就能调用模型对话能力。官网地址是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 端点是 https://taotoken.net/api 。
你需要提前准备三样东西：
第一，一个可用的 API Key。去控制台创建，地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，创建完复制保存，后面配置文件要用。
第二，确认你的网络能正常访问 API 端点。在终端里跑一条 curl 测试：
curl -I https://taotoken.net/api返回 200 或 401 都说明网络通，401 只是没带 Key，正常。
第三，确认系统版本。Windows 11 需要 22H2 及以上，macOS 需要 12 Monterey 及以上。低于这个版本，安装包里的依赖库可能不兼容。
关于模型选择，OpenClaw 的配置文件里需要填 Model ID。你可以先去模型对话页面看看有哪些可用模型，地址是 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite ，选一个你需要的，把对应的 Model ID 记下来。常见的有 claude-sonnet-4-20250514、gpt-4o 这类，具体以页面显示为准。
如果你打算长期跑编码类 Agent 任务，可以了解 Coding Plan，地址是 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，它针对高频调用场景做了额度优化。
注意：OpenClaw 需要键鼠模拟和文件读写权限，Windows Defender 和 macOS 的隐私与安全性设置会拦截这些系统调用。这不是程序有问题，是它的运行特征决定的。安装前临时关闭实时防护，装完再加回白名单。
3. 可复制配置：Windows 11 与 macOS 的安装与 settings 片段
这一节是核心操作部分，两条系统线分开写，你按自己的系统跟做。
3.1 Windows 11 安装步骤
先下载安装包。Windows 版本是 v2.7.9，体积约 45.7MB，下载后得到 zip 压缩包。不要用 Win11 自带的解压工具，它容易出权限问题。用 7-Zip 或 WinRAR，右键选「解压到当前文件夹」，解压后生成Openclaw-win文件夹。
校验标准：文件夹里有一个红色龙虾图标的Openclaw Windows一键启动.exe，说明解压完整。
双击这个 exe，会弹出「Windows 已保护你的电脑」SmartScreen 提示。点「更多信息」，再点「仍要运行」。这是系统对无数字签名应用的常规提醒，不是病毒。
进入安装引导界面后，点「开始使用」，跳到路径配置页。这里有个硬性规则：安装目录必须纯英文，不能有中文、空格、特殊符号。
推荐路径：
D:\OpenClaw E:\AI\OpenClaw禁止路径：
D:\软件\OpenClaw D:\小龙虾 C:\Program Files\OpenClaw选好路径，勾选用户协议，点「开始安装」。程序会自动执行：检测系统环境 → 安装依赖组件 → 部署核心服务 → 配置运行权限 → 生成桌面快捷方式。等待 3 到 5 分钟，别关窗口。
安装完成后，主界面右上角显示「Gateway 在线」，说明本地服务跑起来了。
3.2 macOS 安装步骤
macOS 版本同样是 v2.7.9。下载 zip 后，用系统自带的归档实用工具解压，或者用 Keka。解压后得到Openclaw-mac文件夹。
首次打开会提示「无法验证开发者」，去「系统设置 → 隐私与安全性」，在「安全性」区域点「仍要打开」。然后按引导完成路径配置，macOS 路径同样建议纯英文，比如/Users/你的用户名/OpenClaw。
3.3 接入模型服务的配置文件
OpenClaw 跑起来后，需要配模型入口。找到安装目录下的config文件夹，里面有个settings.json。用文本编辑器打开，填入以下内容：
{ "model_provider": { "base_url": "https://taotoken.net/api", "api_key": "你的API Key", "model_id": "claude-sonnet-4-20250514" }, "gateway": { "port": 8765, "auto_start": true }, "permissions": { "file_access": true, "browser_control": true, "keyboard_mouse": true } }三个关键字段对照：
| 字段 | 填什么 | 从哪拿 |
|---|---|---|
| base_url | https://taotoken.net/api | 固定值，不加 UTM |
| api_key | 你的 Key | 控制台创建 |
| model_id | 模型 ID | 模型对话页面查看 |
保存后重启 OpenClaw，让配置生效。
如果你用的是 Claude Code 类的编码场景，配置方式类似，Base URL 填 https://taotoken.net/api ，Key 和 Model ID 按上面同样方式填。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面有各客户端的详细配置示例。
4. 验证请求：确认 Gateway 在线与模型调用成功
配置写完后，不能只看界面显示「在线」就完事，要实际发一条请求验证模型能通。
4.1 本地服务健康检查
Windows 打开 PowerShell，macOS 打开终端，跑：
curl http://127.0.0.1:8765/health返回{"status":"ok","gateway":"online"}说明本地服务正常。
4.2 模型调用验证
在 OpenClaw 主界面的指令输入框里，输入一条简单指令：
帮我列出当前桌面上的所有文件，按类型分类如果模型配置正确，它会返回桌面文件列表并给出分类建议。如果返回报错，看下一节的排查。
你也可以直接用 curl 测模型端点：
curl https://taotoken.net/api/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer 你的API Key" \ -d '{ "model": "claude-sonnet-4-20250514", "messages": [{"role": "user", "content": "回复ok"}] }'返回里有choices字段和内容，说明 Key 和模型都正常。
4.3 成功结果长什么样
界面右上角「Gateway 在线」绿色常亮，指令输入后 2 到 5 秒内返回结果，文件操作类指令能实际改动本地文件。这三条都满足，部署就算完整跑通了。
5. 本篇常见错排查：401、local proxy failed、reading choices 报错对照
这一节列真实会遇到的报错和对应处理。
报错一：401 Unauthorized
现象：模型调用返回 401，界面提示认证失败。
原因：API Key 填错、过期，或者复制时带了空格。
处理：去控制台重新创建一个 Key，地址 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite ，复制后直接粘贴到 settings.json 的 api_key 字段，注意不要带首尾空格。保存后重启 OpenClaw。
报错二：local proxy failed
现象：界面提示本地代理失败，Gateway 显示离线。
原因：端口 8765 被占用，或者安装路径含中文导致服务启动异常。
处理：先检查路径是否纯英文。然后换端口，把 settings.json 里的 port 改成 8766 或 8767，重启。如果还不行，用管理员权限运行启动程序。
报错三：reading choices 报错
现象：返回 JSON 解析失败，提示 reading 'choices' 或类似字段读取错误。
原因：模型 ID 填错，或者 API 返回了非预期格式。
处理：确认 model_id 和模型对话页面显示的一致。用上面的 curl 命令单独测模型端点，看返回结构里有没有 choices 字段。如果没有，说明模型 ID 不对或该模型未开通。
报错四：OAuth 相关报错
现象：提示 OAuth token 无效或授权失败。
原因：如果你之前配过其他客户端的 OAuth 凭证，可能冲突了。
处理：清掉旧的凭证缓存，重新用 API Key 方式配置。OpenClaw 用 Base URL + Key + Model ID 三件套就够了，不需要 OAuth 流程。
报错五：安装包被杀毒软件删除
现象：解压后 exe 文件消失，或安装中途被拦截。
处理：临时关闭 Defender 实时防护和第三方安全软件，重新解压，从头安装。装完后把 OpenClaw 安装目录加到白名单。
报错六：首次启动加载慢
现象：双击后等很久没反应。
原因：首次运行要初始化组件和依赖库。
处理：等 1 到 3 分钟，别重复双击。如果超过 5 分钟还没反应，检查路径是否纯英文，然后以管理员身份重新启动。
6. 跑通之后：把 OpenClaw 接进日常自动化流程
本地服务在线、模型调用通了之后，你可以开始用自然语言下指令。常用的几条：
帮我整理 D 盘下载文件夹内全部图片文件，按日期建子文件夹归档 打开浏览器检索 AI 智能体行业趋势，结果整理成表格保存到桌面 批量对桌面全部文件按扩展名分类归档 扫描本机冗余临时文件并列出可清理项这些指令 OpenClaw 会拆解成文件操作和浏览器操作步骤，逐步执行。你可以在界面上看到每一步的执行日志。
如果你要长期跑编码类任务，比如让 OpenClaw 自动改代码、跑测试、提交 git，建议走 Coding Plan，地址 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，额度更合适高频调用。
模型对话页面可以随时切换模型，地址 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite ，不同任务用不同模型，比如文件整理用轻量模型，代码生成用强模型。
接入文档里有各客户端的完整配置示例，包括 Claude Code 的接入方式，地址 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。遇到配置问题先翻文档，大部分报错都有对应说明。
最后提醒一句：OpenClaw 的权限开得比较大，能读写文件、操控键鼠。建议先在测试目录里跑，确认行为符合预期后再放开到工作目录。配置文件里的 permissions 字段可以按需关掉某一项，比如不需要浏览器控制就把 browser_control 设为 false。