没有显卡能装 OpenClaw 吗？

能。没显卡就走 API 这条路——龙虾本体不吃显卡，吃显卡的是本地大模型。配置文件里填一个闭源 API（Claude、GPT 等）的 key，龙虾把活儿发给云端的模型算，本机只负责跑流程。普通笔记本完全够用。

Windows 上装一直报错怎么办？

Windows 原生环境最容易卡在 PATH 和 Node 版本上。最省事的办法是装 WSL2（Windows 自带的 Linux 子系统），然后完全按 Linux 步骤来，踩坑会少很多。直接用原生 PowerShell 也行：官方有一条 PowerShell 安装命令，会顺手把 Node 装好；装完重开终端再试。

装好后怎么确认它真的能用？

给它一条最小任务：让它在当前目录新建一个文件、写一行字、再读回来念给你听。如果这一整圈（调文件系统写、再调文件系统读）能跑通，说明模型连通、工具调用、循环执行三件事都没问题，剩下的就是堆更复杂的任务了。

教程 · 部署

本地部署 OpenClaw 龙虾：Windows / macOS / Linux 三平台照抄教程

钳叔 · 龙虾AI 编辑部 · 2026-08-23 · 约 13 分钟

看完介绍觉得龙虾不错，想自己装一只，可一打开终端、对着满屏命令行就开始打退堂鼓——这种心情我太懂了。其实把流程拆开看，没那么吓人。这篇给“想动手但怕折腾”的人写：Windows、macOS、Linux 三个平台分开讲，每一步都配好命令，照着抄即可。真卡住的地方，八成逃不出文末那 5 个常见报错。

先确认：你要走哪条路

龙虾本体很轻，真正决定难度的是“大脑”怎么接。开始之前先想清楚一件事：

走 API（推荐新手）：本机不需要显卡，配置里填一个 Claude / GPT 这类的 key，模型在云端算。任何一台能上网的电脑都能跑。
本地跑模型：数据不出本机、长期免费，但需要一块像样的显卡（显存 8G 起步，跑得舒服建议 16G+），还要额外装一个本地推理工具。

这篇主线按“走 API”讲，因为对新手最稳；接本地模型的分支放在后面单独说。

环境准备（三平台通用）

先纠正一个流传很广的误会：OpenClaw 是个 Node.js 项目，不是 Python 项目。网上（包括本站早期版本）那套“建虚拟环境、pip 装依赖、python main.py”的装法是错的，照着走到第一步就会卡住。它真正需要的只有一样：

Node.js 22.22.3+、24.15+ 或 25.9+——官方推荐直接上 Node 26；注意 Node 23 不受支持。

先查一下有没有、版本够不够：

node --version

没装或版本太老，下面按系统给最省事的装法（用官方一键脚本的话，这步可以跳过——脚本发现没有 Node 会自己装）：

macOS

brew install node

Linux（以 Debian / Ubuntu 为例）

curl -fsSL https://deb.nodesource.com/setup_26.x | sudo -E bash -
sudo apt-get install -y nodejs

Windows

两个选择。怕麻烦就开 WSL2，然后完全按上面的 Linux 步骤走，坑最少：

# 管理员身份开 PowerShell，装好后重启
wsl --install

不想用 WSL，就用 winget 装 Node（winget install OpenJS.NodeJS.LTS），或者去 Node.js 官网下安装包。装完重开一个终端再查版本。

装龙虾：一条命令的事

这一步三平台一样，官方给了一键脚本，它会自动识别系统、缺 Node 就补 Node、装好 OpenClaw、然后直接拉起引导向导：

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

# Windows PowerShell（不走 WSL 的话）
iwr -useb https://openclaw.ai/install.ps1 | iex

已经自己管着 Node、不想让脚本碰环境的，用 npm 全局装也行，然后手动跑一遍引导：

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

那个 --allow-scripts=openclaw 是给 npm 12 和 11.16+ 用的——新版 npm 默认拦住包的安装脚本，不加这个参数会报 blocked because they are not covered by allowScripts；npm 11.15 及更老的版本不认识这个参数，去掉即可。--install-daemon 会顺手把龙虾注册成开机自启的后台服务（macOS 是 launchd，Linux / WSL 是 systemd 用户服务）。

想改源码的人才需要 git clone——那条路走的是 pnpm install && pnpm build && pnpm ui:build，和上面的一键装是两回事，新手不用碰。

这一步会下载一堆包，慢是正常的。中间不报红，跑到提示符回来，就算成功。

给它接一个“大脑”

龙虾本体没智商，得告诉它用哪个模型。好消息是引导向导（openclaw onboard）会替你问：选哪家服务商、API key 是多少、要不要装成后台服务——照着答完其实就能用了。下面讲的是“向导之外手动怎么改”，换模型、换 key 的时候用得上。

龙虾的配置都住在家目录的 ~/.openclaw/ 下面：密钥放 ~/.openclaw/.env，其余设置放 ~/.openclaw/openclaw.json。按你选的路填。

路 A：填闭源 API key

去模型服务商后台拿一个 key。这里先说清一件新手常抄错的事：龙虾没有通用的 API_KEY 字段，密钥是按服务商各自命名的，你用哪家就往 ~/.openclaw/.env 里填哪一行：

