部署升级 on openclaw

OpenClaw运行资源需求

Mon, 01 Jan 0001 00:00:00 +0000

OpenClaw部署运行资源需求主要是

硬件要求

最低配置：4GB内存，2核CPU，10GB存储空间
推荐配置：8GB内存，4核CPU，20GB存储空间（支持多Skill并行运行）

操作系统支持

Windows 10/11（64位）
macOS 12+
Linux（Ubuntu 22.04+/Debian 11+/Fedora 36+）

前置软件安装

Node.js 22+版本（必须安装，因OpenClaw基于Node.js开发）
Docker（可选，用于容器化部署）
内网穿透工具（如花生壳，用于本地部署时通过公网访问）

MacOS安装OpenClaw

Mon, 01 Jan 0001 00:00:00 +0000

安装要求

Node 24（推荐）（出于兼容性考虑，仍支持 Node 22 LTS，目前为 22.16+；）
macOS 支持
仅当你从源码构建时需要 pnpm（推荐不安装）

安装 Node.js

在 MacOS 上安装 Node.js 时，默认都会包含 node 和 npm 两个工具命令。

安装方法有很多，比如：

Homebrew安装： Homebrew是Mac上常用的包管理工具，类似Linux的 yum/apt。但是homebrew安装包需要访问GitHub。
Nvm 安装： Nvm是 Node.js 的版本管理工具，可以安装和升级 node 版本。但是nvm自身安装依赖homebrew或访问GitHub。
官方安装脚本： 官方默认安装脚本，也是先安装 nvm，需要访问GitHub raw.githubusercontent.com。
（推荐）官方安装包下载安装： 官方还提供了PKG安装包，可以离线安装。

nodejs官网可正常访问，因此可以直接访问官网下载 MacOS 版本的 node 安装包。 https://nodejs.org/zh-cn/download

选择安装包并下载：

在页面上方选择 Node.js 版本，推荐选择 v24.14.1 LTS版本。
在页面下方选择个人电脑的操作系统（macOS）和CPU架构（新版本M系列的Mac都是ARM64架构，老版本的是x64架构）

双击下载的 pkg 安装包，全程按照默认“继续”进行安装即可

以后提示安装成功和的位置，点击关闭即可。

安装完成后进行验证。

默认安装路径为 /usr/local/bin/node 和 /usr/local/bin/npm 这个路径在 macOS 上是一般是添加到环境变量的，默认安装成功后就可以直接使用命令node和npm进行操作了。

Linux安装OpenClaw

Mon, 01 Jan 0001 00:00:00 +0000

安装要求

Node 24（推荐）（出于兼容性考虑，仍支持 Node 22 LTS，目前为 22.16+；）
Linux 支持
仅当你从源码构建时需要 pnpm（推荐不安装）

安装 Node.js

在 Linux 上安装 Node.js 时，默认会包含 corepack、node、npm 和 npx 工具命令。

安装方法有很多，比如：

yum/dnf/apt 安装： Linux系统包管理工具安装的版本可能比较老旧。
Nvm 安装： Nvm是 Node.js 的版本管理工具，可以安装和升级 node 版本。但是nvm自身安装依赖访问外网。
官方安装脚本： 官方默认安装脚本，也是先安装 nvm，需要访问GitHub raw.githubusercontent.com。
（推荐）官方安装包下载安装： 官方还提供了PKG安装包，可以离线安装。

nodejs官网可正常访问，因此可以直接访问官网下载 Linux 版本的 node 安装包。 https://nodejs.org/zh-cn/download

选择安装包并下载：

在页面上方选择 Node.js 版本，推荐选择 v24.14.1 LTS版本。
在页面下方选择操作系统（Linux）和CPU架构（x64和amd64一般是同一种架构，arm64和aarch64一般是同一种架构）
点击下载后上传到Linux服务器，或者右键复制下载链接。

例如，Linux ARM64 v24.14.1 LTS 版本下载地址：

