1. 先搞清楚 OpenClaw 到底解决什么问题OpenClaw 是一个可以跑在本地或服务器上的智能服务框架核心能力是把大模型对话、插件加载、静态站点生成这几件事整合到一个客户端里。你可以把它理解成一个「本地 AI 工作台」装好之后不用每次开网页、不用来回切工具直接在本机就能调用模型、挂插件、生成 HTML5 静态页面。适合谁第一次接触本地 AI 服务部署的开发者、想在自己电脑上跑一套可控环境的同学、以及需要在内网服务器上搭一套对话建站流程的团队。但真正劝退新手的从来不是「OpenClaw 能做什么」而是「怎么把它装起来」。Windows 上杀毒软件拦一下、macOS 上弹个安全提示、Linux 上缺个依赖库任何一步卡住后面全停。这篇就按 Windows、macOS、Linux 三条线把从环境核对到一键安装脚本执行、再到服务验证的完整链路走一遍命令和配置都能直接复制。先说清楚一个前提OpenClaw 的安装包是分平台的Windows 是 exe 安装程序macOS 是 dmg 镜像Linux 是脚本依赖补齐。三者体积都在 45.8MB 左右下载后不要混用。下面每个平台我都会给出环境要求、安装步骤、配置文件骨架和验证动作你照着做就行。另外OpenClaw 本身负责本地服务编排如果你还想让它调用远端模型能力可以配合 TaoToken 这类 API 网关来用。TaoToken 官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。这个后面在配置环节会具体讲怎么填 Base URL 和 Key。2. 安装前环境核对与 OpenClaw 一键安装包获取这一步是整个部署里最容易被跳过、也最容易出问题的地方。我见过太多人直接双击安装包结果卡在「程序无法启动」或者「依赖缺失」回头才发现系统版本或内存不达标。所以先把三个平台的门槛列清楚。Windows 这边系统最低 Win10建议 2GB 以上可用运行内存。安装前务必先关掉杀毒软件和 Windows Defender 的实时防护否则安装程序解压运行环境时会被直接拦截表现就是进度条走到一半消失。macOS 要求不低于 10.15第一次打开 dmg 里的程序时系统会弹「无法验证开发者」这不是安装包坏了是权限没放行。Linux 支持 Ubuntu、CentOS 等主流发行版需要提前确认基础端口没有被占用并且有 sudo 权限来补依赖。安装包获取这块各平台资源如下直接复制到浏览器下载Windows 客户端安装包https://xiake.yun/api/download/package/18?promoCodeIV4E9B04A80CmacOS 客户端安装包https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80CLinux 用户下载后是一个压缩包解压出来包含一键启动脚本install.sh和依赖清单。下载完成后先核对文件大小正常在 45.8MB 上下如果只有几 KB说明下载被拦截了换网络重下。环境核对清单我整理成表格装之前对一遍平台最低系统版本内存要求安装前必做WindowsWin102GB 可用关闭杀毒/Defender 实时防护macOS10.152GB 可用隐私与安全性放行外来应用LinuxUbuntu/CentOS 主流版2GB 可用开放基础端口、准备 sudo这里有个细节Windows 关闭杀毒只是安装期间装完可以把防护开回来不影响 OpenClaw 运行。macOS 放行权限是在「系统设置 → 隐私与安全性」里找到被拦截的 OpenClaw 条目点「仍要打开」。Linux 的端口开放用firewall-cmd或ufw都行具体看发行版。如果你打算让 OpenClaw 调用远端模型建议在装之前就把 TaoToken 的 API Key 准备好这样装完直接进配置环节不用来回折腾。API Key 在 https://taotoken.net/api-keys 生成后面配置文件里会用到。3. 三平台可复制配置config.toml 与 settings.json 骨架装完客户端只是第一步真正让 OpenClaw 跑起来的是配置文件。OpenClaw 2.7.9 的配置分两块一块是服务级配置config.toml管端口、插件目录、日志另一块是模型接入配置settings.json管 Base URL、API Key、Model ID。这两块缺一个服务要么起不来要么起来了调不通模型。先看config.toml放在 OpenClaw 安装目录的config/下Windows 默认路径是C:\Program Files\OpenClaw\config\config.tomlmacOS 是/Applications/OpenClaw.app/Contents/config/config.tomlLinux 是/opt/openclaw/config/config.toml。骨架如下[server] host 127.0.0.1 port 8787 log_level info [plugins] enabled true plugin_dir ./plugins auto_load [html5-generator, chat-basic] [storage] data_dir ./data cache_size_mb 512端口 8787 是默认值如果被占用改成 8788 之类。auto_load里那两个插件是安装包自带的HTML5 静态站点生成就靠html5-generator。再看settings.json这个文件管模型接入路径和config.toml同级。如果你用 TaoToken 作为模型网关配置长这样{ provider: taotoken, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model_id: claude-3-5-sonnet, timeout_seconds: 60, max_retries: 3 }这里三件套必须齐全Base URL 填https://taotoken.net/apiAPI Key 从 https://taotoken.net/api-keys 拿Model ID 按你要用的模型填。少任何一个请求都会失败。我试过只填 Base URL 不填 Model ID结果客户端启动正常但一发消息就报reading choices错误排查了半天才发现是模型标识没写。Linux 用户注意配置文件权限要给对否则服务读不到sudo chown -R openclaw:openclaw /opt/openclaw/config sudo chmod 600 /opt/openclaw/config/settings.jsonsettings.json里有密钥权限设 600 是基本操作别用 777。如果你用的是 Claude Code 这类工具配合 OpenClaw配置逻辑类似Base URL 和 Key 的填法一致Model ID 换成对应模型即可。TaoToken 的接入文档在 https://taotoken.net/doc 有更细的字段说明遇到不确定的字段可以去对一下。4. 一键安装脚本执行与服务验证请求配置写好后进入执行阶段。三个平台的操作路径不同但目标一致让服务起来并且能正常响应请求。Windows 这边双击下载的 exe 安装程序按引导选安装路径勾选附加组件建议全勾HTML5 生成器就在里面等它自动解压部署运行环境。结束后桌面生成快捷图标双击启动。启动后不要急着关窗口先看日志区有没有server started on 127.0.0.1:8787这行。macOS 打开 dmg把 OpenClaw 拖进「应用程序」文件夹。第一次启动如果被拦去「系统设置 → 隐私与安全性」点「仍要打开」。然后从启动台打开等后台组件初始化日志出现监听端口即算启动成功。Linux 是命令行操作上传安装包到/opt/openclaw赋权后执行一键脚本cd /opt/openclaw chmod x install.sh sudo ./install.sh --auto-deps--auto-deps参数会让脚本自动补齐缺失依赖不用手动一条条装。脚本跑完启动服务sudo systemctl start openclaw sudo systemctl status openclaw看到active (running)就对了。服务起来后用 curl 验证一下接口通不通curl -X POST http://127.0.0.1:8787/v1/chat \ -H Content-Type: application/json \ -d {message: hello, model: claude-3-5-sonnet}正常返回是一段 JSON包含choices字段和模型回复内容。如果返回401说明 API Key 没填对或没生效如果返回local proxy failed多半是 Base URL 写错或者网络不通如果报reading choices检查 Model ID 是否和实际模型匹配。再验证一下 HTML5 静态站点生成功能进客户端内置功能页点「生成静态站点」选一个模板等它输出到data/site/目录。打开生成的index.html能正常渲染就说明插件加载没问题。整套验证下来三个动作服务状态 running、chat 接口返回 choices、静态站点能生成。三个都过部署就算完成。5. 部署常见报错排查401、local proxy failed、reading choices这一节把安装和验证阶段最容易撞上的几个报错拆开讲每个都给现象、原因、解法。401 Unauthorized。现象是 curl 或客户端发消息返回 401。原因基本是 API Key 问题要么没填要么填错要么settings.json权限不对导致服务读不到。解法是先确认settings.json里api_key字段是完整的然后检查文件权限Linux 下chmod 600Windows 下确认当前用户有读权限。改完重启服务。local proxy failed。这个报错通常出现在 Base URL 配置错误或网络不通时。先确认base_url填的是https://taotoken.net/api注意结尾不要多加斜杠。然后测试网络连通性curl -I https://taotoken.net/api返回 200 或 401 都说明网络通返回超时就是网络问题。如果公司内网有出口限制需要找网管开白名单。reading choices 报错。现象是服务能启动但一发消息就报解析choices字段失败。原因一般是 Model ID 和实际返回结构不匹配或者 Base URL 指向了一个不兼容 OpenAI 格式的端点。解法是核对model_id字段确保填的是网关支持的模型标识。TaoToken 支持的模型列表在 https://taotoken.net/doc 能查到对着填。OAuth 相关报错。如果你在配置里用了 OAuth 方式接入报错通常是 token 过期或回调地址不对。OpenClaw 的 OAuth 配置在settings.json的auth字段确认redirect_uri和实际监听端口一致。不确定的话直接用 API Key 方式接入更省事。Linux 依赖缺失。现象是install.sh跑到一半报command not found或library not found。解法是加--auto-deps参数重跑或者手动补sudo apt-get install -y libssl-dev libffi-devCentOS 用yum install对应包。客户端启动闪退。Windows 和 macOS 都可能遇到多半是内存不足或杀毒拦截。关掉后台占资源的程序Windows 确认 Defender 没在拦截 OpenClaw 进程macOS 确认隐私设置里放行了。排查顺序建议先看服务状态再看配置文件最后看网络。80% 的问题出在配置文件的 Key、URL、Model ID 这三项上。6. 后续接入与资源入口部署完成、验证通过之后OpenClaw 就是一个可用的本地智能服务了。接下来你可以按需扩展挂更多插件、接不同模型、把静态站点生成接到 CI 流程里。如果你还没配模型接入或者想换一个更稳定的网关TaoToken 的 API 入口是 https://taotoken.net/api Key 在 https://taotoken.net/api-keys 生成接入文档在 https://taotoken.net/doc 。模型对话调试可以用 https://taotoken.net/chat 长期跑编码和 Agent 任务的话Coding Plan 在 https://taotoken.net/coding-plan 有更合适的额度方案。配置里三件套再强调一遍Base URL 填https://taotoken.net/apiAPI Key 从控制台拿Model ID 按文档填。三个都对请求就通。最后留一个实用习惯每次改完settings.json或config.toml先重启服务再验证别在旧进程上测新配置不然会误判。日志文件在data/logs/下报错第一时间看日志比猜快得多。