ANTHROPIC_API_KEY=sk-ant-你的密钥
# 用 OpenAI 就填 OPENAI_API_KEY=sk-...
# 用 Gemini 就填 GEMINI_API_KEY=...

密钥填完还差一步：告诉它用哪个模型。这一步不在 .env 里，而在 ~/.openclaw/openclaw.json，模型写成“服务商/模型名”的格式：

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-opus-5"
      }
    }
  }
}

同级还有一个 fallbacks，可以挂备用模型，主模型不可用时自动顶上。

路 B：接本地模型

先用本地推理工具把模型拉起来（比如把一个开源模型起成本地服务），再在同一个 openclaw.json 里把这个本地服务登记成一个“服务商”，然后把主模型指过去：

{
  agents: {
    defaults: { model: { primary: "local/你的本地模型" } }
  },
  models: {
    mode: "merge",
    providers: {
      local: {
        baseUrl: "http://127.0.0.1:11434/v1",  // 端口按你实际起的服务改
        apiKey: "ollama-local",                // 本地服务填个占位串就行
        api: "openai-completions",
        models: [
          { id: "你的本地模型", name: "本地模型", contextWindow: 120000, maxTokens: 8192 }
        ]
      }
    }
  }
}

配置文件是 JSON5，能写注释、能留尾逗号，不用为了一个逗号跟它较劲。mode: "merge" 建议留着，它让内置的云端模型继续可用，本地模型顶不住时能随时切回去。

两条路只填一条。哪个模型当大脑更顺手，我们在 AI 模型榜按工具调用稳定性、长任务连贯性、中文表现和成本打了分，挑之前可以先看一眼。

跑通第一条任务

配置存好，先确认后台的 Gateway（龙虾的主进程）在跑，再把控制台开出来：

openclaw gateway status   # 应该看到它在监听 18789 端口
openclaw dashboard        # 在浏览器里打开控制台（Control UI）

控制台能打开，就在聊天框里给它一句最小指令，先别上来就让它干大活：

在工作目录新建一个 hello.txt，写一行“龙虾你好”，然后读出来念给我听

如果它真的建了文件、写了字、又读回来复述给你——恭喜，模型连通、工具调用、循环执行三件事全通了，剩下就是堆更复杂的任务。不想守着浏览器的话，接个 Telegram 机器人是最快的手机端入口，只要一个 bot token。

上手提示 走“路 A（API）”第一次装，时间大头通常在下载上——一键脚本要拉 Node 和一堆 npm 包，下载慢的时候会觉得卡很久，其实是在等下载，耐心等就好，别急着中断。装完后第一条“新建文件并读回”这种小任务一般很快就通。如果走“路 B”接本地模型，又没有独显、靠 CPU 推理，同样的任务会明显慢一截——能用，但复杂任务建议还是上显卡或走 API。

常见报错 5 条

1. command not found: openclaw

原因：十有八九是 PATH 问题——npm 的全局 bin 目录没在你 shell 的 PATH 里；用 nvm / fnm 这类版本管理器的人，常见于没在 ~/.zshrc 或 ~/.bashrc 里初始化它，新开的终端就找不到 Node 的 bin。解决：npm prefix -g 看全局包装在哪，echo "$PATH" 看那个目录的 bin 在不在里面，不在就加进去，然后重开终端。

2. Node 版本不对

原因：系统里有个老 Node（或者偏偏是 Node 23），不在支持范围内。解决：node -v 确认；要求是 22.22.3+、24.15+ 或 25.9+，官方推荐直接上 26。版本管理器里装个新的切过去即可。

3. npm 装的时候报 blocked because they are not covered by allowScripts

原因：npm 12 起默认拦住包的安装脚本，OpenClaw 的 preinstall / postinstall 被拦下了。解决：装的命令后面加 --allow-scripts=openclaw；用官方一键脚本的话它自己会处理，不用操心。

4. Authentication / 401 错误

原因：API key 填错、过期，或账户没额度。解决：回服务商后台核对 key 是否完整（别漏字符），看账户余额，再确认 ~/.openclaw/.env 里变量名拼对了（比如 ANTHROPIC_API_KEY）、openclaw.json 里的“服务商/模型名”和这个 key 是同一家。

5. 它能聊天但不动手

原因：模型连上了，但工具没开或权限没给。解决：检查配置里工具是否启用，第一次跑很多项目会弹权限确认，得手动放行它读写文件。这不是 bug，是安全设计。

常见问题

没有显卡能装 OpenClaw 吗？: 能。走 API 这条路就行——龙虾本体不吃显卡，吃显卡的是本地模型。配置里填一个闭源 API 的 key，活儿发给云端算，普通笔记本完全够用。
Windows 上装一直报错怎么办？: 最省事是开 WSL2 再按 Linux 步骤走，坑少很多。坚持用原生 PowerShell 也行，官方那条 PowerShell 安装命令会顺手把 Node 装好，装完重开终端再试。
装好后怎么确认它真的能用？: 给它一条最小任务：新建文件、写一行、再读回来念给你听。这一整圈能跑通，说明连通、工具调用、循环执行都没问题。