你是不是也跟我一样，早就对那些只会“动嘴不动手”的聊天机器人感到厌倦了？它们确实聪明，Neng帮你写首诗、编个段子，甚至改几行代码。但当你真正需要它帮你干点实事——比如整理一下乱七八糟的本地文件、或者自动处理一些繁琐的重复性操作时它们往往就束手无策了。

这时候，OpenClaw 就像一道硬菜端上来了。这不仅仅是一个聊天工具，而是一个真正Neng跑在你自己机器上的AI智Neng体网关。它不仅Neng思考，还Neng通过Gateway真正执行动作。而且，Zui让人安心的是所有的数据dou在你本地流转，不用上传到任何第三方服务器，隐私安全绝对有保障。

可Neng有些老朋友会问：“这名字怎么听着有点耳熟又有点陌生？”没错，Ru果你之前关注过这个项目，它Zui早叫 Clawdbot。后来因为一些商标上的顾虑，它在2026年1月27日短暂地改名为 Moltbot，就像龙虾蜕壳一样。不过Zui终，在1月30日项目方正式敲定了现在的名字——OpenClaw。虽然名字换了马甲，但内核还是那个熟悉的配方，功Neng完全一致，大家大可放心。

今天我就手把手教大家如何在2026年把这个“小家伙”请进你的电脑。不管你是Windows党、Mac用户还是Linux极客，这篇教程douNeng让你在半小时内搞定部署。

一、 准备工作：磨刀不误砍柴工

在开始敲代码之前，我们得先确保你的“战场”准备好了。OpenClaw虽然强大，但它对环境还是有一点点小要求的。别担心，这些dou不难，只是需要一点点耐心。

1. 硬件底线

你的电脑内存Zui好在 4GB 以上。虽然理论上低一点也Neng跑，但谁也不想用个AI卡成PPT吧？另外硬盘空间得留出至少 10GB，毕竟除了程序本身，后续的日志、缓存还有一些模型数据dou需要地方放。

2. 软件环境：Node.js是关键

OpenClaw是基于Node.js构建的，所以这是重中之重。为了获得Zui丝滑的体验，我们强烈推荐安装 Node.js 22 版本或者geng高。Ru果你电脑里装的是老古董版本，可Neng会遇到各种奇奇怪怪的报错，到时候别怪我没提醒你。

怎么检查版本呢？hen简单，打开终端，输入：

node --version

Ru果显示的版本号低于22，那就赶紧升级吧。Mac和Linux用户通常习惯用 nvm 来管理版本，那简直是神器：

nvm install 22
nvm use 22

Windows用户就直接去官网下载个安装包覆盖安装就行，记得勾选自动配置环境变量的选项，省得后面自己折腾PATH。

二、 安装OpenClaw：三种姿势任你选

环境搞定后重头戏来了。安装OpenClaw主要有几种方式，你Ke以根据自己的习惯和系统来选。

1. Linux/macOS 用户：一行命令搞定

对于使用类Unix系统的朋友来说这应该是Zui优雅的方式。官方提供了一个安装脚本，你只需要打开终端，复制下面这串“魔法咒语”并回车：

curl -fsSL https://openclaw.ai/install.sh | bash

这个脚本会自动帮你处理下载依赖、配置环境变量等一系列繁琐的操作。你唯一要Zuo的就是kan着屏幕上的进度条跑完，期间Ke以去泡杯咖啡。安装完成后通常需要重新加载一下shell配置，或者干脆重启终端。

2. Windows 用户：PowerShell 的“权力游戏”

Windows用户可Neng会稍微痛苦一点点，因为系统默认为了安全，会限制PowerShell执行脚本。不过别怕，我们有办法绕过去。

你需要以管理员身份运行PowerShell。然后为了防止npm全局安装时因为路径问题被拦截，建议先配置一下npm的安装前缀：

# 修改npm安装目录到C盘根目录下的npm文件夹，避免权限麻烦
npm config set prefix "C:
pm"
npm config set cache "C:
pm-cache"
# 把这个目录加到系统环境变量里
::SetEnvironmentVariable

接着，为了Neng运行安装脚本，你需要临时调整一下执行策略：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Zuo完这些铺垫，你就Ke以通过npm来安装了：

# 安装Zui新稳定版
npm install -g openclaw@latest
# Ru果你geng喜欢中文界面也Ke以试试汉化版
npm install -g @qingchencloud/openclaw-zh@latest

3. 通用大法：NPM/PNPM 直接装

不管你用什么系统，只要Node.js没问题，直接用npm包管理器安装也是Zui稳妥的。Ru果你是那种追求速度的开发者，并且Yi经装了pnpm，那用它来装会geng快：

# npm 安装
npm install -g openclaw@latest
# pnpm 安装 
pnpm add -g openclaw@latest

三、 验证与初始化：第一次握手

装完了别急着跑，先打个招呼确认一下它是不是真的活着。在终端里输入：

openclaw --version

Ru果屏幕乖乖地弹出了一个版本号，恭喜你，安装成功了一半！接下来我们要让它真正“跑”起来。

OpenClaw 需要一个初始化配置的过程，这就像新手机开机时的设置向导一样。输入以下命令启动向导：

openclaw onboard

这时候，终端里会跳出一连串选项，引导你完成基础设置。这里有几个关键点需要注意：

接受风险提示开源软件嘛，总会让你确认一下你知道自己在干什么选 Yes 大胆继续。

选择启动模式新手建议直接选 QuickStart，省心省力。

选择聊天工具OpenClaw支持多平台接入，比如Telegram、Discord甚至飞书。Ru果你只是先在本地测试，Ke以先跳过或者选Web UI。

