安装指南

将 OpenClaw 部署到生产服务器的推荐方式是通过 openclaw-ansible — 一个安全优先架构的自动化安装程序。 快速开始 一条命令安装： curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/install.sh | bash 📦 完整指南：github.com/openclaw/openclaw-ansible openclaw-ansible 仓库是 Ansible 部署的权威来源。本页是快速概述。 你将获得 🔒 防火墙优先安全：UFW + Docker 隔离（仅 SSH + Tailscale 可访问） 🔐 Tailscale VPN：安全远程访问，无需公开暴露服务 🐳 Docker：隔离的沙箱容器，仅绑定 localhost 🛡️ 纵深防御：4 层安全架构 🚀 一条命令设置：几分钟内完成部署 🔧 Systemd 集成：带加固的开机自启动 要求 操作系统：Debian 11+ 或 Ubuntu 20.04+ 访问权限：Root 或 sudo 权限 网络：用于包安装的互联网连接 Ansible：2.14+（由快速启动脚本自动安装） 安装内容 Ansible playbook 安装并配置： Tailscale（用于安全远程访问的 mesh VPN） UFW 防火墙（仅允许 SSH + Tailscale 端口） Docker CE + Compose V2（用于智能体沙箱） Node.js 22.x + pnpm（运行时依赖） OpenClaw（基于主机，非容器化） Systemd 服务（带安全加固的自动启动） 注意：Gateway 网关直接在主机上运行（不在 Docker 中），但智能体沙箱使用 Docker 进行隔离。详情参见沙箱隔离。 ...

目标：使用 Bun 运行此仓库（可选，不推荐用于 WhatsApp/Telegram），同时不偏离 pnpm 工作流。 ⚠️ 不推荐用于 Gateway 网关运行时（WhatsApp/Telegram 存在 bug）。生产环境请使用 Node。 状态 Bun 是一个可选的本地运行时，用于直接运行 TypeScript（bun run …、bun --watch …）。 pnpm 是构建的默认工具，仍然完全支持（并被一些文档工具使用）。 Bun 无法使用 pnpm-lock.yaml 并会忽略它。 安装 默认： bun install 注意：bun.lock/bun.lockb 被 gitignore，所以无论哪种方式都不会有仓库变动。如果你想不写入锁文件： bun install --no-save 构建/测试（Bun） bun run build bun run vitest run Bun 生命周期脚本（默认被阻止） 除非明确信任（bun pm untrusted / bun pm trust），Bun 可能会阻止依赖的生命周期脚本。 对于此仓库，通常被阻止的脚本不是必需的： @whiskeysockets/baileys preinstall：检查 Node 主版本 >= 20（我们运行 Node 22+）。 protobufjs postinstall：发出关于不兼容版本方案的警告（无构建产物）。 如果你遇到真正需要这些脚本的运行时问题，请明确信任它们： bun pm trust @whiskeysockets/baileys protobufjs 注意事项 一些脚本仍然硬编码 pnpm（例如 docs:build、ui:*、protocol:check）。目前请通过 pnpm 运行这些脚本。

Docker 是可选的。仅当你想要容器化的 Gateway 网关或验证 Docker 流程时才使用它。 Docker 适合我吗？ 是：你想要一个隔离的、可丢弃的 Gateway 网关环境，或在没有本地安装的主机上运行 OpenClaw。 否：你在自己的机器上运行，只想要最快的开发循环。请改用正常的安装流程。 沙箱注意事项：智能体沙箱隔离也使用 Docker，但它不需要完整的 Gateway 网关在 Docker 中运行。参阅沙箱隔离。 本指南涵盖： 容器化 Gateway 网关（完整的 OpenClaw 在 Docker 中） 每会话智能体沙箱（主机 Gateway 网关 + Docker 隔离的智能体工具） 沙箱隔离详情：沙箱隔离 要求 Docker Desktop（或 Docker Engine）+ Docker Compose v2 足够的磁盘空间用于镜像 + 日志 容器化 Gateway 网关（Docker Compose） 快速开始（推荐） 从仓库根目录： ./docker-setup.sh 此脚本： 构建 Gateway 网关镜像 运行新手引导向导 打印可选的提供商设置提示 通过 Docker Compose 启动 Gateway 网关 生成 Gateway 网关令牌并写入 .env 可选环境变量： OPENCLAW_DOCKER_APT_PACKAGES — 在构建期间安装额外的 apt 包 OPENCLAW_EXTRA_MOUNTS — 添加额外的主机绑定挂载 OPENCLAW_HOME_VOLUME — 在命名卷中持久化 /home/node 完成后： ...

