【开源版】OpenClaw一键部署中文指南,V5.9更新2026.5.9支持windows、macOS系统配置本地大模型教程
上周帮一个朋友装 OpenClaw,装完之后他问了我一句话:"这东西能装到我的 Mac 上吗?"我说能啊,然后发现 Mac 版和 Windows 版的安装流程其实差不多,就是几个小细节不一样。这篇把两个平台都写一下,Windows 为主,macOS 为辅。顺便聊一下我对 OpenClaw 这个项目的看法,不是技术教程的那种,就是随笔聊聊。
安装包用中文整合版(https://top.wokk.cn/),277M,Win10/11、macOS Apple 芯片、macOS Intel 芯片三个版本都有。

Windows 安装(大部分人用这个)
Windows 安装其实没什么好说的,就是几个注意点。
第一步,关安全软件。我知道有人觉得关杀毒不习惯,但这一步真的省不了。OpenClaw 运行时会操作文件、控制浏览器、模拟键鼠,这些行为在任何杀毒软件眼里都是"可疑操作"。不关的话,不是文件被删就是 Gateway 启动失败。
第二步,解压。用 WinRAR 或者 7-Zip,不要用系统自带的。Windows 自带解压工具处理 DLL 文件权限的时候偶尔会出问题,别省这一步。
第三步,安装路径。纯英文。这个我说了不下一百遍了,但还是有人踩坑。
# 对
D:\OpenClaw
E:\AI\OpenClaw
# 错(别问我怎么知道的)
D:\我的软件\OpenClaw
C:\Users\张三\OpenClaw
第四步,等 Gateway 上线。第一次启动要 1-3 分钟初始化依赖,右上角显示"Gateway 在线"就好了。
macOS 安装(给朋友装的)
Mac 版跟 Windows 版差不多,但有几个不一样的地方。
Mac 上没有 360 之类的杀毒软件,但 macOS 有自己的 Gatekeeper 安全机制。双击 OpenClaw.app 的时候如果提示"无法打开,因为 Apple 无法检查它是否包含恶意软件",去"系统设置 -> 隐私与安全性",点"仍要打开"。
Mac 上的安装路径问题跟 Windows 一样:不能有中文。不过 Mac 用户一般不会因为这个问题踩坑,因为 Mac 的文件名默认就是英文的。
还有一个 Mac 特有的坑:如果用的是 Apple Silicon(M1/M2/M3/M4 芯片),Ollama 的模型跑起来会很快,比 Intel 芯片快很多。这是因为 Apple 的统一内存架构,CPU 和 GPU 共享内存,减少了数据传输的延迟。
# 确认 Mac 芯片类型
terminal $ uname -m
# arm64 = Apple Silicon
# x86_64 = Intel
本地大模型配置
这部分两个平台是一样的。用 Ollama 管理本地模型。
# 安装 Ollama
# macOS
curl -fsSL https://ollama.com/install.sh | sh
# Windows
# 去 https://ollama.com 下载安装包,双击安装
# 拉取模型
ollama pull qwen2.5:7b
# 或者
ollama pull deepseek-r1:7b
# 查看已安装
ollama list
拉完之后在 OpenClaw 里配置:
# OpenClaw -> 设置 -> 模型配置
API 提供商: OpenAI Compatible
API URL: http://localhost:11434
Model Name: qwen2.5:7b
# 注意:Model Name 要跟 Ollama 里的名字完全一致
点测试,看到模型列表就说明成功了。这个配置在 Windows 和 macOS 上完全一样,不需要区分平台。

聊聊 OpenClaw 这个项目
其实我一直觉得 OpenClaw 这个名字起得挺好的。最早叫 Clawdbot,后来改过 Moltbot,最后定名 OpenClaw。每次改名都有原因,但 OpenClaw 这个名字确实最直观——open source 的 claw(爪子),像一个灵活的爪子,帮你抓取信息、操作文件、执行任务。
有人说本地 AI 助手不如云端的好用。这个说法有一定道理,但不完全对。本地 AI 的优势不在于"更强",而在于"更安全"和"更自由"。云端 AI 确实更强,但你的数据要传到别人的服务器上。本地 AI 虽然能力可能差一点,但所有数据都在自己的电脑上,不会泄露。对于一些对隐私有要求的场景,这个优势是决定性的。
另外,本地 AI 还有个好处:不用联网也能用。出门在外、网络不好的时候,云端 AI 直接罢工,但本地模型照样跑。这个场景看起来不常见,但对于经常出差的人来说其实挺实用的。
当然,我不是说本地 AI 一定比云端好。各有各的适用场景。我的建议是:本地+云端一起用。敏感操作用本地模型,日常问答用云端 API。
几个容易踩的坑
说了这么多,再强调一下最容易被踩的三个坑:
第一,安装路径带中文。这个问题占了我帮别人装 OpenClaw 时遇到的问题的 40%。真的,路径用纯英文,不要偷懒。
第二,安全软件没关彻底。关主界面没用,后台进程还在跑。去任务管理器里确认一下,360/火绒/Defender 相关进程有没有残留。
第三,Model Name 漏了后缀。Ollama 里的模型名是 qwen2.5:7b,不是 qwen2.5。漏了冒号后面的数字,OpenClaw 就找不到模型。
写在最后
这篇写得很随意,不像正经教程那样结构化。但我觉得这样反而更真实——装 OpenClaw 本来就不需要什么复杂的步骤,就是解压、安装、配置,三个步骤搞定。剩下的就是跑通之后慢慢探索它的各种功能了。
如果这篇对你有帮助,点个赞。有问题评论区交流。https://top.wokk.cn/ 的文档更详细,可以去看看。
对了,差点忘了说:OpenClaw 的 skills 技能系统也挺有意思的,有空可以研究一下,装个天气查询、热点搜索之类的,用起来很方便。这个以后单独写一篇文章聊。
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐



所有评论(0)