千呼万唤的 OpenClaw 全平台私有化部署指南终于来啦!
再也不用对着乱七八糟的教程踩坑了,我们把 Windows、Mac、Linux 三个系统的部署流程都跑了 N 遍,每一步都验证过,照着做绝对能跑通。而且专门解决了国内用户最头疼的网络问题,依赖下载慢、连不上的坑都帮你们踩完了。
不止是基础安装,这份指南连企业用得上的反向代理、多租户登录、大模型对接都写得明明白白。特别是 Kimi 的集成,我们做了深度优化,长上下文和工具调用用起来特别丝滑;当然 OpenAI 的支持也保留了,海外的朋友也能用。
真的,跟着步骤走,5 分钟就能在自己服务器上跑起来一个完全私有的 AI 智能体
安装前准备
大模型选择:官方推荐 Kimi、OpenAI、Anthropic 等等
系统要求:+/macOS 12+/主流 Linux 发行版(Ubuntu 22.04+ 推荐)
依赖条件:Node.js≥v22(一键脚本会自动安装)、npm / pnpm、Git(源码安装需要)
内存要求:≥2GB(推荐 4GB+)
网络环境:需联网下载安装包和依赖
权限要求:Windows 需 PowerShell 管理员权限,Linux / macOS 需 sudo 权限
第一步:安装 OpenClaw(新手入门首选,3 分钟完成)
这是官方最推荐的方式,自动检测并安装 Node.js 和所有依赖,无需手动配置环境
macOS / Linux
需要打开电脑终端软件,输入下面命令等待依赖和 openclaw 安装,主要依赖为 Node JS
curl -fsSL https://openclaw.ai/install.sh | bash

Windows(PowerShell 管理员模式)
以管理员身份打开 PowerShell(开始菜单搜索 PowerShell,右键选择 " 以管理员身份运行 ")
执行以下命令:
iwr -useb https://openclaw.ai/install.ps1 | iex
等待脚本自动完成 Node.js 检测、安装和 OpenClaw 配置
第二步:入门新手引导(配置模型)
入门向导会引导你完成以下核心设置:
第一步安装成功后显示下面画面,我们选择 Yes 并回车,表示知道风险。可以用键盘方向键左右切换 Yes 或 No

选择快速安装模式 QuickStart 并敲击回车确认

选择 Model,这里我们按需选择 OpenClaw 创始人推荐的 Moonshot AI(Kimi K2.5)/ Open AI/ Anthropic 作为基础模型。(本次选择的是 Kimi K2.5 进行演示)

Moonshot AI(Kimi K2.5)配置步骤中国用户,选择 Moonshot AI .cn 接入点

登录 Kimi 网站获取 API Key,访问 https://platform.moonshot.cn/console 点击登录

点击左侧的 API Key 管理,创建 API Key,复制弹出的密钥字符

回到 OpenClaw 继续配置
将复制的 API Key 贴入终端并敲击回车,然后选择 Moonshot / Kimi-K2.5 模型并敲击回车确认。

选择与 OpenClaw 聊天的载体,我们可以先跳过,使用 tui 进行体验。

选择网络搜索提供商,选择 Kimi

然后回到 Kimi 工作台,创建一个搜索专用的 API Key

复制 Key 并粘贴到 OpenClaw 配置步骤,敲击回车确认

选择你 OpenClaw 的技能和一些配置,选择 Yes

选择你想用的 Skill,按回车确认安装所有勾选的 Skills

Google Places 选择 No 跳过

Notion API 选择 No

Open AI 语言服务选择 No

Sag 服务选择 No

自动化 Hook 选择跳过

第三步:使用 TUI 快速体验,开始畅聊选择 TUI 并敲击回车

第四步:查看 OpenClaw 状态连续按两次 ctrl + c,先退出 TUI

输入 openclaw status 可查看当前状态

输入 openclaw gateway status 可查看 gateway 状态

输入 openclaw tui 可返回 tui 继续聊天

常见问题及解决方案:未找到 OpenClaw
如果安装成功但在终端中找不到 openclaw:
node -v # Node 是否已安装?
npm prefix -g #全局包位于何处?
echo“$PATH”#全局二进制目录是否在 PATH 中?
如果未包含在 PATH 中,请将其添加到 shell 启动文件(或)中:$(npm prefix -g)/bin$ PATH~/.zshrc~/.bashrc
export PATH="$(npm prefix -g)/bin:$ PATH"
然后打开一个新的终端。
结语
至此,OpenClaw 全链路本地化部署保姆级教程已全部更新完毕,从环境配置到服务上线的全流程教学形成完整闭环。
恭喜你成功完成 OpenClaw 从 0 到 1 的私有化部署,正式解锁这款开源社区顶流的智能体执行框架!你的专属 " 小龙虾 " 节点已通过全链路校验,服务正式上线运行,所有功能模块已全面开放调用,支持无限制自定义二次开发与全场景拓展。
愿这款原生开源的智能体工具,助你深挖 AI 落地的无限可能,在私有化智能体的探索征程中解锁更多全新价值。如果本教程对你有帮助,别忘了点赞收藏,也欢迎在评论区分享你的部署心得和遇到的问题~
























版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/250649.html