# wget https://nodejs.org/dist/v24.14.1/node-v24.14.1-linux-x64.tar.xz

下载后的包解压到 /usr/local 目录下

# tar xf node-v24.14.1-linux-x64.tar.xz -C /usr/local

# ls /usr/local/node-v24.14.1-linux-x64/bin/
corepack  node  npm  npx

解压后需要配置PATH环境变量

Windows安装OpenClaw

Mon, 01 Jan 0001 00:00:00 +0000

安装要求

Node 24（推荐）（出于兼容性考虑，仍支持 Node 22 LTS，目前为 22.16+；）
Windows 10+ 支持
仅当你从源码构建时需要 pnpm（推荐不安装）

安装 Node.js

在 Windo 上安装 Node.js。

安装方法有很多，比如：

Nvm 安装： Nvm是 Node.js 的版本管理工具，可以安装和升级 node 版本。但是nvm自身安装依赖访问外网。
官方安装脚本： 官方Windows默认是通过 Docker 安装，不符合后续安装 Openclaw的要求。
（推荐）官方安装包下载安装： 官方还提供了 MSI 安装包，可以离线安装。

nodejs官网可正常访问，因此可以直接访问官网下载 Linux 版本的 node 安装包。 https://nodejs.org/zh-cn/download

选择安装包并下载：

在页面上方选择 Node.js 版本，推荐选择 v24.14.1 LTS版本。
在页面下方选择操作系统（Windows）和CPU架构（x64和amd64一般是同一种架构，arm64和aarch64一般是同一种架构）

下载完 msi 安装包后，双击进行安装

一路按照默认即可

安装完成后，打开命令行终端。

Win + R键打开cmd，或者在任务栏中打开cmd，

C:\Users\98569>npm -v
11.11.0

C:\Users\98569>node -v
v24.14.1

安装 OpenClaw （CMD 终端）

OpenClaw 是基于 Node.js 实现的，因此默认就会发布到 npm 仓库中。

官方Docker安装

Mon, 01 Jan 0001 00:00:00 +0000

官方提供的 docker-compose 的部署需要拉取源代码后build构建镜像运行，在国内很难构建成功。

同时，官方还提供了预构建好的 Docker 镜像，最新版本已经同步到 cncfstack 镜像仓库，可以直接拉取使用。

docker pull registry.cncfstack.com/ghcr.io/openclaw/openclaw:2026.3.24

然后运行

docker run -itd --name openclaw \
    -p 18789:18789 \
    -v ./openclaw:/home/node/.openclaw \
    registry.cncfstack.com/ghcr.io/openclaw/openclaw:2026.3.24

运行成功后，访问 http://localhost:18789 即可。

注意：

官方构建的容器镜像只包含 OpenClaw 的核心基础功能，一些系统工具无法进行调用，如 cron、docker 等。

安装问题排查

Mon, 01 Jan 0001 00:00:00 +0000

安装问题排查

使用openclaw doctor --fix命令自动诊断并修复问题

openclaw doctor --fix

Mon, 01 Jan 0001 00:00:00 +0000

OpenClaw 安装完后，一般需要进行初始化配置。

其核心就是通过交互式引导，完成一些配置，生成 ~/.openclaw/openclaw.json 文件，如果熟悉该文件内容，也可以直接创建该文件，不需要进行交互式初始化。

openclaw onboard --install-daemon

交互式初始化过程说明：

安全警告，选择 yes。通过键盘左右键选择，回车确认。

◆  I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
│  ● Yes / ○ No

设置运行模式模式，选择默认的 QuickStart。通过上下键选择，回车确认。

◆  Setup mode
│  ● QuickStart (Configure details later via openclaw configure.)
│  ○ Manual

确认后进行默认的配置。默认的配置只能通过本地环回接口访问（localhost/127.0.0.1），如果需要跨机器访问，也可以在后续修改配置文件。

