安装指南

推荐默认方案（大多数用户） 小型 Linux VPS 用于永久在线的 Gateway 网关，成本低。参见 VPS 托管。 专用硬件（Mac mini 或 Linux 机器）如果你想要完全控制和住宅 IP 用于浏览器自动化。许多网站会屏蔽数据中心 IP，所以本地浏览通常效果更好。 混合方案： 将 Gateway 网关保持在廉价 VPS 上，当你需要浏览器/UI 自动化时，将你的 Mac 作为节点连接。参见节点和 Gateway 网关远程。 当你特别需要 macOS 独有功能（iMessage/BlueBubbles）或想要与日常 Mac 严格隔离时，使用 macOS VM。 macOS VM 选项 在你的 Apple Silicon Mac 上运行本地 VM（Lume） 使用 Lume 在你现有的 Apple Silicon Mac 上的沙箱 macOS VM 中运行 OpenClaw。 这为你提供： 隔离的完整 macOS 环境（你的主机保持干净） 通过 BlueBubbles 支持 iMessage（在 Linux/Windows 上不可能） 通过克隆 VM 即时重置 无需额外硬件或云成本 托管 Mac 提供商（云） 如果你想要云端的 macOS，托管 Mac 提供商也可以： ...

OpenClaw 提供两个安装器脚本（托管在 openclaw.ai）： https://openclaw.ai/install.sh — “推荐"安装器（默认全局 npm 安装；也可从 GitHub 检出安装） https://openclaw.ai/install-cli.sh — 无需 root 权限的 CLI 安装器（安装到带有独立 Node 的前缀目录） https://openclaw.ai/install.ps1 — Windows PowerShell 安装器（默认 npm；可选 git 安装） 查看当前参数/行为，运行： curl -fsSL https://openclaw.ai/install.sh | bash -s -- --help Windows (PowerShell) 帮助： & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -? 如果安装器完成但在新终端中找不到 openclaw，通常是 Node/npm PATH 问题。参见：安装。 install.sh（推荐） 功能概述： 检测操作系统（macOS / Linux / WSL）。 确保 Node.js 22+（macOS 通过 Homebrew；Linux 通过 NodeSource）。 选择安装方式： npm（默认）：npm install -g openclaw@latest git：克隆/构建源码检出并安装包装脚本 在 Linux 上：必要时将 npm 前缀切换到 ~/.npm-global，以避免全局 npm 权限错误。 如果是升级现有安装：运行 openclaw doctor --non-interactive（尽力执行）。 对于 git 安装：安装/更新后运行 openclaw doctor --non-interactive（尽力执行）。 通过默认设置 SHARP_IGNORE_GLOBAL_LIBVIPS=1 来缓解 sharp 原生安装问题（避免使用系统 libvips 编译）。 如果你希望 sharp 链接到全局安装的 libvips（或你正在调试），请设置： ...

本指南将 OpenClaw Gateway 网关从一台机器迁移到另一台，无需重新进行新手引导。 迁移在概念上很简单： 复制状态目录（$OPENCLAW_STATE_DIR，默认：~/.openclaw/）— 这包括配置、认证、会话和渠道状态。 复制你的工作区（默认 ~/.openclaw/workspace/）— 这包括你的智能体文件（记忆、提示等）。 但在配置文件、权限和部分复制方面有常见的陷阱。 开始之前（你要迁移什么） 1）确定你的状态目录 大多数安装使用默认值： 状态目录： ~/.openclaw/ 但如果你使用以下方式，可能会不同： --profile <name>（通常变成 ~/.openclaw-<profile>/） OPENCLAW_STATE_DIR=/some/path 如果你不确定，在旧机器上运行： openclaw status 在输出中查找 OPENCLAW_STATE_DIR / profile 的提及。如果你运行多个 Gateway 网关，对每个配置文件重复此操作。 2）确定你的工作区 常见默认值： ~/.openclaw/workspace/（推荐的工作区） 你创建的自定义文件夹 你的工作区是 MEMORY.md、USER.md 和 memory/*.md 等文件所在的位置。 3）了解你将保留什么 如果你复制两者——状态目录和工作区，你将保留： Gateway 网关配置（openclaw.json） 认证配置文件 / API 密钥 / OAuth 令牌 会话历史 + 智能体状态 渠道状态（例如 WhatsApp 登录/会话） 你的工作区文件（记忆、Skills 笔记等） 如果你只复制工作区（例如通过 Git），你不会保留： 会话 凭证 渠道登录 这些存储在 $OPENCLAW_STATE_DIR 下。 迁移步骤（推荐） 步骤 0 — 备份（旧机器） 在旧机器上，首先停止 Gateway 网关，这样文件不会在复制过程中发生变化： ...

最后更新：2026-01-21 OpenClaw 提供三个更新渠道： stable：npm dist-tag latest。 beta：npm dist-tag beta（测试中的构建）。 dev：main 的移动头（git）。npm dist-tag：dev（发布时）。 我们将构建发布到 beta，进行测试，然后将经过验证的构建提升到 latest， 版本号不变——dist-tag 是 npm 安装的数据源。 切换渠道 Git checkout： openclaw update --channel stable openclaw update --channel beta openclaw update --channel dev stable/beta 检出最新匹配的标签（通常是同一个标签）。 dev 切换到 main 并在上游基础上 rebase。 npm/pnpm 全局安装： openclaw update --channel stable openclaw update --channel beta openclaw update --channel dev 这会通过相应的 npm dist-tag（latest、beta、dev）进行更新。 当你使用 --channel 显式切换渠道时，OpenClaw 还会对齐安装方式： dev 确保有一个 git checkout（默认 ~/openclaw，可通过 OPENCLAW_GIT_DIR 覆盖）， 更新它，并从该 checkout 安装全局 CLI。 stable/beta 使用匹配的 dist-tag 从 npm 安装。 提示：如果你想同时使用 stable + dev，保留两个克隆并将 Gateway 网关指向 stable 那个。 ...

OpenClaw 发展迅速（尚未到"1.0"）。将更新视为发布基础设施：更新 → 运行检查 → 重启（或使用会重启的 openclaw update）→ 验证。 推荐：重新运行网站安装程序（原地升级） 首选的更新路径是重新运行网站上的安装程序。它会检测现有安装、原地升级，并在需要时运行 openclaw doctor。 curl -fsSL https://openclaw.ai/install.sh | bash 说明： 如果你不想再次运行新手引导向导，添加 --no-onboard。 对于源码安装，使用： curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard 安装程序仅在仓库干净时才会执行 git pull --rebase。 对于全局安装，脚本底层使用 npm install -g openclaw@latest。 旧版说明：clawdbot 仍可作为兼容性垫片使用。 更新之前 了解你的安装方式：全局（npm/pnpm）还是源码（git clone）。 了解你的 Gateway 网关运行方式：前台终端还是受管理服务（launchd/systemd）。 快照你的定制内容： 配置：~/.openclaw/openclaw.json 凭证：~/.openclaw/credentials/ 工作区：~/.openclaw/workspace 更新（全局安装） 全局安装（选择一个）： npm i -g openclaw@latest pnpm add -g openclaw@latest 我们不推荐将 Bun 用于 Gateway 网关运行时（WhatsApp/Telegram 有 bug）。 切换更新渠道（git + npm 安装）： ...