目标：OpenClaw Gateway 网关运行在 exe.dev VM 上，可从你的笔记本电脑通过以下地址访问：https://<vm-name>.exe.xyz 本页假设使用 exe.dev 的默认 exeuntu 镜像。如果你选择了不同的发行版，请相应地映射软件包。 新手快速路径 https://exe.new/openclaw 根据需要填写你的认证密钥/令牌 点击 VM 旁边的"Agent"，然后等待… ??? 完成 你需要什么 exe.dev 账户 ssh exe.dev 访问 exe.dev 虚拟机（可选） 使用 Shelley 自动安装 Shelley，exe.dev 的智能体，可以使用我们的提示立即安装 OpenClaw。使用的提示如下： Set up OpenClaw (https://docs.openclaw.ai/install) on this VM. Use the non-interactive and accept-risk flags for openclaw onboarding. Add the supplied auth or token as needed. Configure nginx to forward from the default port 18789 to the root location on the default enabled site config, making sure to enable Websocket support. Pairing is done by "openclaw devices list" and "openclaw device approve <request id>". Make sure the dashboard shows that OpenClaw's health is OK. exe.dev handles forwarding from port 8000 to port 80/443 and HTTPS for us, so the final "reachable" should be <vm-name>.exe.xyz, without port specification. 手动安装 1) 创建 VM 从你的设备： ...

目标： OpenClaw Gateway 网关运行在 Fly.io 机器上，具有持久存储、自动 HTTPS 和 Discord/渠道访问。 你需要什么 已安装 flyctl CLI Fly.io 账户（免费套餐可用） 模型认证：Anthropic API 密钥（或其他提供商密钥） 渠道凭证：Discord bot token、Telegram token 等 初学者快速路径 克隆仓库 → 自定义 fly.toml 创建应用 + 卷 → 设置密钥 使用 fly deploy 部署 SSH 进入创建配置或使用 Control UI 1）创建 Fly 应用 # Clone the repo git clone https://github.com/openclaw/openclaw.git cd openclaw # Create a new Fly app (pick your own name) fly apps create my-openclaw # Create a persistent volume (1GB is usually enough) fly volumes create openclaw_data --size 1 --region iad 提示： 选择离你近的区域。常见选项：lhr（伦敦）、iad（弗吉尼亚）、sjc（圣何塞）。 ...

使用 Nix 运行 OpenClaw 的推荐方式是通过 nix-openclaw — 一个开箱即用的 Home Manager 模块。 快速开始 将此粘贴给你的 AI 智能体（Claude、Cursor 等）： I want to set up nix-openclaw on my Mac. Repository: github:openclaw/nix-openclaw What I need you to do: 1. Check if Determinate Nix is installed (if not, install it) 2. Create a local flake at ~/code/openclaw-local using templates/agent-first/flake.nix 3. Help me create a Telegram bot (@BotFather) and get my chat ID (@userinfobot) 4. Set up secrets (bot token, Anthropic key) - plain files at ~/.secrets/ is fine 5. Fill in the template placeholders and run home-manager switch 6. Verify: launchd running, bot responds to messages Reference the nix-openclaw README for module options. 📦 完整指南：github.com/openclaw/nix-openclaw ...

该页面是英文文档的中文占位版本，完整内容请先参考英文版：Node.js。

两种方式： 如果 openclaw 仍已安装，使用简单方式。 如果 CLI 已删除但服务仍在运行，使用手动服务移除。 简单方式（CLI 仍已安装） 推荐：使用内置卸载程序： openclaw uninstall 非交互式（自动化 / npx）： openclaw uninstall --all --yes --non-interactive npx -y openclaw uninstall --all --yes --non-interactive 手动步骤（效果相同）： 停止 Gateway 网关服务： openclaw gateway stop 卸载 Gateway 网关服务（launchd/systemd/schtasks）： openclaw gateway uninstall 删除状态 + 配置： rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}" 如果你将 OPENCLAW_CONFIG_PATH 设置为状态目录外的自定义位置，也请删除该文件。 删除你的工作区（可选，移除智能体文件）： rm -rf ~/.openclaw/workspace 移除 CLI 安装（选择你使用的那个）： npm rm -g openclaw pnpm remove -g openclaw bun remove -g openclaw 如果你安装了 macOS 应用： rm -rf /Applications/OpenClaw.app 注意事项： ...