◇  QuickStart ─────────────────────────╮
│                                      │
│  Gateway port: 18789                 │
│  Gateway bind: Loopback (127.0.0.1)  │
│  Gateway auth: Token (default)       │
│  Tailscale exposure: Off             │
│  Direct to chat channels.            │
│                                      │
├──────────────────────────────────────╯

模型提供商配置，选择最后一个 Skip for now 跳过配置。提供大模型服务的厂商，后续单独进行模型配置。

◆  Model/auth provider
│  ○ Anthropic
│  ○ BytePlus
│  ○ Chutes
│  ○ Cloudflare AI Gateway
│  ○ Copilot
│  ○ Custom Provider
│  ○ DeepSeek
│  ○ Google
│  ○ Hugging Face
│  ○ Kilo Gateway
│  ○ Kimi Code
│  ○ LiteLLM
│  ○ MiniMax
│  ○ Mistral AI
│  ○ Moonshot AI (Kimi K2.5)
│  ○ Ollama
│  ○ OpenAI
│  ○ OpenCode
│  ○ OpenRouter
│  ○ Qianfan
│  ○ Qwen
│  ○ Qwen (Alibaba Cloud Model Studio)
│  ○ SGLang
│  ○ Synthetic
│  ○ Together AI
│  ○ Venice AI
│  ○ Vercel AI Gateway
│  ○ vLLM
│  ○ Volcano Engine
│  ○ xAI (Grok)
│  ○ Xiaomi
│  ○ Z.AI
│  ● Skip for now

模型列表提供商，选择默认 All providers。这个配置后续配置模型时会镜像修改，主要用于在Web页面聊天窗口切换模型列表的选项。

◆  Filter models by provider
│  ● All providers
│  ○ amazon-bedrock
│  ○ anthropic
│  ○ azure-openai-responses
│  ○ cerebras
│  ○ github-copilot
│  ○ google
│  ○ google-antigravity
│  ○ google-gemini-cli
│  ○ google-vertex
│  ○ groq
│  ○ huggingface
│  ○ kimi-coding
│  ○ minimax
│  ○ minimax-cn
│  ○ mistral
│  ○ ollama
│  ○ openai
│  ○ openai-codex
│  ○ opencode
│  ○ opencode-go
│  ○ openrouter
│  ○ vercel-ai-gateway
│  ○ xai
│  ○ zai

设置默认模型，选择一个模型作为默认模型，回车确认。这里主要是配置默认模型，后续调用模型时，如果没有指定模型，则使用默认模型。该配置后续会覆盖修改。

◆  Default model
│  ● Keep current (default: anthropic/claude-opus-4-6)
│  ○ Enter model manually
│  ○ amazon-bedrock/anthropic.claude-3-haiku-20240307-v1:0
│  ○ amazon-bedrock/anthropic.claude-3-5-haiku-20241022-v1:0
│  ○ amazon-bedrock/anthropic.claude-haiku-4-5-20251001-v1:0
│  ○ amazon-bedrock/eu.anthropic.claude-haiku-4-5-20251001-v1:0
│  ○ amazon-bedrock/global.anthropic.claude-haiku-4-5-20251001-v1:0
│  ○ amazon-bedrock/us.anthropic.claude-haiku-4-5-20251001-v1:0
│  ○ amazon-bedrock/anthropic.claude-opus-4-20250514-v1:0
......

配置IM渠道，选择Skip for now。这里主要是配置通过哪些渠道连接OpenClaw，如QQ、飞书、钉钉等，后面会单独进行配置。

