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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。你需要提前准备三样东西第一一个可用的 API Key。去控制台创建地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建完复制保存后面配置文件要用。第二确认你的网络能正常访问 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_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 选一个你需要的把对应的 Model ID 记下来。常见的有 claude-sonnet-4-20250514、gpt-4o 这类具体以页面显示为准。如果你打算长期跑编码类 Agent 任务可以了解 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它针对高频调用场景做了额度优化。注意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_urlhttps://taotoken.net/api固定值不加 UTMapi_key你的 Key控制台创建model_id模型 ID模型对话页面查看保存后重启 OpenClaw让配置生效。如果你用的是 Claude Code 类的编码场景配置方式类似Base URL 填 https://taotoken.net/api Key 和 Model ID 按上面同样方式填。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各客户端的详细配置示例。4. 验证请求确认 Gateway 在线与模型调用成功配置写完后不能只看界面显示「在线」就完事要实际发一条请求验证模型能通。4.1 本地服务健康检查Windows 打开 PowerShellmacOS 打开终端跑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_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 复制后直接粘贴到 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_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 额度更合适高频调用。模型对话页面可以随时切换模型地址 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 不同任务用不同模型比如文件整理用轻量模型代码生成用强模型。接入文档里有各客户端的完整配置示例包括 Claude Code 的接入方式地址 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。遇到配置问题先翻文档大部分报错都有对应说明。最后提醒一句OpenClaw 的权限开得比较大能读写文件、操控键鼠。建议先在测试目录里跑确认行为符合预期后再放开到工作目录。配置文件里的 permissions 字段可以按需关掉某一项比如不需要浏览器控制就把 browser_control 设为 false。
OpenClaw 完整部署流程：Windows 11 与 macOS 零基础一步步搭建
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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。你需要提前准备三样东西第一一个可用的 API Key。去控制台创建地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建完复制保存后面配置文件要用。第二确认你的网络能正常访问 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_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 选一个你需要的把对应的 Model ID 记下来。常见的有 claude-sonnet-4-20250514、gpt-4o 这类具体以页面显示为准。如果你打算长期跑编码类 Agent 任务可以了解 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它针对高频调用场景做了额度优化。注意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_urlhttps://taotoken.net/api固定值不加 UTMapi_key你的 Key控制台创建model_id模型 ID模型对话页面查看保存后重启 OpenClaw让配置生效。如果你用的是 Claude Code 类的编码场景配置方式类似Base URL 填 https://taotoken.net/api Key 和 Model ID 按上面同样方式填。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各客户端的详细配置示例。4. 验证请求确认 Gateway 在线与模型调用成功配置写完后不能只看界面显示「在线」就完事要实际发一条请求验证模型能通。4.1 本地服务健康检查Windows 打开 PowerShellmacOS 打开终端跑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_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 复制后直接粘贴到 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_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 额度更合适高频调用。模型对话页面可以随时切换模型地址 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 不同任务用不同模型比如文件整理用轻量模型代码生成用强模型。接入文档里有各客户端的完整配置示例包括 Claude Code 的接入方式地址 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。遇到配置问题先翻文档大部分报错都有对应说明。最后提醒一句OpenClaw 的权限开得比较大能读写文件、操控键鼠。建议先在测试目录里跑确认行为符合预期后再放开到工作目录。配置文件里的 permissions 字段可以按需关掉某一项比如不需要浏览器控制就把 browser_control 设为 false。