选择Skills这是OpenClaw的灵魂。你Ke以用空格键选择你需要它具备的Neng力，比如文件管理、知识库检索等等。选好后回车确认。

配置完成后系统会自动尝试启动Gateway服务，并通常会自动在浏览器里打开Web UI。kan到那个聊天界面是不是感觉有点小激动了？

四、 深度配置：接入大模型大脑

OpenClaw 本身只是一个躯壳和手脚，它还需要一个“大脑”才Neng思考。这就需要我们配置大模型的API。目前它支持市面上主流的模型，比如 OpenAI 的 gpt-4Anthropic 的 claude-sonnet，以及国产之光 deepseek-chat 等。

1. 找到配置文件

虽然向导Neng帮你Zuohen多事，但有时候手动修改配置文件才是极客的浪漫。OpenClaw 的配置文件通常藏在以下位置：

Linux/macOS: ~/.openclaw/openclaw.json

Windows: C:\Users\你的用户名\.openclaw\openclaw.json

Ru果找不到，别慌，可Neng是还没生成。你Ke以手动创建一下：

# Linux/Mac
mkdir -p ~/.openclaw
echo '{}'> ~/.openclaw/openclaw.json

2. 配置 API Key 和 模型

打开这个 openclaw.json 文件，你会kan到一堆JSON格式的代码。这里我们以接入一个第三方中转服务为例，因为直接用官方API有时候网络不太顺畅。

你需要关注的核心字段是 models 和 providers。下面是一个典型的配置示例，假设我们要用 DeepSeek 和 Claude：

{
  "models": {
    "mode": "merge",
    "providers": {
      "whataicc": {
        "baseUrl": "https://api.whatai.cc/v1",
        "apiKey": "sk-or-v1-这里填你自己的密钥",
        "auth": "api-key",
        "api": "openai-chat",
        "models": 
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "whataicc/anthropic/claude-sonnet-4-20250514"
      }
    }
  }
}

这里解释几个关键参数：

baseUrl: API服务的地址，Ru果你用中转，就填中转商给的地址。

apiKey: 你的通行证，千万别泄露给别人。

auth: 认证方式，一般是 api-key 或者 bearer。

contextWindow: 上下文窗口大小，决定了AINeng记多少字。

maxTokens: Zui大输出字数限制。

改完记得保存。Ru果Gateway正在运行，你需要重启它才Neng让配置生效：

# 查kan状态
openclaw channels status
# 重启服务
openclaw gateway restart

五、 进阶玩法：技Neng与Agent管理

OpenClaw 真正厉害的地方在于它的 性。它不是死的，你Ke以通过安装各种“Skills”来让它学会新技Neng。

1. 查kan和管理 Agent

你Ke以把Agent理解为具有特定人格和技Neng的助手。输入以下命令kankan你手里dou有哪些牌：

openclaw agents list

Ru果你想查kan某个特定Agent的详细配置，比如kankan它默认用哪个模型，Ke以用：

openclaw config get --agent main-assistant

2. 安装插件

Ru果你想让它把消息发到飞书里或者通过飞书来控制它，你可Neng需要安装对应的插件。通常这需要一点Git操作：

# 克隆插件仓库
git clone https://github.com/m1heng/clawdbot-feishu.git
cd clawdbot-feishu
# 安装依赖
npm install
# 将插件软链接到OpenClaw的插件目录
ln -s $ ~/.openclaw/plugins/feishu

这样，你的“小龙虾”就学会了在飞书里横行霸道了。

六、 常见问题：踩坑指南

哪怕教程写得再详细，实际操作中总会遇到那么几个“拦路虎”。这里我了一些大家Zui容易遇到的坑，希望Neng帮你省点头发。

问题1：Sharp模块加载失败

这是Node.js里处理图片的常见坑。报错信息里通常会提到 sharp 字样。

解法： 别犹豫，直接清理缓存重装：

npm cache clean --force
npm install -g openclaw@latest --force

问题2：Windows Defender 老是拦截

Windows自带的杀毒软件有时候对脚本特别敏感，尤其是当你从GitHub上下东西的时候。

解法： 你需要把OpenClaw的安装目录添加到排除项里。虽然这听起来有点风险，但只要你是从官方渠道下的，问题不大。

问题3：权限错误

Linux/Mac用户Zui常见的问题，特别是没加 sudo 的时候。

解法：

# macOS/Linux
sudo chown -R $USER ~/.openclaw

Windows用户记得一定要用管理员身份打开PowerShell。

问题4：Gateway 无法启动

配置dou对了但Web界面打不开，或者提示 Gateway unreachable。

解法： 先运行诊断命令kankan哪里出了问题：

openclaw doctor

Ru果是端口被占用了你需要去配置文件里修改端口，或者把占口的软件关掉。查kan日志也是个好办法：

tail -f ~/.openclaw/logs/gateway.log

七、 ：让AI为你打工

折腾了这么久，当你终于kan到Web界面上那个闪烁的光标，并且Neng准确回应你的指令时那种成就感是无与伦比的。OpenClaw 不仅仅是一个工具，它代表了AI应用的一种新趋势：从云端走向本地，从被动回答走向主动执行。

虽然现在的版本Yi经比Zui初稳定了hen多，但作为开源项目，它依然在不断进化。遇到问题别灰心，去社区里逛逛，或者翻翻GitHub上的Issues，你绝对不是一个人在战斗。

现在去试试让你的“小龙虾”帮你自动整理下载文件夹吧，或者让它写个脚本自动抓取你喜欢的股票数据。毕竟我们安装AI的初衷，就是为了让自己geng懒一点，不是吗？祝大家玩得开心！

---