目标 使用 Docker 在 GCP Compute Engine VM 上运行持久化的 OpenClaw Gateway 网关，具有持久状态、内置二进制文件和安全的重启行为。 如果你想要"OpenClaw 24/7 大约 $5-12/月"，这是在 Google Cloud 上的可靠设置。 价格因机器类型和区域而异；选择适合你工作负载的最小 VM，如果遇到 OOM 则扩容。 我们在做什么（简单说明）？ 创建 GCP 项目并启用计费 创建 Compute Engine VM 安装 Docker（隔离的应用运行时） 在 Docker 中启动 OpenClaw Gateway 网关 在主机上持久化 ~/.openclaw + ~/.openclaw/workspace（重启/重建后仍保留） 通过 SSH 隧道从你的笔记本电脑访问控制 UI Gateway 网关可以通过以下方式访问： 从你的笔记本电脑进行 SSH 端口转发 如果你自己管理防火墙和令牌，可以直接暴露端口 本指南使用 GCP Compute Engine 上的 Debian。 Ubuntu 也可以；请相应地映射软件包。 有关通用 Docker 流程，请参阅 Docker。 快速路径（有经验的运维人员） 创建 GCP 项目 + 启用 Compute Engine API 创建 Compute Engine VM（e2-small，Debian 12，20GB） SSH 进入 VM 安装 Docker 克隆 OpenClaw 仓库 创建持久化主机目录 配置 .env 和 docker-compose.yml 内置所需二进制文件、构建并启动 你需要什么 GCP 账户（e2-micro 符合免费层条件） 已安装 gcloud CLI（或使用 Cloud Console） 从你的笔记本电脑 SSH 访问 对 SSH + 复制/粘贴有基本了解 约 20-30 分钟 Docker 和 Docker Compose 模型认证凭证 可选的提供商凭证 WhatsApp QR Telegram bot token Gmail OAuth 1) 安装 gcloud CLI（或使用 Console） 选项 A：gcloud CLI（推荐用于自动化） ...

目标 使用 Docker 在 Hetzner VPS 上运行持久的 OpenClaw Gateway 网关，带持久状态、内置二进制文件和安全的重启行为。 如果你想要"约 $5 实现 OpenClaw 24/7"，这是最简单可靠的设置。 Hetzner 定价会变化；选择最小的 Debian/Ubuntu VPS，如果遇到 OOM 再扩容。 我们在做什么（简单说明）？ 租用一台小型 Linux 服务器（Hetzner VPS） 安装 Docker（隔离的应用运行时） 在 Docker 中启动 OpenClaw Gateway 网关 在主机上持久化 ~/.openclaw + ~/.openclaw/workspace（重启/重建后保留） 通过 SSH 隧道从你的笔记本电脑访问控制 UI Gateway 网关可以通过以下方式访问： 从你的笔记本电脑进行 SSH 端口转发 如果你自己管理防火墙和令牌，可以直接暴露端口 本指南假设在 Hetzner 上使用 Ubuntu 或 Debian。 如果你使用其他 Linux VPS，请相应地映射软件包。 通用 Docker 流程请参见 Docker。 快速路径（有经验的运维人员） 配置 Hetzner VPS 安装 Docker 克隆 OpenClaw 仓库 创建持久化主机目录 配置 .env 和 docker-compose.yml 将所需二进制文件烘焙到镜像中 docker compose up -d 验证持久化和 Gateway 网关访问 你需要什么 具有 root 访问权限的 Hetzner VPS 从你的笔记本电脑进行 SSH 访问 基本熟悉 SSH + 复制/粘贴 约 20 分钟 Docker 和 Docker Compose 模型认证凭证 可选的提供商凭证 WhatsApp 二维码 Telegram 机器人令牌 Gmail OAuth 1) 配置 VPS 在 Hetzner 中创建一个 Ubuntu 或 Debian VPS。 ...