◆  Select channel (QuickStart)
│  ○ Telegram (Bot API)
│  ○ WhatsApp (QR link)
│  ○ Discord (Bot API)
│  ○ IRC (Server + Nick)
│  ○ Google Chat (Chat API)
│  ○ Slack (Socket Mode)
│  ○ Signal (signal-cli)
│  ○ iMessage (imsg)
│  ○ LINE (Messaging API)
│  ○ Feishu/Lark (飞书)
│  ○ Nostr (NIP-04 DMs)
│  ○ Microsoft Teams (Teams SDK)
│  ○ Mattermost (plugin)
│  ○ Nextcloud Talk (self-hosted)
│  ○ Matrix (plugin)
│  ○ BlueBubbles (macOS app)
│  ○ Zalo (Bot API)
│  ○ Zalo (Personal Account)
│  ○ Synology Chat (Webhook)
│  ○ Tlon (Urbit)
│  ○ Twitch (Chat)
│  ● Skip for now (You can add channels later via `openclaw channels add`)

配置Web搜索服务，选择Skip for now跳过。部分搜索需要注册配置APKEY才能使用，后续可单独配置。

◆  Search provider
│  ○ Brave Search
│  ○ DuckDuckGo Search (experimental)
│  ○ Exa Search
│  ○ Firecrawl Search
│  ○ Gemini (Google Search)
│  ○ Grok (xAI)
│  ○ Kimi (Moonshot)
│  ○ Perplexity Search
│  ○ Tavily Search
│  ● Skip for now (Configure later with openclaw configure --section web)

配置SKILL，选择 No。OpenClaw会有一些默认安装的SKILL，额外的SKILL可以通过 ClawHub 进行查询和安装，后续按需安装即可。
```
◆  Configure skills now? (recommended)
│  ○ Yes / ● No
```
启动哪些hooks，选择第一个 Skip for now。通过键盘上的空格键进行选择，然后回车。hooks用于OpenClaw和大模型沟通过程中添加的额外信息。
```
◆  Enable hooks?
│  ◼ Skip for now
│  ◻ 🚀 boot-md
│  ◻ 📎 bootstrap-extra-files
│  ◻ 📝 command-logger
│  ◻ 💾 session-memory
```

使用哪种方式访问OpenClaw？选择Open the Web UI就会自动打开浏览器访问OpenClaw页面。

◆  How do you want to hatch your bot?
│  ○ Hatch in TUI (recommended)
│  ● Open the Web UI
│  ○ Do this later

完成后的信息，输出完成后就会退出初始化步骤。

◇  Dashboard ready ────────────────────────────────────────────────────────────────╮
│                                                                                  │
│  Dashboard link (with token):                                                    │
│  http://127.0.0.1:18789/#token=5040bd14cd0d8f838f83bd41226a598ba2a4d347428ec67d  │
│  Opened in your browser. Keep that tab to control OpenClaw.                      │
│                                                                                  │
├──────────────────────────────────────────────────────────────────────────────────╯
│
◇  Workspace backup ────────────────────────────────────────╮
│                                                           │
│  Back up your agent workspace.                            │
│  Docs: https://docs.openclaw.ai/concepts/agent-workspace  │
│                                                           │
├───────────────────────────────────────────────────────────╯
│
◇  Security ──────────────────────────────────────────────────────╮
│                                                                 │
│  Running agents on your computer is risky — harden your setup:  │
│  https://docs.openclaw.ai/security                              │
│                                                                 │
├─────────────────────────────────────────────────────────────────╯
│
◇  Shell completion ───────────────────────────────────────────────────────╮
│                                                                          │
│  Shell completion installed. Restart your shell or run: source ~/.zshrc  │
│                                                                          │
├──────────────────────────────────────────────────────────────────────────╯
│
◇  Web search ───────────────────────────────────────╮
│                                                    │
│  Web search was skipped. You can enable it later:  │
│    openclaw configure --section web                │
│                                                    │
│  Docs: https://docs.openclaw.ai/tools/web          │
│                                                    │
├────────────────────────────────────────────────────╯
│
◇  What now ─────────────────────────────────────────────────────────────╮
│                                                                        │
│  What now: https://openclaw.ai/showcase ("What People Are Building").  │
│                                                                        │
├────────────────────────────────────────────────────────────────────────╯
│
└  Onboarding complete. Dashboard opened; keep that tab to control OpenClaw.