1. OpenClaw 2.7.9 是什么为什么要在本地跑 AI 智能体OpenClaw 2.7.9 是一款能在 Windows 和 macOS 上直接运行的本地桌面 AI 智能体程序。它和你在网页里用的聊天机器人最大的区别在于它能真正“动手”——读写本地文件、模拟键鼠操作、驱动浏览器、调用系统权限把一句自然语言指令拆成可执行的步骤然后在你自己的电脑上跑完。适合谁适合每天被重复桌面任务拖住的人比如整理下载文件夹、批量重命名、把数据填进表格、定时抓取网页信息这类活儿。我把它理解成一个“住在你电脑里的实习生”你说“把 D 盘下载文件夹按类型分好”它就去建文件夹、移动文件你说“打开记事本写一句话存到桌面”它就真的去点开记事本、敲字、保存。整个过程不需要你写 Python也不需要你手动装 Node.js 运行环境安装包里已经把依赖组件打包好了图形界面点几下就能跑起来。为什么强调“本地”因为很多自动化任务涉及你自己的文件、账号、内部资料把这些交给云端黑盒总让人不放心。OpenClaw 是开源项目源码可以在 GitHub 上核验任务执行发生在你本机数据不出本地。这一点对做财务、行政、运营的朋友尤其重要。不过本地智能体有个绕不开的问题它自己不带“大脑”。OpenClaw 负责“手脚”操作电脑真正理解你指令、规划步骤的推理能力需要接一个大模型通道。这就是为什么搭建流程里除了装软件还要配一个稳定的 API 通道。我实测下来用 TaoToken 做统一 Key 和 API 入口比较省事一个 Key 能切换不同模型不用在多个平台之间来回注册。下面从零开始把 Windows 和 macOS 两条路都走一遍。2. 搭建前的准备安装包获取与 TaoToken 通道配置先说安装包。OpenClaw 2.7.9 的安装包体积约 45.8MBWindows 和 macOS 是分开的两个包。下载时建议用浏览器自带下载或稳定的下载工具避免压缩包损坏导致解压不完整。下载完成后去桌面或“下载”文件夹找到压缩包。Windows 版本和 macOS 版本的获取入口不同按你的系统选对应那个。拿到压缩包后先别急着解压有一件事直接决定部署能不能成功临时关闭安全防护软件。包括 360 安全卫士、360 杀毒、腾讯电脑管家、火绒以及 Windows Defender 的实时防护。原因很直接——OpenClaw 具备文件读写、键鼠模拟、浏览器自动运行、系统权限调用这些能力行为特征和风险程序高度相似安全软件很容易误拦表现为文件被删、安装中途终止、程序打不开。它是开源项目你可以去 GitHub 看源码核验确认没问题后再关防护安装。接下来是 TaoToken 通道。OpenClaw 需要一个大模型 API 才能工作TaoToken 提供统一的 Key 和 API 地址省去多平台配置的麻烦。操作路径是先到官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册账号然后进控制台创建 API Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite API Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。创建好 Key 后复制保存后面填进 OpenClaw 配置里。这里有个关键点OpenClaw 的模型接入需要三件套——Base URL、API Key、Model ID。Base URL 填https://taotoken.net/api注意 API 地址不加 UTM 参数API Key 填你刚创建的那串Model ID 按你要用的模型填。这三样缺一不可很多人卡在“连不上”就是因为只填了 Key 没填 Base URL或者 Model ID 写错。想先验证模型通不通可以到模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 发一条测试消息确认 Key 有效再往下走。如果你后续要做长期编码或 Agent 类任务可以考虑 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到参数不确定时对着文档查最快。3. 可复制配置Windows 与 macOS 安装步骤 settings 片段这一节是全文最核心的部分我把 Windows 和 macOS 的完整流程拆开写每一步都能照着做。3.1 Windows 安装与路径规范解压工具优先用 WinRAR 或 7-Zip不建议用系统自带解压容易出现解压不完整、核心组件缺失。右键压缩包选择“解压至当前文件夹”会生成Openclaw-win文件夹。进入该文件夹双击带红色龙虾标识的Openclaw Windows 一键启动.exe。如果弹出 Windows SmartScreen 拦截窗口依次点“更多信息”→“仍要运行”继续。安装路径有硬性要求全程只能用英文字符不能出现中文、空格、特殊符号。推荐路径D:\OpenClaw或E:\AI\OpenClaw不合规的例子是D:\办公工具\OpenClaw、D:\AI小龙虾程序。不建议装到 C 盘系统盘。勾选用户协议和免责声明点按钮启动安装。点击后全程自动运行耗时 3 到 5 分钟期间不要关闭安装窗口。程序会自动完成检测本地系统环境、部署 Git/Node.js/Python 全套依赖、部署 OpenClaw 2.7.9 核心文件、安装浏览器自动化和键鼠模拟底层工具、生成.env配置文件、完成本地服务注册并生成桌面快捷方式。进度条到 100% 后自动弹出主界面。3.2 macOS 安装要点macOS 版本流程类似下载对应安装包后解压双击启动程序。首次打开可能提示“无法验证开发者”去“系统设置”→“隐私与安全性”里点“仍要打开”。同样建议把安装目录放在英文路径下比如/Users/你的用户名/OpenClaw。macOS 上如果开了第三方安全软件也先临时关闭。3.3 模型通道配置片段安装完成后OpenClaw 主界面右上角会显示 Gateway 状态。在设置里找到模型/渠道配置填入 TaoToken 三件套。如果你用的是配置文件方式可以参考下面这个 JSON 结构路径以实际安装目录为准Windows 通常在D:\OpenClaw\config\settings.jsonmacOS 在~/OpenClaw/config/settings.json{ model: { provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model_id: claude-sonnet-4-5, timeout: 120 }, gateway: { host: 127.0.0.1, port: 18789, auto_start: true }, automation: { allow_file_ops: true, allow_keyboard_mouse: true, allow_browser: true } }如果你更习惯 TOML 格式等价写法如下[model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model_id claude-sonnet-4-5 timeout 120 [gateway] host 127.0.0.1 port 18789 auto_start true注意base_url结尾不要多加/v1之类的后缀TaoToken 的 API 入口就是https://taotoken.net/api。model_id要和你实际调用的模型一致写错会报模型不存在。保存后重启 Gateway 服务让配置生效。4. 验证请求跑通第一个自动化任务与成功结果配置填好后怎么确认整条链路是通的分两步验证。第一步验证模型通道。在 OpenClaw 对话框里输入一句最简单的指令比如“你好请回复你的模型名称”。如果 Gateway 在线且模型配置正确几秒内会返回内容。如果这里就报错说明是 Key、Base URL 或 Model ID 的问题先别往下走。你也可以直接在模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 发消息确认 Key 本身有效。第二步验证自动化能力。部署完成后直接在输入框填自然语言指令工具会自动拆分执行步骤、操控电脑完成工作。新手可以复制下面三条指令快速体验整理 D 盘下载文件夹依据文件类型新建分类文件夹并完成文件归类打开记事本输入文字 OpenClaw 部署成功将文档保存至桌面统计本机各个磁盘剩余可用存储空间整理清晰信息展示我试过第一条执行过程是这样的OpenClaw 先扫描下载文件夹识别出文档、图片、压缩包、安装程序等类型然后新建对应文件夹逐个移动文件最后在对话框里返回一份归类报告列出每个文件夹移入了多少个文件。整个过程大概十几秒期间你能看到它“操作”的步骤日志。成功的结果是下载文件夹变整齐了分类文件夹出现在原目录下对话框有明确的完成反馈。主界面各分区也值得熟悉一下右上角是 Gateway 运行状态、服务重启按键、运行日志、Tokens 数据展示左侧面板是本地模型与第三方渠道切换、对话任务管理列表中间是对话交互区和自动化任务执行效果展示底部输入框用来下发指令。第一次启动会提示等待 Gateway 服务就绪加载底层资源需要 1 到 3 分钟属正常现象后续再开就快了。右上角显示“Gateway 在线”就代表整套部署全部完成。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节按真实报错来对照遇到问题直接查。401 Unauthorized。这是最常见的基本是 API Key 问题。检查三处Key 是否复制完整有没有漏字符或带空格、Key 是否已过期或被删、Base URL 是否填成了https://taotoken.net/api。如果 Key 没问题去 API Keys 页 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 重新生成一个再试。注意别把 Key 填到错误的字段里有些配置里api_key和token是两个不同项。local proxy failed / 本地代理失败。这个报错通常和网络环境有关。先确认本机网络正常连通然后检查是否开了系统代理类工具——如果有关掉再重启 OpenClaw。第一次打开软件需要联网完成依赖资源初始化网络不通就会卡在这里。另外检查 Gateway 端口 18789 是否被占用被占用就改配置里的端口号。Error reading choices / reading choices 报错。这多半是模型返回格式和 OpenClaw 预期不匹配常见于 Model ID 填错或用了不兼容的模型。确认model_id是 TaoToken 支持的模型并且provider填的是openai-compatible。如果换了模型还是报去接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 核对参数格式。OAuth 相关报错。如果你在配置里误开了需要 OAuth 的渠道或者填了需要授权登录的模型会报这个。OpenClaw 接 TaoToken 用的是 API Key 方式不需要 OAuth把配置里多余的授权项删掉即可。如果你用的是 Claude Code 类工具做接入注意区分 API Key 和 OAuth 两种模式别混用。Gateway 长时间离线。检查安装路径是否全程英文、无中文和特殊符号点界面右上角手动重启 Gateway完全关闭软件后右键“以管理员身份运行”重试。安装失败或启动无响应关闭所有安全防护删除已解压文件重新解压再运行。无法输入或发送无反馈等 Gateway 状态切到在线再操作持续存在就完整重装。6. 长期使用建议与 TaoToken 接入入口跑通之后几个实用习惯能让它更稳。安装盘优先选剩余空间 ≥5GB 的方便后续扩展功能日常启动直接点桌面快捷图标不用重复解压软件更新时下载新版安装包覆盖原安装目录即可升级。OpenClaw 设置页里还能配置飞书、微信等渠道实现远程下发自动化任务指令适合人不在电脑前但想让机器干活儿的场景。模型通道这块如果你只是偶尔用用按量调用就行如果每天都要跑大量自动化任务或做长期编码 AgentCoding Plan 会更划算入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。需要管理多个 Key 或查看用量去控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。接入过程中参数拿不准文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里有完整说明。想先低成本试模型效果模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 直接发消息就行。最后提醒一句OpenClaw 能操作你的文件和键鼠权限不小别拿它去跑来源不明的指令脚本。配置里的allow_file_ops、allow_keyboard_mouse、allow_browser三个开关按需开不用的时候关掉更稳妥。把 Base URL、API Key、Model ID 这三件套配对Gateway 显示在线第一条自动化指令跑出结果这套本地 AI 工具链就算真正立起来了。