位置：AI门户网
> AI应用 > AI智能体 > OpenClaw安装自营完全攻略：自己动手，丰衣足食
你是不是也刷到过那些号称“保姆级”的OpenClaw安装教程，但跟着操作几步后，要么卡在奇怪的报错上，要么感觉云里雾里，最后不得不去找人花钱“代装”？说实话，这感觉挺憋屈的。OpenClaw（大家爱叫它“小龙虾”）本身是个强大的开源AI代理工具，能把繁琐的电脑操作自动化，但第一步“安装”就劝退了很多人。今天这篇长文，咱们不整虚的，就踏踏实实地聊如何实现OpenClaw的“自营”安装——也就是完全由你自己掌控，在自己的电脑或服务器上完成部署。这不仅是为了省下那几百块的代装费，更是为了数据安全、个性化配置和真正理解你手里的工具。放心，我会尽量用大白话，把每个环节掰开揉碎了讲。
在动手之前，咱们先得想明白，费这个劲自己装，图啥？简单说，三大优势无可替代：
1.数据绝对安全：所有操作记录、文件处理都在你自己的设备上进行，无需经过第三方服务器。这意味着你的隐私、工作文档、敏感信息都牢牢锁在自己手里。对于有保密要求的场景，这是刚性需求。
2.配置完全自由：自营安装意味着你可以自由选择对接的AI大模型（是GPT、Claude还是国产的DeepSeek、GLM），可以随意调整技能（Skills）组合，端口、运行模式都由你定。这就像自己装修房子，每个细节都能按喜好来。
3.深度理解与后期维护：自己走通一遍安装流程，你会对OpenClaw的运行逻辑、依赖环境有更深刻的理解。以后出了小问题，你大概率能自己排查解决，而不是只能干等着“售后”。
明确了目标，咱们就撸起袖子开干。整个流程可以概括为：环境准备 → 核心安装 → 初始化配置 → 连接验证。我会以最通用的方式（兼顾Windows、macOS和Linux）为主线，并特别指出Windows下的注意事项。
很多安装失败，其实在第一步就埋下了种子。环境准备是关键，请务必逐项核对。
1. 操作系统确认
首先，确保你的系统是64位的。32位系统基本无法运行。Windows用户需是Win10或更高版本（Win11更佳）；macOS建议12以上；Linux则主流的Ubuntu 22.04/24.04等都没问题。
2. Node.js——最核心的依赖
OpenClaw是跑在Node.js环境下的，这是它的“发动机”。版本要求很严格：必须是Node.js v22.0.0或更高版本，推荐使用v22 LTS或v24。很多旧教程说v18也行，但现在基本都会报错。
*检查现有版本：打开你的终端（Windows用PowerShell或CMD，macOS/Linux用Terminal），输入 `node -v` 并回车。如果显示版本号符合要求，恭喜，这步跳过。
*安装/升级Node.js：如果没安装或版本太低，请直接访问Node.js官网（https://nodejs.org/zh-cn/download）下载LTS版本安装包。安装时一路“Next”即可，但安装路径请避免中文和空格，比如不要装在“Program Files”或“我的文档”里，可以简单放在 `D:"
odejs` 这样的路径下。
3. 终端权限与网络
*权限：在Windows上进行安装操作时，务必使用“以管理员身份运行”的PowerShell。否则在安装全局包或执行脚本时，会频繁遇到权限拒绝的错误。
*网络：安装过程需要从npm仓库或GitHub下载大量依赖包。请确保网络通畅，能稳定访问外网。如果身处内网或网络环境特殊，可能需要提前配置代理。
环境搞定，现在进入核心安装环节。主要有三种方法，你可以根据自身情况选择。
方法一：npm全局安装（最推荐、最通用）
这是官方最推荐的方式，适合大多数用户，步骤清晰可控。
1. 打开管理员权限的终端（PowerShell或系统终端）。
2. 输入以下命令并回车：
```bash
npm install -g openclaw@latest
```
这个命令会从npm官方仓库下载并安装最新版的OpenClaw。如果网络较慢，可以使用国内镜像加速，命令替换为：
```bash
npm install -g openclaw --registry=https://registry.npmmirror.com
```
3. 耐心等待安装完成，命令行会滚动一堆日志。
4.验证安装：安装完成后，输入 `openclaw --version` 并回车。如果成功显示出版本号（如2026.1.29），那么核心程序就安装成功了。
方法二：官方一键安装脚本（最适合Windows小白）
如果你觉得命令行操作有点发怵，Windows用户可以直接使用官方提供的一键脚本。这个脚本会自动帮你处理很多环境问题，比如检测并安装Node.js。
1. 以管理员身份打开Windows PowerShell。
2. 可能需要先设置执行策略，输入并回车：
```powershell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```
出现提示时，输入 `A` 并回车（全部允许）。
3. 执行一键安装脚本：
```powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
```
脚本会自动运行，你只需根据提示操作即可。
方法三：Docker安装（最适合追求隔离和快速部署）
如果你熟悉Docker，或者希望在服务器上部署，这是最干净、隔离性最好的方式。
1. 确保你的系统已安装Docker并已启动。
2. 在终端中执行一条命令即可拉取并运行：
```bash
docker run -d --name openclaw -p 18789:18789 -v ~/.openclaw:/root/.openclaw openclaw/openclaw:latest
```
这条命令会下载最新镜像，并将容器的18789端口映射到宿主机，同时持久化配置数据。
为了更直观地对比，可以参考下表：
| 安装方法 | 优点 | 缺点 | 推荐人群 |
|---|---|---|---|
| :--- | :--- | :--- | :--- |
| npm全局安装 | 官方推荐，流程标准，后续升级管理方便 | 依赖本地Node.js环境，需自行解决网络问题 | 大多数有一定命令行基础的用户 |
| 一键脚本(Windows) | 自动化程度高，减少环境配置麻烦 | 仅限Windows，脚本可能因网络或系统差异失败 | Windows新手用户，希望快速尝试 |
| Docker安装 | 环境隔离，不污染宿主机，部署快速一致 | 需要额外学习Docker概念，占用资源稍多 | 开发者、运维人员或在服务器部署的用户 |
安装完程序只是有了身体，接下来要给它注入灵魂——进行初始配置。
1.运行配置向导：在终端中输入命令 `openclaw onboard` 并回车（如果是Docker安装，需要先进入容器，或使用 `docker exec` 执行此命令）。这会启动一个交互式的配置向导。
2.关键配置选项解读：
*风险提示：首先会有一个风险告知，大意是这是个强大但有风险的工具，选择“Yes”继续即可。
*选择模式：强烈建议新手选择“QuickStart”模式，它会引导你完成最简化的必要配置。
*配置AI模型：这是核心！你需要提供一个大模型的API Key。OpenClaw本身没有智能，它需要调用如OpenAI的GPT、Anthropic的Claude、智谱的GLM、深度求索的DeepSeek等大模型来工作。你需要前往对应平台的官网申请Key。考虑到成本和网络，国内用户选择DeepSeek或智谱GLM是更实惠稳定的选择。将获得的API Key填入即可。
*选择通信渠道：你可以选择先跳过（Skip for now），后续在Web界面配置；也可以直接配置Telegram、飞书等机器人。初期建议跳过，用Web界面测试更直观。
*配置技能(Skills)：向导会问你是否现在配置技能，可以先选“No”，后续再按需添加。
3.启动网关服务：配置完成后，需要启动OpenClaw的核心服务（网关）。在终端中输入：
```bash
openclaw gateway start --port 18789
```
默认端口是18789，如果被占用可以换成其他端口，如18790。看到服务成功启动并监听的日志，就说明后台服务跑起来了。
服务启动后，如何验证它真的在工作呢？
1.访问Web控制台：打开你的浏览器，在地址栏输入`http://localhost:18789`（如果你修改了端口，请替换成你的端口号）。如果一切正常，你将看到OpenClaw的Web用户界面。
2.进行简单测试：在Web界面的聊天框里，尝试发送一些指令。例如，你可以输入：“帮我在桌面创建一个名为‘test_openclaw.txt’的文件，并写入‘Hello OpenClaw！’”。如果稍等片刻后，你的桌面真的出现了这个文件并且内容正确，那么恭喜你，你的OpenClaw自营安装大功告成！
自己安装，难免会遇到问题。这里罗列几个高频“坑点”和解决方案：
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| :--- | :--- | :--- |
| 安装命令报错，提示权限不足 | 在Windows未使用管理员权限运行终端 | 关闭终端，重新以管理员身份运行PowerShell或CMD，再执行命令。 |
| `node-v`或`openclaw--version`命令不识别 | Node.js未安装，或安装后环境变量未生效 | 重新安装Node.js，并重启终端。可检查系统环境变量PATH中是否包含Node.js的安装路径。 |
| 安装过程中网络错误、下载缓慢或卡住 | 网络连接npm或GitHub不稳定 | 使用国内镜像源安装（见方法一）。对于一键脚本，可能需要配置科学上网环境。 |
| 启动网关服务后，浏览器无法访问localhost:18789 | 防火墙阻止了端口访问；服务未成功启动 | 检查终端日志是否显示成功监听。在Windows防火墙中放行18789端口的入站规则。 |
| 配置向导中填入APIKey后测试不通过 | APIKey无效；网络无法访问对应模型服务商 | 确认APIKey复制无误且有余额。如使用国外模型（如OpenAI），确保网络环境允许访问。 |
走到这里，你已经成功完成了OpenClaw的自营安装。但这仅仅是开始，就像一个超级机器人刚刚通上电。接下来，你可以去探索如何为它配置更强大的技能（Skills），让它能操作浏览器、处理Excel、管理你的日程；也可以研究如何将它接入钉钉、飞书、微信，成为你团队的工作助手。
自己动手安装的意义，远不止于完成一个任务。它让你从“使用者”变成了“掌控者”。在这个过程中，你解决的每一个报错，理解的每一个配置项，都会成为你与这个AI助手深度协作的基石。希望这篇超过两千字的详细指南，能切实地帮你跨过那道门槛，真正拥有属于你自己的、安全可控的AI生产力伙伴。如果过程中遇到这篇指南没覆盖的新问题，别慌，记住错误信息，去开源社区或相关论坛搜索，你会发现，你走过的路，很多人都走过，并且留下了路标。祝你玩得开心！
版权说明：
