Source: OpenClaw Orange Paper v1.2.0, Chapters 10-14
Deployment Options Overview
OpenClaw supports a variety of deployment options, from local to cloud. Which one to pick depends on your technical skill, budget, and use case.
Comparison of Deployment Options
| Platform | One-click Deploy | Minimum Spec | New-User Price | Built-in Models | Difficulty | Best For |
|---|---|---|---|---|---|---|
| Local | — | Node.js 22+ | Free | No | Low | Developers, macOS/Linux users |
| npm | — | Node.js 22+ | Free | No | Low | Developers, macOS/Linux users |
| Docker | — | Docker Engine | Free | No | Medium | Container-savvy developers |
| Alibaba Cloud | Yes | 2C2G 40GB | ¥9.9/mo | Yes (qwen3.5-plus) | Very low (3 steps) | Top pick in mainland China, beginner-friendly |
| Tencent Cloud | Yes | 2C2G | ~¥17/mo | No (Coding Plan required) | Very low (3 steps) | WeCom/QQ ecosystem users |
| Baidu Cloud | Yes | 2C4G | ¥0.01 for the first month | Yes (Qianfan models) | Very low (4 steps) | Quick trials, ERNIE ecosystem |
| Huawei Cloud | Yes | Flexus L instance | From ~¥85/mo | No (MaaS required) | Medium (5+ steps) | Enterprise users, compliance needs |
| Volcengine | Yes | 2C4G | ¥9.9/mo | Yes (Ark models) | Low (3-4 steps) | Top pick for Feishu users |
| Coze Coding | Yes | No server needed | From ¥49/mo | Yes (Seed 2.0, etc.) | Very low (2 steps) | Zero barrier, no server management |
| Railway | Yes | Auto-assigned | $5/mo free credit | No | Very low (1 click) | Overseas users, developers |
| Zeabur | Yes | Dedicated 2C4G | Usage-based billing | Yes (AI Hub) | Very low (template) | Multi-model failover needs |
Key Advice
Model costs are the real expense. Server costs have generally dropped very low (¥9.9-99/year); the true ongoing cost is model API calls. When choosing a platform, focus on model bundle pricing rather than the server price alone.
Local Installation
Local installation suits developers and users who want full control over their data. OpenClaw is a TypeScript project that runs on Node.js.
System Requirements
| Requirement | Details |
|---|---|
| Node.js | >= 22 (mandatory) |
| Package manager | npm / pnpm / bun all work |
| macOS | Xcode Command Line Tools required |
| Linux | Standard build tools (gcc, make) |
| Windows | WSL2 strongly recommended |
Option 1: Global npm Install (Recommended)
The most recommended install method — just two commands:
# Install OpenClaw
npm install -g openclaw@latest
# Initialize and install the daemon
openclaw onboard --install-daemon
The onboard command walks you through the initial setup, including choosing a model, configuring API keys, and setting up messaging channels. The --install-daemon flag also installs the daemon so OpenClaw keeps running in the background.
Option 2: One-line Script Install (macOS / Linux)
If you'd rather not install Node.js manually, use the official one-line install script:
curl -fsSL https://openclaw.ai/install.sh | bash
Note: This command is for macOS and Linux only. Windows users should set up WSL2 first and then run it.
Extra Prep on macOS
Before installing, macOS users must make sure Xcode Command Line Tools are installed:
xcode-select --install
If you need the iMessage channel or the Apple Notes skill, note that they rely on macOS-native AppleScript capabilities and only run on macOS.
A Note for Windows Users
Important: OpenClaw officially strongly recommends running on WSL2 (Windows Subsystem for Linux). Running natively on Windows may hit compatibility issues with paths, permissions, and more.
Once WSL2 is installed, open an Ubuntu terminal and follow the Linux instructions.
The Daemon
The daemon keeps OpenClaw running in the background, even after you close the terminal. Different systems use different process managers:
| OS | Process Management | Notes |
|---|---|---|
| macOS | launchd | Native macOS service management, starts on boot |
| Linux | systemd | Standard Linux service management, controlled via systemctl |
With the daemon installed, the OpenClaw Gateway keeps listening on ws://127.0.0.1:18789.
Docker Deployment
Docker deployment fits scenarios that need environment isolation, easy migration, or long-term operation on a server.
Quick Start with docker-compose
The OpenClaw repo ships with a built-in docker-compose.yml — one command to start:
# Clone the repository
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# Start
docker-compose up -d
Image Variants
| Variant | Description | Use Case |
|---|---|---|
| Standard image | Full features, all extension dependencies included | General use, full functionality |
| slim variant | Multi-stage build, smaller size | Resource-constrained environments, CI/CD |
| sandbox | Sandboxed environment | Security isolation, code execution |
| sandbox-browser | Sandbox with a browser | Browser automation needs |
To use the slim variant: set the environment variable OPENCLAW_VARIANT=slim in docker-compose.yml.
Volumes to Mount
Docker deployment requires mounting two key directories to keep data persistent:
volumes:
- ~/.openclaw:/root/.openclaw # Config and state data
- ~/openclaw/workspace:/workspace # Workspace (YAML config files)
Important: Without mounting these two directories, all configuration and conversation history will be lost when the container restarts.
Port Mapping
The OpenClaw Gateway listens on port 18789 (WebSocket) by default, and the Web UI uses port 3000 by default:
ports:
- "18789:18789" # Gateway WebSocket
- "3000:3000" # Web UI
Podman Compatibility
OpenClaw also runs on Podman:
# Start with Podman
podman-compose up -d
For environments that require rootless containers (e.g., corporate security policies), Podman is the better choice.
One-click Deployment on Chinese Cloud Providers
This is the go-to option for most users in mainland China. All major Chinese cloud providers now support one-click OpenClaw deployment.
Alibaba Cloud
The platform with the richest community resources in China — image pre-installed, works out of the box.
| Item | Details |
|---|---|
| Spec | 2 vCPU + 2 GiB RAM + 40 GiB ESSD system disk |
| OS | Alibaba Cloud Linux 3, with the OpenClaw image pre-installed |
| Price | Limited-time flash sale ¥9.9/mo; annual plans as low as ¥68/year |
| Models | qwen3.5-plus built in by default; Bailian Coding Plan Lite ¥10 for the first month |
| IM support | DingTalk, Feishu, etc. (via the openclaw-china plugin) |
Deployment steps:
- One-click purchase: open the campaign page and buy a Lightweight Application Server with the OpenClaw image pre-installed
- Open ports + configure: allow ports 18789 (Gateway) and 3000 (Web UI) in the security group
- Visit the Web UI: open
http://YOUR_IP:3000in a browser
Tencent Cloud
Full support for the four major IMs, with cost-effective Coding Plan model bundles.
Deployment steps:
- Purchase a Lighthouse instance
- Choose the OpenClaw template: Application Templates → AI Agents → OpenClaw
- Configure models + connect IMs: buy a Coding Plan, then connect WeCom/QQ/Feishu/DingTalk
Volcengine
Top pick for Feishu users, deeply integrated with the Feishu ecosystem.
Coze Coding
A zero-barrier option — no server to manage.
| Item | Details |
|---|---|
| Price | From ¥49/mo |
| Models | Seed 2.0 and more built in |
| Difficulty | Very low (2 steps) |
| Best for | Users who don't want to manage servers |
First-time Setup
Initialization Flow
- Set an admin password: set it on your first visit to the Web UI
- Add an AI model: configure an API key
- Pick a default model: set the model you'll use most
- Configure channels (optional): connect Feishu/DingTalk/WeChat, etc.
Recommended Model Choices
| User Type | Recommended Model | Why |
|---|---|---|
| First-time users | Google Gemini | Free tier available |
| Users in mainland China | DeepSeek / Kimi | Friendly to mainland networks |
| Quality first | Claude / GPT-4 | Best results |
| Cost sensitive | Local models (Ollama) | Completely free |
Getting API Keys
| Provider | Where to Get It |
|---|---|
| Google Gemini | https://aistudio.google.com/apikey |
| Claude | https://console.anthropic.com/ |
| OpenAI | https://platform.openai.com/api-keys |
| DeepSeek | https://platform.deepseek.com/ |
| Kimi | https://platform.moonshot.cn/ |
Recommended Next Step (Hands-on)
If you want to get it running locally first (the most common path), follow this directly:
→ Deploy OpenClaw on Your Local Machine (15-30 minutes)
For 24/7 cloud operation see Cloud Server Deployment; for common pitfalls see Local Troubleshooting 2026.
来源：OpenClaw 橙皮书 v1.2.0 第 10-14 章
部署方式总览
OpenClaw 支持从本地到云端的多种部署方式。选择哪种取决于你的技术水平、预算和使用场景。
部署方式对比
| 平台 | 一键部署 | 最低配置 | 新用户价格 | 内置模型 | 难度 | 适合人群 |
|---|---|---|---|---|---|---|
| 本地 | — | Node.js 22+ | 免费 | 否 | 低 | 开发者、macOS/Linux用户 |
| npm | — | Node.js 22+ | 免费 | 否 | 低 | 开发者、macOS/Linux用户 |
| Docker | — | Docker Engine | 免费 | 否 | 中 | 熟悉容器的开发者 |
| 阿里云 | 是 | 2C2G 40GB | 9.9元/月 | 是（qwen3.5-plus） | 极低（3步） | 国内首选，新手友好 |
| 腾讯云 | 是 | 2C2G | ~17元/月 | 否（需购Coding Plan） | 极低（3步） | 企微/QQ生态用户 |
| 百度云 | 是 | 2C4G | 0.01元首月 | 是（千帆模型） | 极低（4步） | 体验尝鲜，文心生态 |
| 华为云 | 是 | Flexus L实例 | ~85元/月起 | 否（需接MaaS） | 中等（5步+） | 企业用户，合规需求 |
| 火山引擎 | 是 | 2C4G | 9.9元/月 | 是（方舟模型） | 低（3-4步） | 飞书用户首选 |
| 扣子编程 | 是 | 无需服务器 | ¥49/月起 | 是（Seed 2.0等） | 极低（2步） | 零门槛，不想管服务器 |
| Railway | 是 | 自动分配 | $5/月免费额度 | 否 | 极低（1键） | 海外用户，开发者 |
| Zeabur | 是 | 2C4G专用 | 按用量计费 | 是（AI Hub） | 极低（模板） | 需要多模型failover |
核心建议
模型费用才是大头。 服务器成本普遍已降到很低（9.9-99元/年），真正的持续成本在于模型调用。选平台时重点看模型套餐价格，而不是只看服务器价格。
本地安装
本地安装适合开发者和想完全掌控数据的用户。OpenClaw 是 TypeScript 项目，运行在 Node.js 上。
系统要求
| 要求 | 详情 |
|---|---|
| Node.js | >= 22 (强制要求) |
| 包管理器 | npm / pnpm / bun 均可 |
| macOS | 需要 Xcode Command Line Tools |
| Linux | 标准构建工具 (gcc, make) |
| Windows | 强烈推荐 WSL2 |
方式一：npm 全局安装（推荐）
最推荐的安装方式，两条命令搞定：
# 安装 OpenClaw
npm install -g openclaw@latest
# 初始化并安装守护进程
openclaw onboard --install-daemononboard 命令会引导你完成初始配置，包括选择模型、配置 API Key、设置消息频道等。--install-daemon 参数会同时安装守护进程，让 OpenClaw 在后台持续运行。
方式二：一键脚本安装（macOS / Linux）
如果你不想手动安装 Node.js，可以使用官方提供的一键安装脚本：
curl -fsSL https://openclaw.ai/install.sh | bash注意：此命令仅适用于 macOS 和 Linux。Windows 用户请使用 WSL2 后再运行。
macOS 额外准备
macOS 用户在安装前需要确保已安装 Xcode Command Line Tools：
xcode-select --install如果你需要使用 iMessage 频道或 Apple Notes 技能，这些依赖 macOS 原生的 AppleScript 能力，只有在 macOS 上才能运行。
Windows 用户注意
重要：OpenClaw 官方强烈推荐 Windows 用户通过 WSL2（Windows Subsystem for Linux）运行。直接在 Windows 原生环境下运行可能遇到路径、权限等兼容性问题。
安装 WSL2 后，在 Ubuntu 终端内按 Linux 流程安装即可。
守护进程
守护进程让 OpenClaw 在后台持续运行，即使关闭终端也不会中断。不同系统使用不同的进程管理方式：
| 系统 | 进程管理 | 说明 |
|---|---|---|
| macOS | launchd | macOS 原生服务管理，开机自启 |
| Linux | systemd | Linux 标准服务管理，systemctl 控制 |
安装守护进程后，OpenClaw Gateway 会在 ws://127.0.0.1:18789 持续监听。
Docker 部署
Docker 部署适合需要环境隔离、方便迁移、或在服务器上长期运行的场景。
docker-compose 快速启动
OpenClaw 仓库内置了 docker-compose.yml，一条命令即可启动：
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 启动
docker-compose up -d镜像变体
| 变体 | 说明 | 适用场景 |
|---|---|---|
| 标准镜像 | 完整功能，包含所有扩展依赖 | 一般使用，功能全 |
| slim 变体 | 多阶段构建，体积更小 | 资源受限环境，CI/CD |
| sandbox | 沙箱环境 | 安全隔离，代码执行 |
| sandbox-browser | 含浏览器的沙箱 | 需要浏览器自动化 |
使用 slim 变体：在 docker-compose.yml 中设置环境变量 OPENCLAW_VARIANT=slim。
挂载目录
Docker 部署需要挂载两个关键目录，确保数据持久化：
volumes:
- ~/.openclaw:/root/.openclaw # 配置和状态数据
- ~/openclaw/workspace:/workspace # 工作空间 (YAML配置文件)重要：不挂载这两个目录，容器重启后所有配置和对话记录都会丢失。
端口映射
OpenClaw Gateway 默认监听 18789 端口 (WebSocket)，Web UI 默认使用 3000 端口：
ports:
- "18789:18789" # Gateway WebSocket
- "3000:3000" # Web UIPodman 兼容
OpenClaw 同样支持 Podman 运行：
# 使用 Podman 启动
podman-compose up -d对于需要 rootless 容器运行的环境（如企业安全策略要求），Podman 是更合适的选择。
国内云厂商一键部署
这是大多数国内用户的首选方案。所有主流云厂商都已支持 OpenClaw 一键部署。
阿里云 Alibaba Cloud
国内社区资源最丰富的平台，镜像预装，开箱即用。
| 项目 | 详情 |
|---|---|
| 配置 | 2vCPU + 2GiB 内存 + 40GiB ESSD 系统盘 |
| 系统 | Alibaba Cloud Linux 3，预装 OpenClaw 镜像 |
| 价格 | 限时秒杀 9.9元/月，包年常规优惠低至 68元/年 |
| 模型 | 默认内置 qwen3.5-plus；百炼 Coding Plan Lite 首月 10元 |
| IM 支持 | 钉钉、飞书等（通过 openclaw-china 插件） |
部署步骤：
- 一键购买：进入活动页，购买预装 OpenClaw 镜像的轻量应用服务器
- 放通端口 + 配置：在安全组中放通 18789（Gateway）和 3000（Web UI）端口
- 访问 Web UI：浏览器访问
http://你的IP:3000
腾讯云 Tencent Cloud
四大 IM 全面支持，Coding Plan 模型套餐性价比高。
部署步骤：
- 购买 Lighthouse 实例
- 选择 OpenClaw 模板：应用模板→AI智能体→OpenClaw
- 配置模型 + 接入 IM：购买 Coding Plan 后接入企微/QQ/飞书/钉钉
火山引擎 Volcengine
飞书用户首选，与飞书生态深度集成。
扣子编程
零门槛方案，无需管理服务器。
| 项目 | 详情 |
|---|---|
| 价格 | ¥49/月起 |
| 模型 | 内置 Seed 2.0 等 |
| 难度 | 极低（2步） |
| 适合 | 不想管服务器的用户 |
首次配置
初始化流程
- 设置管理员密码：首次访问 Web UI 时设置
- 添加 AI 模型：配置 API Key
- 选择默认模型：设置主要使用的模型
- 配置渠道（可选）：接入飞书/钉钉/微信等
推荐模型选择
| 用户类型 | 推荐模型 | 原因 |
|---|---|---|
| 新手体验 | Google Gemini | 有免费额度 |
| 国内用户 | DeepSeek / Kimi | 国内网络友好 |
| 追求质量 | Claude / GPT-4 | 效果最好 |
| 成本敏感 | 本地模型 (Ollama) | 完全免费 |
API Key 获取
| 模型提供商 | 获取地址 |
|---|---|
| Google Gemini | https://aistudio.google.com/apikey |
| Claude | https://console.anthropic.com/ |
| OpenAI | https://platform.openai.com/api-keys |
| DeepSeek | https://platform.deepseek.com/ |
| Kimi | https://platform.moonshot.cn/ |
推荐下一步（手把手）
若你优先 本机先跑通（最常见路径），请直接跟：
出典：OpenClaw オレンジペーパー（Orange Paper）v1.2.0 第10-14章
デプロイ方式の概要
OpenClaw はローカルからクラウドまで、多様なデプロイ方式に対応しています。どれを選ぶかは、技術レベル・予算・利用シーンによって異なります。
デプロイ方式の比較
| プラットフォーム | ワンクリックデプロイ | 最低構成 | 新規ユーザー価格 | 内蔵モデル | 難易度 | 向いている人 |
|---|---|---|---|---|---|---|
| ローカル | — | Node.js 22+ | 無料 | なし | 低 | 開発者、macOS/Linux ユーザー |
| npm | — | Node.js 22+ | 無料 | なし | 低 | 開発者、macOS/Linux ユーザー |
| Docker | — | Docker Engine | 無料 | なし | 中 | コンテナ経験のある開発者 |
| Alibaba Cloud | あり | 2C2G 40GB | 9.9元/月 | あり（qwen3.5-plus） | 極めて低い（3ステップ） | 中国国内の定番、初心者向け |
| Tencent Cloud | あり | 2C2G | 約17元/月 | なし（Coding Plan の購入が必要） | 極めて低い（3ステップ） | WeCom/QQ エコシステムのユーザー |
| Baidu Cloud | あり | 2C4G | 初月 0.01元 | あり（千帆モデル） | 極めて低い（4ステップ） | お試し利用、ERNIE（文心）エコシステム |
| Huawei Cloud | あり | Flexus L インスタンス | 約85元/月〜 | なし（MaaS 接続が必要） | 中（5ステップ以上） | 法人ユーザー、コンプライアンス要件 |
| Volcengine | あり | 2C4G | 9.9元/月 | あり（方舟モデル） | 低（3〜4ステップ） | Feishu ユーザーの定番 |
| Coze Coding | あり | サーバー不要 | 49元/月〜 | あり（Seed 2.0 など） | 極めて低い（2ステップ） | サーバー管理をしたくない人 |
| Railway | あり | 自動割当 | $5/月分の無料枠 | なし | 極めて低い（ワンクリック） | 海外ユーザー、開発者 |
| Zeabur | あり | 専用 2C4G | 従量課金 | あり（AI Hub） | 極めて低い（テンプレート） | 複数モデルの failover が必要な人 |
重要なアドバイス
本当のコストはモデル利用料です。 サーバー費用はどこもかなり下がっており（9.9〜99元/年）、継続的にかかるのはモデル API の呼び出し費用です。プラットフォーム選びでは、サーバー価格だけでなくモデルプランの価格を重視しましょう。
ローカルインストール
ローカルインストールは開発者や、データを完全に自分で管理したいユーザーに向いています。OpenClaw は TypeScript プロジェクトで、Node.js 上で動作します。
システム要件
| 要件 | 詳細 |
|---|---|
| Node.js | >= 22（必須） |
| パッケージマネージャー | npm / pnpm / bun いずれも可 |
| macOS | Xcode Command Line Tools が必要 |
| Linux | 標準ビルドツール（gcc、make） |
| Windows | WSL2 を強く推奨 |
方式 1：npm グローバルインストール（推奨）
最も推奨されるインストール方法で、コマンド 2 つで完了します：
# OpenClaw をインストール
npm install -g openclaw@latest
# 初期化とデーモンのインストール
openclaw onboard --install-daemon
onboard コマンドは、モデル選択、API Key の設定、メッセージチャンネルの設定など、初期設定全体を案内してくれます。--install-daemon を付けるとデーモンも同時にインストールされ、OpenClaw がバックグラウンドで動き続けます。
方式 2：ワンライナースクリプトインストール（macOS / Linux）
Node.js を手動で入れたくない場合は、公式のワンライナーインストールスクリプトを使えます：
curl -fsSL https://openclaw.ai/install.sh | bash
注意：このコマンドは macOS と Linux 専用です。Windows ユーザーは WSL2 をセットアップしてから実行してください。
macOS の追加準備
macOS ユーザーは、インストール前に Xcode Command Line Tools が入っていることを確認してください：
xcode-select --install
iMessage チャンネルや Apple Notes スキルが必要な場合、これらは macOS ネイティブの AppleScript 機能に依存しており、macOS でしか動作しません。
Windows ユーザーへの注意
重要：OpenClaw 公式は、Windows ユーザーには WSL2（Windows Subsystem for Linux）での実行を強く推奨しています。Windows ネイティブ環境で直接実行すると、パスや権限まわりの互換性問題に遭遇する可能性があります。
WSL2 をインストールしたら、Ubuntu ターミナル内で Linux と同じ手順でインストールしてください。
デーモン
デーモンを使うと、ターミナルを閉じても OpenClaw はバックグラウンドで動き続けます。OS ごとにプロセス管理の方式が異なります：
| OS | プロセス管理 | 説明 |
|---|---|---|
| macOS | launchd | macOS ネイティブのサービス管理、起動時に自動開始 |
| Linux | systemd | Linux 標準のサービス管理、systemctl で制御 |
デーモンをインストールすると、OpenClaw Gateway は ws://127.0.0.1:18789 で常時リッスンします。
Docker デプロイ
Docker デプロイは、環境の分離、移行の容易さ、サーバーでの長期運用が必要なシーンに向いています。
docker-compose でクイックスタート
OpenClaw リポジトリには docker-compose.yml が同梱されており、コマンド 1 つで起動できます：
# リポジトリをクローン
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 起動
docker-compose up -d
イメージのバリアント
| バリアント | 説明 | 適したシーン |
|---|---|---|
| 標準イメージ | 全機能、すべての拡張依存を含む | 一般用途、フル機能 |
| slim バリアント | マルチステージビルドでサイズ小 | リソース制約環境、CI/CD |
| sandbox | サンドボックス環境 | セキュリティ分離、コード実行 |
| sandbox-browser | ブラウザ入りサンドボックス | ブラウザ自動化が必要な場合 |
slim バリアントを使うには：docker-compose.yml で環境変数 OPENCLAW_VARIANT=slim を設定します。
マウントするディレクトリ
Docker デプロイでは、データを永続化するために 2 つの重要なディレクトリをマウントする必要があります：
volumes:
- ~/.openclaw:/root/.openclaw # 設定と状態データ
- ~/openclaw/workspace:/workspace # ワークスペース（YAML 設定ファイル）
重要：この 2 つのディレクトリをマウントしないと、コンテナ再起動時にすべての設定と会話履歴が失われます。
ポートマッピング
OpenClaw Gateway はデフォルトで 18789 番ポート（WebSocket）、Web UI はデフォルトで 3000 番ポートを使用します：
ports:
- "18789:18789" # Gateway WebSocket
- "3000:3000" # Web UI
Podman 互換
OpenClaw は Podman でも動作します：
# Podman で起動
podman-compose up -d
rootless コンテナ実行が必要な環境（企業のセキュリティポリシーなど）では、Podman の方が適しています。
中国クラウドのワンクリックデプロイ
中国国内の大多数ユーザーにはこれが定番です。主要クラウドすべてが OpenClaw のワンクリックデプロイに対応済みです。
Alibaba Cloud（阿里雲）
中国でコミュニティリソースが最も豊富なプラットフォーム。イメージがプリインストール済みで、すぐ使えます。
| 項目 | 詳細 |
|---|---|
| 構成 | 2 vCPU + 2 GiB メモリ + 40 GiB ESSD システムディスク |
| OS | Alibaba Cloud Linux 3、OpenClaw イメージ プリインストール済み |
| 価格 | 期間限定 9.9元/月、年払いなら通常 68元/年〜 |
| モデル | 既定で qwen3.5-plus 内蔵。百炼 Coding Plan Lite は初月 10元 |
| IM 対応 | DingTalk、Feishu など（openclaw-china プラグイン経由） |
デプロイ手順：
- ワンクリック購入：キャンペーンページで、OpenClaw イメージ プリインストール済みの Lightweight Application Server を購入
- ポート解放と設定：セキュリティグループで 18789（Gateway）と 3000（Web UI）を解放
- Web UI にアクセス：ブラウザで
http://あなたのIP:3000を開く
Tencent Cloud（騰訊雲）
4 大 IM すべてに対応し、Coding Plan のモデルプランはコストパフォーマンスが高いです。
デプロイ手順：
- Lighthouse インスタンスを購入
- OpenClaw テンプレートを選択：アプリテンプレート → AI エージェント → OpenClaw
- モデル設定と IM 接続：Coding Plan を購入した後、WeCom/QQ/Feishu/DingTalk を接続
Volcengine（火山引擎）
Feishu ユーザーの定番。Feishu エコシステムと深く統合されています。
Coze Coding（扣子编程）
サーバー管理が不要な、ゼロハードルのプランです。
| 項目 | 詳細 |
|---|---|
| 価格 | 49元/月〜 |
| モデル | Seed 2.0 などを内蔵 |
| 難易度 | 極めて低い（2ステップ） |
| 向いている人 | サーバーを管理したくないユーザー |
初回設定
初期化フロー
- 管理者パスワードの設定：Web UI に初回アクセスしたときに設定
- AI モデルの追加：API Key を設定
- 既定モデルの選択：メインで使うモデルを設定
- チャンネル設定（任意）：Feishu/DingTalk/WeChat などを接続
おすすめのモデル選択
| ユーザー像 | おすすめモデル | 理由 |
|---|---|---|
| 初心者・お試し | Google Gemini | 無料枠あり |
| 中国国内ユーザー | DeepSeek / Kimi | 中国のネットワークにやさしい |
| 品質重視 | Claude / GPT-4 | 最良の成果 |
| コスト重視 | ローカルモデル（Ollama） | 完全無料 |
API Key の取得
| プロバイダー | 取得先 |
|---|---|
| Google Gemini | https://aistudio.google.com/apikey |
| Claude | https://console.anthropic.com/ |
| OpenAI | https://platform.openai.com/api-keys |
| DeepSeek | https://platform.deepseek.com/ |
| Kimi | https://platform.moonshot.cn/ |
次の一歩（ハンズオン）
まず 自分のマシンで動かす（最も一般的なルート）を優先するなら、こちらを直接どうぞ：
→ ローカル PC に OpenClaw をデプロイ（15〜30 分）
クラウドでの 24 時間運用は クラウドサーバーデプロイ、つまずきポイントは ローカルトラブルシューティング 2026 を参照してください。
來源：OpenClaw 橙皮書 v1.2.0 第 10-14 章
部署方式總覽
OpenClaw 支援從本機到雲端的多種部署方式。選哪種取決於你的技術水平、預算和使用場景。
部署方式對比
| 平台 | 一鍵部署 | 最低配置 | 新用戶價格 | 內建模型 | 難度 | 適合人群 |
|---|---|---|---|---|---|---|
| 本機 | — | Node.js 22+ | 免費 | 否 | 低 | 開發者、macOS/Linux 用戶 |
| npm | — | Node.js 22+ | 免費 | 否 | 低 | 開發者、macOS/Linux 用戶 |
| Docker | — | Docker Engine | 免費 | 否 | 中 | 熟悉容器的開發者 |
| 阿里雲 | 是 | 2C2G 40GB | 9.9元/月 | 是（qwen3.5-plus） | 極低（3 步） | 中國大陸首選，新手友善 |
| 騰訊雲 | 是 | 2C2G | ~17元/月 | 否（需購 Coding Plan） | 極低（3 步） | 企業微信/QQ 生態用戶 |
| 百度雲 | 是 | 2C4G | 0.01元首月 | 是（千帆模型） | 極低（4 步） | 體驗嘗鮮，文心生態 |
| 華為雲 | 是 | Flexus L 實例 | ~85元/月起 | 否（需接 MaaS） | 中等（5 步以上） | 企業用戶，合規需求 |
| 火山引擎 | 是 | 2C4G | 9.9元/月 | 是（方舟模型） | 低（3-4 步） | 飛書用戶首選 |
| 扣子編程 | 是 | 無需伺服器 | ¥49/月起 | 是（Seed 2.0 等） | 極低（2 步） | 零門檻，不想管伺服器 |
| Railway | 是 | 自動分配 | $5/月免費額度 | 否 | 極低（1 鍵） | 海外用戶，開發者 |
| Zeabur | 是 | 2C4G 專用 | 按用量計費 | 是（AI Hub） | 極低（模板） | 需要多模型 failover |
核心建議
模型費用才是大頭。 伺服器成本普遍已降到很低（9.9-99元/年），真正的持續成本在於模型呼叫。選平台時重點看模型方案價格，而不是只看伺服器價格。
本機安裝
本機安裝適合開發者和想完全掌控資料的用戶。OpenClaw 是 TypeScript 專案，運行在 Node.js 上。
系統需求
| 需求 | 詳情 |
|---|---|
| Node.js | >= 22（強制要求） |
| 套件管理器 | npm / pnpm / bun 均可 |
| macOS | 需要 Xcode Command Line Tools |
| Linux | 標準建置工具（gcc、make） |
| Windows | 強烈建議使用 WSL2 |
方式一：npm 全域安裝（推薦）
最推薦的安裝方式，兩條命令搞定：
# 安裝 OpenClaw
npm install -g openclaw@latest
# 初始化並安裝常駐程序
openclaw onboard --install-daemon
onboard 命令會引導你完成初始設定，包括選擇模型、設定 API 金鑰、設定訊息頻道等。--install-daemon 參數會同時安裝常駐程序，讓 OpenClaw 在背景持續執行。
方式二：一鍵腳本安裝（macOS / Linux）
如果你不想手動安裝 Node.js，可以使用官方提供的一鍵安裝腳本：
curl -fsSL https://openclaw.ai/install.sh | bash
注意：此命令僅適用於 macOS 和 Linux。Windows 用戶請先使用 WSL2 再執行。
macOS 額外準備
macOS 用戶在安裝前需要確保已安裝 Xcode Command Line Tools：
xcode-select --install
如果你需要使用 iMessage 頻道或 Apple Notes 技能，這些依賴 macOS 原生的 AppleScript 能力，只有在 macOS 上才能執行。
Windows 用戶注意
重要：OpenClaw 官方強烈建議 Windows 用戶透過 WSL2（Windows Subsystem for Linux）執行。直接在 Windows 原生環境下執行可能遇到路徑、權限等相容性問題。
安裝 WSL2 後，在 Ubuntu 終端機內按 Linux 流程安裝即可。
常駐程序（Daemon）
常駐程序讓 OpenClaw 在背景持續執行，即使關閉終端機也不會中斷。不同系統使用不同的程序管理方式：
| 系統 | 程序管理 | 說明 |
|---|---|---|
| macOS | launchd | macOS 原生服務管理，開機自動啟動 |
| Linux | systemd | Linux 標準服務管理，由 systemctl 控制 |
安裝常駐程序後，OpenClaw Gateway 會在 ws://127.0.0.1:18789 持續監聽。
Docker 部署
Docker 部署適合需要環境隔離、方便遷移、或在伺服器上長期執行的場景。
docker-compose 快速啟動
OpenClaw 儲存庫內建了 docker-compose.yml，一條命令即可啟動：
# 複製儲存庫
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 啟動
docker-compose up -d
映像檔變體
| 變體 | 說明 | 適用場景 |
|---|---|---|
| 標準映像檔 | 完整功能，包含所有擴充相依套件 | 一般使用，功能全 |
| slim 變體 | 多階段建置，體積更小 | 資源受限環境，CI/CD |
| sandbox | 沙箱環境 | 安全隔離，程式碼執行 |
| sandbox-browser | 含瀏覽器的沙箱 | 需要瀏覽器自動化 |
使用 slim 變體：在 docker-compose.yml 中設定環境變數 OPENCLAW_VARIANT=slim。
掛載目錄
Docker 部署需要掛載兩個關鍵目錄，確保資料持久化：
volumes:
- ~/.openclaw:/root/.openclaw # 設定和狀態資料
- ~/openclaw/workspace:/workspace # 工作區（YAML 設定檔）
重要：不掛載這兩個目錄，容器重啟後所有設定和對話紀錄都會遺失。
連接埠映射
OpenClaw Gateway 預設監聽 18789 埠（WebSocket），Web UI 預設使用 3000 埠：
ports:
- "18789:18789" # Gateway WebSocket
- "3000:3000" # Web UI
Podman 相容
OpenClaw 同樣支援 Podman 執行：
# 使用 Podman 啟動
podman-compose up -d
對於需要 rootless 容器執行的環境（如企業安全策略要求），Podman 是更合適的選擇。
中國大陸雲端廠商一鍵部署
這是大多數中國大陸用戶的首選方案。所有主流雲端廠商都已支援 OpenClaw 一鍵部署。
阿里雲 Alibaba Cloud
中國大陸社群資源最豐富的平台，映像檔預裝，開箱即用。
| 項目 | 詳情 |
|---|---|
| 配置 | 2 vCPU + 2 GiB 記憶體 + 40 GiB ESSD 系統碟 |
| 系統 | Alibaba Cloud Linux 3，預裝 OpenClaw 映像檔 |
| 價格 | 限時秒殺 9.9元/月，包年常規優惠低至 68元/年 |
| 模型 | 預設內建 qwen3.5-plus；百煉 Coding Plan Lite 首月 10元 |
| IM 支援 | 釘釘、飛書等（透過 openclaw-china 外掛） |
部署步驟：
- 一鍵購買：進入活動頁，購買預裝 OpenClaw 映像檔的輕量應用伺服器
- 開通連接埠 + 設定：在安全性群組中放行 18789（Gateway）和 3000（Web UI）埠
- 存取 Web UI：瀏覽器開啟
http://你的IP:3000
騰訊雲 Tencent Cloud
四大 IM 全面支援，Coding Plan 模型方案性價比高。
部署步驟：
- 購買 Lighthouse 實例
- 選擇 OpenClaw 模板：應用模板 → AI 智慧代理 → OpenClaw
- 設定模型 + 接入 IM：購買 Coding Plan 後接入企業微信/QQ/飛書/釘釘
火山引擎 Volcengine
飛書用戶首選，與飛書生態深度整合。
扣子編程
零門檻方案，無需管理伺服器。
| 項目 | 詳情 |
|---|---|
| 價格 | ¥49/月起 |
| 模型 | 內建 Seed 2.0 等 |
| 難度 | 極低（2 步） |
| 適合 | 不想管伺服器的用戶 |
首次設定
初始化流程
- 設定管理員密碼：首次存取 Web UI 時設定
- 新增 AI 模型：設定 API 金鑰
- 選擇預設模型：設定主要使用的模型
- 設定渠道（可選）：接入飛書/釘釘/微信等
推薦模型選擇
| 用戶類型 | 推薦模型 | 原因 |
|---|---|---|
| 新手體驗 | Google Gemini | 有免費額度 |
| 中國大陸用戶 | DeepSeek / Kimi | 中國大陸網路友善 |
| 追求品質 | Claude / GPT-4 | 效果最好 |
| 成本敏感 | 本機模型（Ollama） | 完全免費 |
API 金鑰取得
| 模型提供商 | 取得地址 |
|---|---|
| Google Gemini | https://aistudio.google.com/apikey |
| Claude | https://console.anthropic.com/ |
| OpenAI | https://platform.openai.com/api-keys |
| DeepSeek | https://platform.deepseek.com/ |
| Kimi | https://platform.moonshot.cn/ |
推薦下一步（手把手）
若你優先 本機先跑通（最常見路徑），請直接跟：
雲端 7×24 見雲伺服器部署；踩坑見本機疑難排解 2026。
Quelle: OpenClaw Orange Paper v1.2.0, Kapitel 10-14
Überblick über die Bereitstellungsoptionen
OpenClaw unterstützt eine Vielzahl von Bereitstellungsoptionen, von lokal bis Cloud. Welche Sie wählen, hängt von Ihren technischen Fähigkeiten, Ihrem Budget und Ihrem Anwendungsfall ab.
Vergleich der Bereitstellungsoptionen
| Plattform | One-Click-Bereitstellung | Minimale Konfiguration | Neukundenpreis | Eingebaute Modelle | Schwierigkeit | Am besten für |
|---|---|---|---|---|---|---|
| Lokal | — | Node.js 22+ | Kostenlos | Nein | Niedrig | Entwickler, macOS-/Linux-Nutzer |
| npm | — | Node.js 22+ | Kostenlos | Nein | Niedrig | Entwickler, macOS-/Linux-Nutzer |
| Docker | — | Docker Engine | Kostenlos | Nein | Mittel | Container-erfahrene Entwickler |
| Alibaba Cloud | Ja | 2C2G 40GB | ¥9.9/Monat | Ja (qwen3.5-plus) | Sehr niedrig (3 Schritte) | Top-Empfehlung in Festlandchina, einsteigerfreundlich |
| Tencent Cloud | Ja | 2C2G | ~¥17/Monat | Nein (Coding Plan erforderlich) | Sehr niedrig (3 Schritte) | Nutzer des WeCom/QQ-Ökosystems |
| Baidu Cloud | Ja | 2C4G | ¥0.01 für den ersten Monat | Ja (Qianfan-Modelle) | Sehr niedrig (4 Schritte) | Schnelle Tests, ERNIE-Ökosystem |
| Huawei Cloud | Ja | Flexus-L-Instanz | Ab ~¥85/Monat | Nein (MaaS erforderlich) | Mittel (5+ Schritte) | Unternehmensnutzer, Compliance-Anforderungen |
| Volcengine | Ja | 2C4G | ¥9.9/Monat | Ja (Ark-Modelle) | Niedrig (3-4 Schritte) | Top-Empfehlung für Feishu-Nutzer |
| Coze Coding | Ja | Kein Server nötig | Ab ¥49/Monat | Ja (Seed 2.0 usw.) | Sehr niedrig (2 Schritte) | Null Hürden, keine Serververwaltung |
| Railway | Ja | Automatisch zugewiesen | $5/Monat kostenloses Guthaben | Nein | Sehr niedrig (1 Klick) | Nutzer außerhalb Chinas, Entwickler |
| Zeabur | Ja | Dediziert 2C4G | Nutzungsbasierte Abrechnung | Ja (AI Hub) | Sehr niedrig (Vorlage) | Bedarf an Multi-Model-Failover |
Wichtiger Hinweis
Die Modellkosten sind der eigentliche Kostenpunkt. Die Serverkosten sind allgemein bereits stark gefallen (¥9.9-99/Jahr); die tatsächlich laufenden Kosten sind die API-Aufrufe der Modelle. Achten Sie bei der Plattformwahl vor allem auf die Preise der Modellpakete und nicht nur auf den Serverpreis.
Lokale Installation
Die lokale Installation eignet sich für Entwickler und Nutzer, die ihre Daten vollständig selbst kontrollieren möchten. OpenClaw ist ein TypeScript-Projekt, das auf Node.js läuft.
Systemanforderungen
| Anforderung | Details |
|---|---|
| Node.js | >= 22 (Pflicht) |
| Paketmanager | npm / pnpm / bun funktionieren alle |
| macOS | Xcode Command Line Tools erforderlich |
| Linux | Standard-Build-Tools (gcc, make) |
| Windows | WSL2 dringend empfohlen |
Option 1: Globale npm-Installation (empfohlen)
Die am meisten empfohlene Installationsmethode — nur zwei Befehle:
# Install OpenClaw
npm install -g openclaw@latest
# Initialize and install the daemon
openclaw onboard --install-daemon
Der Befehl onboard führt Sie durch die Ersteinrichtung, einschließlich der Auswahl eines Modells, der Konfiguration von API-Schlüsseln und dem Einrichten von Messaging-Kanälen. Das Flag --install-daemon installiert zusätzlich den Daemon, damit OpenClaw im Hintergrund weiterläuft.
Option 2: Installation per Einzeilen-Skript (macOS / Linux)
Wenn Sie Node.js nicht manuell installieren möchten, nutzen Sie das offizielle Einzeilen-Installationsskript:
curl -fsSL https://openclaw.ai/install.sh | bash
Hinweis: Dieser Befehl gilt nur für macOS und Linux. Windows-Nutzer sollten zuerst WSL2 einrichten und ihn anschließend ausführen.
Zusätzliche Vorbereitung unter macOS
Vor der Installation müssen macOS-Nutzer sicherstellen, dass die Xcode Command Line Tools installiert sind:
xcode-select --install
Wenn Sie den iMessage-Kanal oder den Apple-Notes-Skill benötigen, beachten Sie, dass diese auf die macOS-nativen AppleScript-Funktionen angewiesen sind und nur unter macOS laufen.
Ein Hinweis für Windows-Nutzer
Wichtig: OpenClaw empfiehlt offiziell ausdrücklich die Ausführung unter WSL2 (Windows Subsystem for Linux). Der native Betrieb unter Windows kann zu Kompatibilitätsproblemen bei Pfaden, Berechtigungen und mehr führen.
Sobald WSL2 installiert ist, öffnen Sie ein Ubuntu-Terminal und folgen Sie der Linux-Anleitung.
Der Daemon
Der Daemon hält OpenClaw auch nach dem Schließen des Terminals im Hintergrund am Laufen. Verschiedene Systeme verwenden verschiedene Prozessmanager:
| Betriebssystem | Prozessverwaltung | Hinweise |
|---|---|---|
| macOS | launchd | Native Dienstverwaltung unter macOS, startet beim Systemstart |
| Linux | systemd | Standard-Linux-Dienstverwaltung, gesteuert über systemctl |
Mit installiertem Daemon lauscht das OpenClaw Gateway dauerhaft auf ws://127.0.0.1:18789.
Docker-Bereitstellung
Die Docker-Bereitstellung passt zu Szenarien, die Umgebungsisolation, einfache Migration oder den langfristigen Betrieb auf einem Server erfordern.
Schnellstart mit docker-compose
Das OpenClaw-Repository liefert eine eingebaute docker-compose.yml mit — ein Befehl zum Start:
# Clone the repository
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# Start
docker-compose up -d
Image-Varianten
| Variante | Beschreibung | Anwendungsfall |
|---|---|---|
| Standard-Image | Alle Funktionen, inklusive aller Erweiterungsabhängigkeiten | Allgemeine Nutzung, voller Funktionsumfang |
| slim-Variante | Mehrstufiger Build, geringere Größe | Umgebungen mit begrenzten Ressourcen, CI/CD |
| sandbox | Isolierte Sandbox-Umgebung | Sicherheitsisolation, Codeausführung |
| sandbox-browser | Sandbox mit Browser | Für Browser-Automatisierung |
So verwenden Sie die slim-Variante: Setzen Sie in docker-compose.yml die Umgebungsvariable OPENCLAW_VARIANT=slim.
Zu mountierende Volumes
Für die Docker-Bereitstellung müssen zwei wichtige Verzeichnisse gemountet werden, damit die Daten erhalten bleiben:
volumes:
- ~/.openclaw:/root/.openclaw # Config and state data
- ~/openclaw/workspace:/workspace # Workspace (YAML config files)
Wichtig: Ohne das Mounten dieser beiden Verzeichnisse gehen beim Neustart des Containers die gesamte Konfiguration und der Gesprächsverlauf verloren.
Port-Mapping
Das OpenClaw Gateway lauscht standardmäßig auf Port 18789 (WebSocket), und das Web UI nutzt standardmäßig Port 3000:
ports:
- "18789:18789" # Gateway WebSocket
- "3000:3000" # Web UI
Podman-Kompatibilität
OpenClaw läuft auch unter Podman:
# Start with Podman
podman-compose up -d
Für Umgebungen, die rootless Container erfordern (z. B. Sicherheitsrichtlinien von Unternehmen), ist Podman die bessere Wahl.
One-Click-Bereitstellung bei chinesischen Cloud-Anbietern
Dies ist die Standardoption für die meisten Nutzer in Festlandchina. Alle großen chinesischen Cloud-Anbieter unterstützen inzwischen die One-Click-Bereitstellung von OpenClaw.
Alibaba Cloud
Die Plattform mit den reichhaltigsten Community-Ressourcen in China — Image vorinstalliert, sofort einsatzbereit.
| Punkt | Details |
|---|---|
| Konfiguration | 2 vCPU + 2 GiB RAM + 40 GiB ESSD-Systemdatenträger |
| Betriebssystem | Alibaba Cloud Linux 3, mit vorinstalliertem OpenClaw-Image |
| Preis | Zeitlich begrenztes Flash-Angebot ¥9.9/Monat; Jahrespläne ab ¥68/Jahr |
| Modelle | qwen3.5-plus standardmäßig eingebaut; Bailian Coding Plan Lite ¥10 für den ersten Monat |
| IM-Unterstützung | DingTalk, Feishu usw. (über das openclaw-china-Plugin) |
Bereitstellungsschritte:
- One-Click-Kauf: Öffnen Sie die Aktionsseite und kaufen Sie einen Lightweight Application Server mit vorinstalliertem OpenClaw-Image
- Ports öffnen + konfigurieren: Geben Sie die Ports 18789 (Gateway) und 3000 (Web UI) in der Sicherheitsgruppe frei
- Web UI aufrufen: Öffnen Sie
http://YOUR_IP:3000im Browser
Tencent Cloud
Volle Unterstützung für die vier großen IMs, mit kostengünstigen Modellpaketen über den Coding Plan.
Bereitstellungsschritte:
- Kaufen Sie eine Lighthouse-Instanz
- Wählen Sie die OpenClaw-Vorlage: Anwendungsvorlagen → AI Agents → OpenClaw
- Modelle konfigurieren + IMs verbinden: Kaufen Sie einen Coding Plan und verbinden Sie anschließend WeCom/QQ/Feishu/DingTalk
Volcengine
Top-Empfehlung für Feishu-Nutzer, tief in das Feishu-Ökosystem integriert.
Coze Coding
Eine Option ganz ohne Einstiegshürden — kein Server zu verwalten.
| Punkt | Details |
|---|---|
| Preis | Ab ¥49/Monat |
| Modelle | Seed 2.0 und weitere integriert |
| Schwierigkeit | Sehr niedrig (2 Schritte) |
| Am besten für | Nutzer, die keine Server verwalten möchten |
Ersteinrichtung
Initialisierungsablauf
- Administrator-Passwort festlegen: bei Ihrem ersten Besuch des Web UI festlegen
- KI-Modell hinzufügen: einen API-Schlüssel konfigurieren
- Standardmodell auswählen: das Modell festlegen, das Sie am häufigsten nutzen
- Kanäle konfigurieren (optional): Feishu/DingTalk/WeChat usw. verbinden
Empfohlene Modellauswahl
| Nutzertyp | Empfohlenes Modell | Warum |
|---|---|---|
| Erstanwender | Google Gemini | Kostenlose Stufe verfügbar |
| Nutzer in Festlandchina | DeepSeek / Kimi | Gut mit den Netzen in Festlandchina kompatibel |
| Qualität zuerst | Claude / GPT-4 | Beste Ergebnisse |
| Kostenempfindlich | Lokale Modelle (Ollama) | Vollständig kostenlos |
API-Schlüssel beziehen
| Anbieter | Bezugsquelle |
|---|---|
| Google Gemini | https://aistudio.google.com/apikey |
| Claude | https://console.anthropic.com/ |
| OpenAI | https://platform.openai.com/api-keys |
| DeepSeek | https://platform.deepseek.com/ |
| Kimi | https://platform.moonshot.cn/ |
Empfohlener nächster Schritt (Praxis)
Wenn Sie OpenClaw zuerst lokal zum Laufen bringen möchten (der häufigste Weg), folgen Sie direkt dieser Anleitung:
→ OpenClaw auf Ihrem lokalen Rechner bereitstellen (15-30 Minuten)
Für den 24/7-Cloud-Betrieb siehe Cloud-Server-Bereitstellung; häufige Stolpersteine finden Sie unter Lokale Fehlerbehebung 2026.
Source : OpenClaw Orange Paper v1.2.0, chapitres 10-14
Vue d'ensemble des options de déploiement
OpenClaw prend en charge une grande variété d'options de déploiement, du local au cloud. Laquelle choisir dépend de votre niveau technique, de votre budget et de votre cas d'usage.
Comparaison des options de déploiement
| Plateforme | Déploiement en un clic | Configuration minimale | Prix pour les nouveaux utilisateurs | Modèles intégrés | Difficulté | Idéal pour |
|---|---|---|---|---|---|---|
| Local | — | Node.js 22+ | Gratuit | Non | Faible | Développeurs, utilisateurs macOS/Linux |
| npm | — | Node.js 22+ | Gratuit | Non | Faible | Développeurs, utilisateurs macOS/Linux |
| Docker | — | Docker Engine | Gratuit | Non | Moyenne | Développeurs à l'aise avec les conteneurs |
| Alibaba Cloud | Oui | 2C2G 40GB | ¥9.9/mois | Oui (qwen3.5-plus) | Très faible (3 étapes) | Premier choix en Chine continentale, adapté aux débutants |
| Tencent Cloud | Oui | 2C2G | ~¥17/mois | Non (Coding Plan requis) | Très faible (3 étapes) | Utilisateurs de l'écosystème WeCom/QQ |
| Baidu Cloud | Oui | 2C4G | ¥0.01 le premier mois | Oui (modèles Qianfan) | Très faible (4 étapes) | Tests rapides, écosystème ERNIE |
| Huawei Cloud | Oui | Instance Flexus L | À partir de ~¥85/mois | Non (MaaS requis) | Moyenne (5+ étapes) | Utilisateurs en entreprise, besoins de conformité |
| Volcengine | Oui | 2C4G | ¥9.9/mois | Oui (modèles Ark) | Faible (3-4 étapes) | Premier choix pour les utilisateurs de Feishu |
| Coze Coding | Oui | Aucun serveur nécessaire | À partir de ¥49/mois | Oui (Seed 2.0, etc.) | Très faible (2 étapes) | Zéro barrière, aucune gestion de serveur |
| Railway | Oui | Attribution automatique | Crédit gratuit de $5/mois | Non | Très faible (1 clic) | Utilisateurs hors de Chine, développeurs |
| Zeabur | Oui | 2C4G dédié | Facturation à l'usage | Oui (AI Hub) | Très faible (modèle) | Besoins de failover multi-modèles |
Conseil clé
Les coûts des modèles constituent la vraie dépense. Le coût des serveurs a généralement beaucoup baissé (¥9.9-99/an) ; la vraie dépense continue correspond aux appels d'API aux modèles. Lors du choix d'une plateforme, concentrez-vous sur le prix des offres de modèles plutôt que sur le seul prix du serveur.
Installation locale
L'installation locale convient aux développeurs et aux utilisateurs qui souhaitent garder le contrôle total de leurs données. OpenClaw est un projet TypeScript qui s'exécute sur Node.js.
Configuration requise
| Élément requis | Détails |
|---|---|
| Node.js | >= 22 (obligatoire) |
| Gestionnaire de paquets | npm / pnpm / bun fonctionnent tous |
| macOS | Xcode Command Line Tools requis |
| Linux | Outils de compilation standards (gcc, make) |
| Windows | WSL2 fortement recommandé |
Option 1 : installation globale via npm (recommandée)
La méthode d'installation la plus recommandée — deux commandes suffisent :
# Install OpenClaw
npm install -g openclaw@latest
# Initialize and install the daemon
openclaw onboard --install-daemon
La commande onboard vous guide dans la configuration initiale, y compris le choix d'un modèle, la configuration des clés API et la mise en place des canaux de messagerie. L'option --install-daemon installe également le démon pour qu'OpenClaw continue de fonctionner en arrière-plan.
Option 2 : installation par script en une ligne (macOS / Linux)
Si vous préférez ne pas installer Node.js manuellement, utilisez le script officiel d'installation en une ligne :
curl -fsSL https://openclaw.ai/install.sh | bash
Remarque : cette commande est réservée à macOS et Linux. Les utilisateurs de Windows doivent d'abord configurer WSL2 avant de l'exécuter.
Préparation supplémentaire sous macOS
Avant l'installation, les utilisateurs de macOS doivent s'assurer que les Xcode Command Line Tools sont installés :
xcode-select --install
Si vous avez besoin du canal iMessage ou de la compétence Apple Notes, notez qu'ils reposent sur les capacités AppleScript natives de macOS et ne fonctionnent que sur macOS.
À noter pour les utilisateurs de Windows
Important : OpenClaw recommande officiellement et fortement l'exécution sous WSL2 (Windows Subsystem for Linux). Un fonctionnement natif sous Windows peut entraîner des problèmes de compatibilité liés aux chemins, aux permissions, etc.
Une fois WSL2 installé, ouvrez un terminal Ubuntu et suivez les instructions pour Linux.
Le démon
Le démon maintient OpenClaw en arrière-plan, même après la fermeture du terminal. Chaque système utilise un gestionnaire de processus différent :
| Système | Gestion des processus | Remarques |
|---|---|---|
| macOS | launchd | Gestion de services native de macOS, démarre au démarrage |
| Linux | systemd | Gestion de services standard de Linux, contrôlée via systemctl |
Une fois le démon installé, la passerelle OpenClaw Gateway reste à l'écoute sur ws://127.0.0.1:18789.
Déploiement Docker
Le déploiement Docker convient aux scénarios nécessitant l'isolement d'environnement, une migration facile ou un fonctionnement à long terme sur un serveur.
Démarrage rapide avec docker-compose
Le dépôt OpenClaw inclut un fichier docker-compose.yml intégré — une seule commande pour démarrer :
# Clone the repository
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# Start
docker-compose up -d
Variantes d'images
| Variante | Description | Cas d'usage |
|---|---|---|
| Image standard | Toutes les fonctionnalités, toutes les dépendances d'extension incluses | Usage général, fonctionnalités complètes |
| Variante slim | Construction multi-étapes, taille réduite | Environnements à ressources limitées, CI/CD |
| sandbox | Environnement bac à sable | Isolation de sécurité, exécution de code |
| sandbox-browser | Bac à sable avec navigateur | Besoins d'automatisation de navigateur |
Pour utiliser la variante slim : définissez la variable d'environnement OPENCLAW_VARIANT=slim dans docker-compose.yml.
Volumes à monter
Le déploiement Docker nécessite le montage de deux répertoires clés pour garantir la persistance des données :
volumes:
- ~/.openclaw:/root/.openclaw # Config and state data
- ~/openclaw/workspace:/workspace # Workspace (YAML config files)
Important : sans le montage de ces deux répertoires, toute la configuration et l'historique des conversations seront perdus lors du redémarrage du conteneur.
Mappage des ports
La passerelle OpenClaw Gateway écoute par défaut sur le port 18789 (WebSocket), et l'interface Web utilise par défaut le port 3000 :
ports:
- "18789:18789" # Gateway WebSocket
- "3000:3000" # Web UI
Compatibilité Podman
OpenClaw fonctionne également sous Podman :
# Start with Podman
podman-compose up -d
Pour les environnements qui exigent des conteneurs rootless (par exemple les politiques de sécurité d'entreprise), Podman est le meilleur choix.
Déploiement en un clic chez les fournisseurs cloud chinois
C'est l'option de référence pour la plupart des utilisateurs en Chine continentale. Tous les grands fournisseurs cloud chinois prennent désormais en charge le déploiement d'OpenClaw en un clic.
Alibaba Cloud
La plateforme disposant des ressources communautaires les plus riches en Chine — image préinstallée, fonctionne immédiatement.
| Élément | Détails |
|---|---|
| Configuration | 2 vCPU + 2 GiB RAM + 40 GiB de disque système ESSD |
| OS | Alibaba Cloud Linux 3, avec l'image OpenClaw préinstallée |
| Prix | Offre flash à durée limitée ¥9.9/mois ; formules annuelles dès ¥68/an |
| Modèles | qwen3.5-plus intégré par défaut ; Bailian Coding Plan Lite à ¥10 le premier mois |
| Prise en charge de la messagerie | DingTalk, Feishu, etc. (via le plugin openclaw-china) |
Étapes de déploiement :
- Achat en un clic : ouvrez la page de la campagne et achetez un Lightweight Application Server avec l'image OpenClaw préinstallée
- Ouverture des ports + configuration : autorisez les ports 18789 (Gateway) et 3000 (interface Web) dans le groupe de sécurité
- Accédez à l'interface Web : ouvrez
http://YOUR_IP:3000dans un navigateur
Tencent Cloud
Prise en charge complète des quatre grandes messageries, avec des offres de modèles Coding Plan très économiques.
Étapes de déploiement :
- Achetez une instance Lighthouse
- Choisissez le modèle OpenClaw : Application Templates → AI Agents → OpenClaw
- Configurez les modèles + connectez les messageries : achetez un Coding Plan, puis connectez WeCom/QQ/Feishu/DingTalk
Volcengine
Premier choix pour les utilisateurs de Feishu, profondément intégré à l'écosystème Feishu.
Coze Coding
Une option sans aucune barrière — aucun serveur à gérer.
| Élément | Détails |
|---|---|
| Prix | À partir de ¥49/mois |
| Modèles | Seed 2.0 et d'autres intégrés |
| Difficulté | Très faible (2 étapes) |
| Idéal pour | Les utilisateurs qui ne veulent pas gérer de serveurs |
Première configuration
Flux d'initialisation
- Définir un mot de passe administrateur : à définir lors de votre première visite de l'interface Web
- Ajouter un modèle d'IA : configurez une clé API
- Choisir un modèle par défaut : définissez le modèle que vous utiliserez le plus
- Configurer les canaux (facultatif) : connectez Feishu/DingTalk/WeChat, etc.
Choix de modèles recommandés
| Type d'utilisateur | Modèle recommandé | Pourquoi |
|---|---|---|
| Premiers pas | Google Gemini | Offre gratuite disponible |
| Utilisateurs en Chine continentale | DeepSeek / Kimi | Adaptés aux réseaux de Chine continentale |
| Qualité d'abord | Claude / GPT-4 | Meilleurs résultats |
| Sensibles aux coûts | Modèles locaux (Ollama) | Totalement gratuit |
Obtenir les clés API
| Fournisseur | Où l'obtenir |
|---|---|
| Google Gemini | https://aistudio.google.com/apikey |
| Claude | https://console.anthropic.com/ |
| OpenAI | https://platform.openai.com/api-keys |
| DeepSeek | https://platform.deepseek.com/ |
| Kimi | https://platform.moonshot.cn/ |
Prochaine étape recommandée (pratique)
Si vous voulez d'abord le faire fonctionner en local (le chemin le plus courant), suivez directement ceci :
→ Déployer OpenClaw sur votre machine locale (15-30 minutes)
Pour un fonctionnement cloud 24/7, voir Déploiement sur serveur cloud ; pour les pièges fréquents, voir Dépannage local 2026.
Fuente: OpenClaw Orange Paper v1.2.0, capítulos 10-14
Resumen de las opciones de despliegue
OpenClaw admite una gran variedad de opciones de despliegue, desde local hasta la nube. Cuál elegir depende de tu nivel técnico, tu presupuesto y tu caso de uso.
Comparación de las opciones de despliegue
| Plataforma | Despliegue en un clic | Configuración mínima | Precio para nuevos usuarios | Modelos integrados | Dificultad | Ideal para |
|---|---|---|---|---|---|---|
| Local | — | Node.js 22+ | Gratis | No | Baja | Desarrolladores, usuarios de macOS/Linux |
| npm | — | Node.js 22+ | Gratis | No | Baja | Desarrolladores, usuarios de macOS/Linux |
| Docker | — | Docker Engine | Gratis | No | Media | Desarrolladores con experiencia en contenedores |
| Alibaba Cloud | Sí | 2C2G 40GB | ¥9.9/mes | Sí (qwen3.5-plus) | Muy baja (3 pasos) | Opción principal en China continental, apta para principiantes |
| Tencent Cloud | Sí | 2C2G | ~¥17/mes | No (requiere Coding Plan) | Muy baja (3 pasos) | Usuarios del ecosistema WeCom/QQ |
| Baidu Cloud | Sí | 2C4G | ¥0.01 el primer mes | Sí (modelos Qianfan) | Muy baja (4 pasos) | Pruebas rápidas, ecosistema ERNIE |
| Huawei Cloud | Sí | Instancia Flexus L | Desde ~¥85/mes | No (requiere MaaS) | Media (5+ pasos) | Usuarios empresariales, necesidades de cumplimiento |
| Volcengine | Sí | 2C4G | ¥9.9/mes | Sí (modelos Ark) | Baja (3-4 pasos) | Opción principal para usuarios de Feishu |
| Coze Coding | Sí | Sin servidor necesario | Desde ¥49/mes | Sí (Seed 2.0, etc.) | Muy baja (2 pasos) | Sin barreras, sin gestión de servidores |
| Railway | Sí | Asignación automática | $5/mes de crédito gratis | No | Muy baja (1 clic) | Usuarios internacionales, desarrolladores |
| Zeabur | Sí | 2C4G dedicado | Facturación por uso | Sí (AI Hub) | Muy baja (plantilla) | Necesidades de failover multimodelo |
Consejo clave
El gasto real son los costes de los modelos. El coste de los servidores ha bajado mucho en general (¥9.9-99/año); el coste continuo real son las llamadas a las API de los modelos. Al elegir una plataforma, fíjate en el precio de los paquetes de modelos y no solo en el precio del servidor.
Instalación local
La instalación local es adecuada para desarrolladores y usuarios que quieren control total sobre sus datos. OpenClaw es un proyecto TypeScript que se ejecuta sobre Node.js.
Requisitos del sistema
| Requisito | Detalles |
|---|---|
| Node.js | >= 22 (obligatorio) |
| Gestor de paquetes | npm / pnpm / bun, todos sirven |
| macOS | Se necesitan las Xcode Command Line Tools |
| Linux | Herramientas de compilación estándar (gcc, make) |
| Windows | Se recomienda encarecidamente WSL2 |
Opción 1: instalación global con npm (recomendada)
El método de instalación más recomendado — solo dos comandos:
# Install OpenClaw
npm install -g openclaw@latest
# Initialize and install the daemon
openclaw onboard --install-daemon
El comando onboard te guía en la configuración inicial, incluida la elección del modelo, la configuración de las claves API y la puesta en marcha de los canales de mensajería. El parámetro --install-daemon instala también el demonio para que OpenClaw siga funcionando en segundo plano.
Opción 2: instalación con un script de una línea (macOS / Linux)
Si prefieres no instalar Node.js manualmente, usa el script oficial de instalación en una línea:
curl -fsSL https://openclaw.ai/install.sh | bash
Nota: este comando es solo para macOS y Linux. Los usuarios de Windows deben configurar primero WSL2 y luego ejecutarlo.
Preparación adicional en macOS
Antes de instalar, los usuarios de macOS deben asegurarse de tener instaladas las Xcode Command Line Tools:
xcode-select --install
Si necesitas el canal de iMessage o la habilidad de Apple Notes, ten en cuenta que dependen de las capacidades nativas de AppleScript de macOS y solo funcionan en macOS.
Nota para los usuarios de Windows
Importante: OpenClaw recomienda oficialmente de forma contundente ejecutarse en WSL2 (Windows Subsystem for Linux). Ejecutarlo de forma nativa en Windows puede provocar problemas de compatibilidad con rutas, permisos y más.
Una vez instalado WSL2, abre un terminal de Ubuntu y sigue las instrucciones para Linux.
El demonio
El demonio mantiene OpenClaw funcionando en segundo plano, incluso después de cerrar el terminal. Los distintos sistemas usan distintos gestores de procesos:
| Sistema | Gestión de procesos | Notas |
|---|---|---|
| macOS | launchd | Gestión de servicios nativa de macOS, se inicia al arrancar |
| Linux | systemd | Gestión de servicios estándar de Linux, controlada con systemctl |
Con el demonio instalado, el OpenClaw Gateway queda escuchando en ws://127.0.0.1:18789.
Despliegue con Docker
El despliegue con Docker encaja en escenarios que necesitan aislamiento del entorno, migración sencilla u operación a largo plazo en un servidor.
Inicio rápido con docker-compose
El repositorio de OpenClaw incluye un docker-compose.yml integrado — un solo comando para arrancar:
# Clone the repository
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# Start
docker-compose up -d
Variantes de imagen
| Variante | Descripción | Caso de uso |
|---|---|---|
| Imagen estándar | Todas las funciones, con todas las dependencias de extensiones | Uso general, funcionalidad completa |
| Variante slim | Compilación en varias etapas, menor tamaño | Entornos con recursos limitados, CI/CD |
| sandbox | Entorno aislado (sandbox) | Aislamiento de seguridad, ejecución de código |
| sandbox-browser | Sandbox con navegador | Necesidades de automatización de navegador |
Para usar la variante slim: define la variable de entorno OPENCLAW_VARIANT=slim en docker-compose.yml.
Volúmenes a montar
El despliegue con Docker requiere montar dos directorios clave para que los datos persistan:
volumes:
- ~/.openclaw:/root/.openclaw # Config and state data
- ~/openclaw/workspace:/workspace # Workspace (YAML config files)
Importante: sin montar estos dos directorios, se perderán toda la configuración y el historial de conversaciones cuando el contenedor se reinicie.
Mapeo de puertos
El OpenClaw Gateway escucha por defecto en el puerto 18789 (WebSocket) y la interfaz web usa por defecto el puerto 3000:
ports:
- "18789:18789" # Gateway WebSocket
- "3000:3000" # Web UI
Compatibilidad con Podman
OpenClaw también funciona en Podman:
# Start with Podman
podman-compose up -d
Para entornos que exigen contenedores rootless (por ejemplo, políticas de seguridad corporativas), Podman es la mejor opción.
Despliegue en un clic en proveedores cloud chinos
Es la opción habitual para la mayoría de usuarios de China continental. Todos los grandes proveedores cloud chinos ya admiten el despliegue de OpenClaw en un clic.
Alibaba Cloud
La plataforma con los recursos de comunidad más ricos de China — imagen preinstalada, lista para usar.
| Elemento | Detalles |
|---|---|
| Configuración | 2 vCPU + 2 GiB de RAM + 40 GiB de disco de sistema ESSD |
| Sistema | Alibaba Cloud Linux 3, con la imagen de OpenClaw preinstalada |
| Precio | Oferta flash por tiempo limitado ¥9.9/mes; planes anuales desde ¥68/año |
| Modelos | qwen3.5-plus integrado por defecto; Bailian Coding Plan Lite ¥10 el primer mes |
| Soporte de IM | DingTalk, Feishu, etc. (mediante el plugin openclaw-china) |
Pasos de despliegue:
- Compra en un clic: abre la página de la campaña y compra un Lightweight Application Server con la imagen de OpenClaw preinstalada
- Abrir puertos + configurar: permite los puertos 18789 (Gateway) y 3000 (interfaz web) en el grupo de seguridad
- Visita la interfaz web: abre
http://YOUR_IP:3000en un navegador
Tencent Cloud
Soporte completo de las cuatro grandes mensajerías, con paquetes de modelos Coding Plan muy rentables.
Pasos de despliegue:
- Compra una instancia Lighthouse
- Elige la plantilla de OpenClaw: Plantillas de aplicaciones → AI Agents → OpenClaw
- Configura modelos + conecta mensajerías: compra un Coding Plan y conecta WeCom/QQ/Feishu/DingTalk
Volcengine
Opción principal para usuarios de Feishu, con una integración profunda en el ecosistema de Feishu.
Coze Coding
Una opción sin barreras — sin servidor que gestionar.
| Elemento | Detalles |
|---|---|
| Precio | Desde ¥49/mes |
| Modelos | Seed 2.0 y más integrados |
| Dificultad | Muy baja (2 pasos) |
| Ideal para | Usuarios que no quieren gestionar servidores |
Configuración inicial
Flujo de inicialización
- Establecer una contraseña de administrador: configúrala en tu primera visita a la interfaz web
- Añadir un modelo de IA: configura una clave API
- Elegir un modelo predeterminado: define el modelo que más usarás
- Configurar canales (opcional): conecta Feishu/DingTalk/WeChat, etc.
Elección de modelos recomendada
| Tipo de usuario | Modelo recomendado | Por qué |
|---|---|---|
| Principiantes | Google Gemini | Dispone de nivel gratuito |
| Usuarios de China continental | DeepSeek / Kimi | Funcionan bien en las redes de China continental |
| Calidad ante todo | Claude / GPT-4 | Mejores resultados |
| Sensible al coste | Modelos locales (Ollama) | Completamente gratis |
Obtención de claves API
| Proveedor | Dónde conseguirla |
|---|---|
| Google Gemini | https://aistudio.google.com/apikey |
| Claude | https://console.anthropic.com/ |
| OpenAI | https://platform.openai.com/api-keys |
| DeepSeek | https://platform.deepseek.com/ |
| Kimi | https://platform.moonshot.cn/ |
Siguiente paso recomendado (práctico)
Si quieres ponerlo en marcha primero en local (la ruta más habitual), sigue directamente esto:
→ Despliega OpenClaw en tu máquina local (15-30 minutos)
Para un funcionamiento en la nube 24/7 consulta Despliegue en servidor cloud; para los errores más comunes, consulta Resolución de problemas en local 2026.
Fuente: OpenClaw Orange Paper v1.2.0, capítulos 10-14
Resumen de las opciones de despliegue
OpenClaw admite una gran variedad de opciones de despliegue, desde local hasta la nube. Cuál elegir depende de tu nivel técnico, tu presupuesto y tu caso de uso.
Comparación de las opciones de despliegue
| Plataforma | Despliegue en un clic | Configuración mínima | Precio para nuevos usuarios | Modelos integrados | Dificultad | Ideal para |
|---|---|---|---|---|---|---|
| Local | — | Node.js 22+ | Gratis | No | Baja | Desarrolladores, usuarios de macOS/Linux |
| npm | — | Node.js 22+ | Gratis | No | Baja | Desarrolladores, usuarios de macOS/Linux |
| Docker | — | Docker Engine | Gratis | No | Media | Desarrolladores con experiencia en contenedores |
| Alibaba Cloud | Sí | 2C2G 40GB | ¥9.9/mes | Sí (qwen3.5-plus) | Muy baja (3 pasos) | Opción principal en China continental, apta para principiantes |
| Tencent Cloud | Sí | 2C2G | ~¥17/mes | No (requiere Coding Plan) | Muy baja (3 pasos) | Usuarios del ecosistema WeCom/QQ |
| Baidu Cloud | Sí | 2C4G | ¥0.01 el primer mes | Sí (modelos Qianfan) | Muy baja (4 pasos) | Pruebas rápidas, ecosistema ERNIE |
| Huawei Cloud | Sí | Instancia Flexus L | Desde ~¥85/mes | No (requiere MaaS) | Media (5+ pasos) | Usuarios empresariales, necesidades de cumplimiento |
| Volcengine | Sí | 2C4G | ¥9.9/mes | Sí (modelos Ark) | Baja (3-4 pasos) | Opción principal para usuarios de Feishu |
| Coze Coding | Sí | Sin servidor necesario | Desde ¥49/mes | Sí (Seed 2.0, etc.) | Muy baja (2 pasos) | Sin barreras, sin gestión de servidores |
| Railway | Sí | Asignación automática | $5/mes de crédito gratis | No | Muy baja (1 clic) | Usuarios internacionales, desarrolladores |
| Zeabur | Sí | 2C4G dedicado | Facturación por uso | Sí (AI Hub) | Muy baja (plantilla) | Necesidades de failover multimodelo |
Consejo clave
El gasto real son los costes de los modelos. El coste de los servidores ha bajado mucho en general (¥9.9-99/año); el coste continuo real son las llamadas a las API de los modelos. Al elegir una plataforma, fíjate en el precio de los paquetes de modelos y no solo en el precio del servidor.
Instalación local
La instalación local es adecuada para desarrolladores y usuarios que quieren control total sobre sus datos. OpenClaw es un proyecto TypeScript que se ejecuta sobre Node.js.
Requisitos del sistema
| Requisito | Detalles |
|---|---|
| Node.js | >= 22 (obligatorio) |
| Gestor de paquetes | npm / pnpm / bun, todos sirven |
| macOS | Se necesitan las Xcode Command Line Tools |
| Linux | Herramientas de compilación estándar (gcc, make) |
| Windows | Se recomienda encarecidamente WSL2 |
Opción 1: instalación global con npm (recomendada)
El método de instalación más recomendado — solo dos comandos:
# Install OpenClaw
npm install -g openclaw@latest
# Initialize and install the daemon
openclaw onboard --install-daemon
El comando onboard te guía en la configuración inicial, incluida la elección del modelo, la configuración de las claves API y la puesta en marcha de los canales de mensajería. El parámetro --install-daemon instala también el demonio para que OpenClaw siga funcionando en segundo plano.
Opción 2: instalación con un script de una línea (macOS / Linux)
Si prefieres no instalar Node.js manualmente, usa el script oficial de instalación en una línea:
curl -fsSL https://openclaw.ai/install.sh | bash
Nota: este comando es solo para macOS y Linux. Los usuarios de Windows deben configurar primero WSL2 y luego ejecutarlo.
Preparación adicional en macOS
Antes de instalar, los usuarios de macOS deben asegurarse de tener instaladas las Xcode Command Line Tools:
xcode-select --install
Si necesitas el canal de iMessage o la habilidad de Apple Notes, ten en cuenta que dependen de las capacidades nativas de AppleScript de macOS y solo funcionan en macOS.
Nota para los usuarios de Windows
Importante: OpenClaw recomienda oficialmente de forma contundente ejecutarse en WSL2 (Windows Subsystem for Linux). Ejecutarlo de forma nativa en Windows puede provocar problemas de compatibilidad con rutas, permisos y más.
Una vez instalado WSL2, abre un terminal de Ubuntu y sigue las instrucciones para Linux.
El demonio
El demonio mantiene OpenClaw funcionando en segundo plano, incluso después de cerrar el terminal. Los distintos sistemas usan distintos gestores de procesos:
| Sistema | Gestión de procesos | Notas |
|---|---|---|
| macOS | launchd | Gestión de servicios nativa de macOS, se inicia al arrancar |
| Linux | systemd | Gestión de servicios estándar de Linux, controlada con systemctl |
Con el demonio instalado, el OpenClaw Gateway queda escuchando en ws://127.0.0.1:18789.
Despliegue con Docker
El despliegue con Docker encaja en escenarios que necesitan aislamiento del entorno, migración sencilla u operación a largo plazo en un servidor.
Inicio rápido con docker-compose
El repositorio de OpenClaw incluye un docker-compose.yml integrado — un solo comando para arrancar:
# Clone the repository
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# Start
docker-compose up -d
Variantes de imagen
| Variante | Descripción | Caso de uso |
|---|---|---|
| Imagen estándar | Todas las funciones, con todas las dependencias de extensiones | Uso general, funcionalidad completa |
| Variante slim | Compilación en varias etapas, menor tamaño | Entornos con recursos limitados, CI/CD |
| sandbox | Entorno aislado (sandbox) | Aislamiento de seguridad, ejecución de código |
| sandbox-browser | Sandbox con navegador | Necesidades de automatización de navegador |
Para usar la variante slim: define la variable de entorno OPENCLAW_VARIANT=slim en docker-compose.yml.
Volúmenes a montar
El despliegue con Docker requiere montar dos directorios clave para que los datos persistan:
volumes:
- ~/.openclaw:/root/.openclaw # Config and state data
- ~/openclaw/workspace:/workspace # Workspace (YAML config files)
Importante: sin montar estos dos directorios, se perderán toda la configuración y el historial de conversaciones cuando el contenedor se reinicie.
Mapeo de puertos
El OpenClaw Gateway escucha por defecto en el puerto 18789 (WebSocket) y la interfaz web usa por defecto el puerto 3000:
ports:
- "18789:18789" # Gateway WebSocket
- "3000:3000" # Web UI
Compatibilidad con Podman
OpenClaw también funciona en Podman:
# Start with Podman
podman-compose up -d
Para entornos que exigen contenedores rootless (por ejemplo, políticas de seguridad corporativas), Podman es la mejor opción.
Despliegue en un clic en proveedores cloud chinos
Es la opción habitual para la mayoría de usuarios de China continental. Todos los grandes proveedores cloud chinos ya admiten el despliegue de OpenClaw en un clic.
Alibaba Cloud
La plataforma con los recursos de comunidad más ricos de China — imagen preinstalada, lista para usar.
| Elemento | Detalles |
|---|---|
| Configuración | 2 vCPU + 2 GiB de RAM + 40 GiB de disco de sistema ESSD |
| Sistema | Alibaba Cloud Linux 3, con la imagen de OpenClaw preinstalada |
| Precio | Oferta flash por tiempo limitado ¥9.9/mes; planes anuales desde ¥68/año |
| Modelos | qwen3.5-plus integrado por defecto; Bailian Coding Plan Lite ¥10 el primer mes |
| Soporte de IM | DingTalk, Feishu, etc. (mediante el plugin openclaw-china) |
Pasos de despliegue:
- Compra en un clic: abre la página de la campaña y compra un Lightweight Application Server con la imagen de OpenClaw preinstalada
- Abrir puertos + configurar: permite los puertos 18789 (Gateway) y 3000 (interfaz web) en el grupo de seguridad
- Visita la interfaz web: abre
http://YOUR_IP:3000en un navegador
Tencent Cloud
Soporte completo de las cuatro grandes mensajerías, con paquetes de modelos Coding Plan muy rentables.
Pasos de despliegue:
- Compra una instancia Lighthouse
- Elige la plantilla de OpenClaw: Plantillas de aplicaciones → AI Agents → OpenClaw
- Configura modelos + conecta mensajerías: compra un Coding Plan y conecta WeCom/QQ/Feishu/DingTalk
Volcengine
Opción principal para usuarios de Feishu, con una integración profunda en el ecosistema de Feishu.
Coze Coding
Una opción sin barreras — sin servidor que gestionar.
| Elemento | Detalles |
|---|---|
| Precio | Desde ¥49/mes |
| Modelos | Seed 2.0 y más integrados |
| Dificultad | Muy baja (2 pasos) |
| Ideal para | Usuarios que no quieren gestionar servidores |
Configuración inicial
Flujo de inicialización
- Establecer una contraseña de administrador: configúrala en tu primera visita a la interfaz web
- Añadir un modelo de IA: configura una clave API
- Elegir un modelo predeterminado: define el modelo que más usarás
- Configurar canales (opcional): conecta Feishu/DingTalk/WeChat, etc.
Elección de modelos recomendada
| Tipo de usuario | Modelo recomendado | Por qué |
|---|---|---|
| Principiantes | Google Gemini | Dispone de nivel gratuito |
| Usuarios de China continental | DeepSeek / Kimi | Funcionan bien en las redes de China continental |
| Calidad ante todo | Claude / GPT-4 | Mejores resultados |
| Sensible al coste | Modelos locales (Ollama) | Completamente gratis |
Obtención de claves API
| Proveedor | Dónde conseguirla |
|---|---|
| Google Gemini | https://aistudio.google.com/apikey |
| Claude | https://console.anthropic.com/ |
| OpenAI | https://platform.openai.com/api-keys |
| DeepSeek | https://platform.deepseek.com/ |
| Kimi | https://platform.moonshot.cn/ |
Siguiente paso recomendado (práctico)
Si quieres ponerlo en marcha primero en local (la ruta más habitual), sigue directamente esto:
→ Despliega OpenClaw en tu máquina local (15-30 minutos)
Para un funcionamiento en la nube 24/7 consulta Despliegue en servidor cloud; para los errores más comunes, consulta Resolución de problemas en local 2026.
Fonte: OpenClaw Orange Paper v1.2.0, capitoli 10-14
Panoramica delle opzioni di distribuzione
OpenClaw supporta una varietà di opzioni di distribuzione, dal locale al cloud. Quale scegliere dipende dalle tue competenze tecniche, dal budget e dal caso d'uso.
Confronto delle opzioni di distribuzione
| Piattaforma | Distribuzione in un clic | Configurazione minima | Prezzo per i nuovi utenti | Modelli integrati | Difficoltà | Ideale per |
|---|---|---|---|---|---|---|
| Locale | — | Node.js 22+ | Gratuito | No | Bassa | Sviluppatori, utenti macOS/Linux |
| npm | — | Node.js 22+ | Gratuito | No | Bassa | Sviluppatori, utenti macOS/Linux |
| Docker | — | Docker Engine | Gratuito | No | Media | Sviluppatori esperti di container |
| Alibaba Cloud | Sì | 2C2G 40GB | ¥9.9/mese | Sì (qwen3.5-plus) | Molto bassa (3 passaggi) | Prima scelta in Cina continentale, adatta ai principianti |
| Tencent Cloud | Sì | 2C2G | ~¥17/mese | No (richiede Coding Plan) | Molto bassa (3 passaggi) | Utenti dell'ecosistema WeCom/QQ |
| Baidu Cloud | Sì | 2C4G | ¥0.01 il primo mese | Sì (modelli Qianfan) | Molto bassa (4 passaggi) | Provare velocemente, ecosistema ERNIE |
| Huawei Cloud | Sì | Istanza Flexus L | Da ~¥85/mese | No (richiede MaaS) | Media (5+ passaggi) | Utenti aziendali, esigenze di conformità |
| Volcengine | Sì | 2C4G | ¥9.9/mese | Sì (modelli Ark) | Bassa (3-4 passaggi) | Prima scelta per gli utenti di Feishu |
| Coze Coding | Sì | Nessun server necessario | Da ¥49/mese | Sì (Seed 2.0, ecc.) | Molto bassa (2 passaggi) | Zero barriere, nessuna gestione del server |
| Railway | Sì | Assegnazione automatica | $5/mese di credito gratuito | No | Molto bassa (1 clic) | Utenti internazionali, sviluppatori |
| Zeabur | Sì | 2C4G dedicato | Fatturazione a consumo | Sì (AI Hub) | Molto bassa (template) | Esigenze di failover multi-modello |
Consiglio chiave
La vera spesa è rappresentata dai costi dei modelli. I costi dei server in genere sono già scesi molto (¥9.9-99/anno); la spesa continuativa reale sono le chiamate alle API dei modelli. Quando scegli una piattaforma, concentra l'attenzione sul prezzo dei pacchetti di modelli e non solo sul prezzo del server.
Installazione locale
L'installazione locale è adatta a sviluppatori e utenti che vogliono il controllo completo dei propri dati. OpenClaw è un progetto TypeScript che gira su Node.js.
Requisiti di sistema
| Requisito | Dettagli |
|---|---|
| Node.js | >= 22 (obbligatorio) |
| Gestore di pacchetti | npm / pnpm / bun, tutti validi |
| macOS | Xcode Command Line Tools richiesti |
| Linux | Strumenti di compilazione standard (gcc, make) |
| Windows | WSL2 fortemente consigliato |
Opzione 1: installazione globale via npm (consigliata)
Il metodo di installazione più consigliato — bastano due comandi:
# Install OpenClaw
npm install -g openclaw@latest
# Initialize and install the daemon
openclaw onboard --install-daemon
Il comando onboard ti guida nella configurazione iniziale, inclusa la scelta del modello, la configurazione delle chiavi API e l'impostazione dei canali di messaggistica. Il flag --install-daemon installa anche il demone, così OpenClaw continua a girare in background.
Opzione 2: installazione con script in una riga (macOS / Linux)
Se preferisci non installare Node.js manualmente, usa lo script ufficiale di installazione in una riga:
curl -fsSL https://openclaw.ai/install.sh | bash
Nota: questo comando è solo per macOS e Linux. Gli utenti Windows devono prima configurare WSL2 e poi eseguirlo.
Preparazione extra su macOS
Prima di installare, gli utenti macOS devono assicurarsi che Xcode Command Line Tools sia installato:
xcode-select --install
Se ti serve il canale iMessage o la skill Apple Notes, tieni presente che dipendono dalle capacità AppleScript native di macOS e funzionano solo su macOS.
Una nota per gli utenti Windows
Importante: OpenClaw consiglia ufficialmente con forza l'esecuzione su WSL2 (Windows Subsystem for Linux). L'esecuzione nativa su Windows può incontrare problemi di compatibilità con percorsi, permessi e altro.
Una volta installato WSL2, apri un terminale Ubuntu e segui le istruzioni per Linux.
Il demone
Il demone mantiene OpenClaw in esecuzione in background, anche dopo la chiusura del terminale. I diversi sistemi usano gestori di processi diversi:
| Sistema | Gestione dei processi | Note |
|---|---|---|
| macOS | launchd | Gestione dei servizi nativa di macOS, si avvia al boot |
| Linux | systemd | Gestione dei servizi standard di Linux, controllata via systemctl |
Con il demone installato, l'OpenClaw Gateway resta in ascolto su ws://127.0.0.1:18789.
Distribuzione con Docker
La distribuzione con Docker è adatta a scenari che richiedono isolamento dell'ambiente, migrazione facile o esercizio a lungo termine su un server.
Avvio rapido con docker-compose
Il repository OpenClaw include un docker-compose.yml integrato — un solo comando per partire:
# Clone the repository
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# Start
docker-compose up -d
Varianti di immagine
| Variante | Descrizione | Caso d'uso |
|---|---|---|
| Immagine standard | Funzioni complete, tutte le dipendenze delle estensioni incluse | Uso generale, funzionalità completa |
| Variante slim | Build multi-stage, dimensioni ridotte | Ambienti con risorse limitate, CI/CD |
| sandbox | Ambiente sandbox | Isolamento di sicurezza, esecuzione di codice |
| sandbox-browser | Sandbox con browser | Esigenze di automazione del browser |
Per usare la variante slim: imposta la variabile d'ambiente OPENCLAW_VARIANT=slim in docker-compose.yml.
Volumi da montare
La distribuzione con Docker richiede il montaggio di due directory chiave per mantenere i dati persistenti:
volumes:
- ~/.openclaw:/root/.openclaw # Config and state data
- ~/openclaw/workspace:/workspace # Workspace (YAML config files)
Importante: senza montare queste due directory, tutta la configurazione e la cronologia delle conversazioni andranno perse al riavvio del container.
Mappatura delle porte
L'OpenClaw Gateway ascolta per impostazione predefinita sulla porta 18789 (WebSocket), mentre l'interfaccia web usa per impostazione predefinita la porta 3000:
ports:
- "18789:18789" # Gateway WebSocket
- "3000:3000" # Web UI
Compatibilità con Podman
OpenClaw funziona anche su Podman:
# Start with Podman
podman-compose up -d
Per gli ambienti che richiedono container rootless (ad esempio policy di sicurezza aziendali), Podman è la scelta migliore.
Distribuzione in un clic sui cloud cinesi
È l'opzione di riferimento per la maggior parte degli utenti nella Cina continentale. Tutti i principali cloud cinesi supportano ormai la distribuzione di OpenClaw in un clic.
Alibaba Cloud
La piattaforma con le risorse di community più ricche in Cina — immagine preinstallata, pronta all'uso.
| Voce | Dettagli |
|---|---|
| Configurazione | 2 vCPU + 2 GiB di RAM + 40 GiB di disco di sistema ESSD |
| Sistema | Alibaba Cloud Linux 3, con immagine OpenClaw preinstallata |
| Prezzo | Offerta flash a tempo limitato ¥9.9/mese; piani annuali a partire da ¥68/anno |
| Modelli | qwen3.5-plus integrato per impostazione predefinita; Bailian Coding Plan Lite ¥10 il primo mese |
| Supporto IM | DingTalk, Feishu, ecc. (tramite il plugin openclaw-china) |
Passaggi di distribuzione:
- Acquisto in un clic: apri la pagina della campagna e acquista un Lightweight Application Server con immagine OpenClaw preinstallata
- Apertura delle porte + configurazione: consenti le porte 18789 (Gateway) e 3000 (interfaccia web) nel gruppo di sicurezza
- Visita l'interfaccia web: apri
http://YOUR_IP:3000nel browser
Tencent Cloud
Supporto completo per le quattro grandi IM, con pacchetti di modelli Coding Plan molto convenienti.
Passaggi di distribuzione:
- Acquista un'istanza Lighthouse
- Scegli il template OpenClaw: Template applicazioni → AI Agents → OpenClaw
- Configura i modelli + collega le IM: acquista un Coding Plan, poi collega WeCom/QQ/Feishu/DingTalk
Volcengine
Prima scelta per gli utenti di Feishu, strettamente integrata con l'ecosistema Feishu.
Coze Coding
Un'opzione senza barriere — nessun server da gestire.
| Voce | Dettagli |
|---|---|
| Prezzo | Da ¥49/mese |
| Modelli | Seed 2.0 e altri integrati |
| Difficoltà | Molto bassa (2 passaggi) |
| Ideale per | Utenti che non vogliono gestire server |
Prima configurazione
Flusso di inizializzazione
- Imposta una password di amministratore: da impostare al primo accesso all'interfaccia web
- Aggiungi un modello di IA: configura una chiave API
- Scegli un modello predefinito: imposta il modello che userai di più
- Configura i canali (facoltativo): collega Feishu/DingTalk/WeChat, ecc.
Scelta dei modelli consigliata
| Tipo di utente | Modello consigliato | Perché |
|---|---|---|
| Principianti | Google Gemini | È disponibile un piano gratuito |
| Utenti nella Cina continentale | DeepSeek / Kimi | Adatti alle reti della Cina continentale |
| Prima la qualità | Claude / GPT-4 | Risultati migliori |
| Attenti ai costi | Modelli locali (Ollama) | Completamente gratuito |
Ottenere le chiavi API
| Provider | Dove ottenerla |
|---|---|
| Google Gemini | https://aistudio.google.com/apikey |
| Claude | https://console.anthropic.com/ |
| OpenAI | https://platform.openai.com/api-keys |
| DeepSeek | https://platform.deepseek.com/ |
| Kimi | https://platform.moonshot.cn/ |
Prossimo passo consigliato (pratica)
Se vuoi farlo prima girare in locale (il percorso più comune), segui direttamente questo:
→ Distribuisci OpenClaw sul tuo computer locale (15-30 minuti)
Per l'esercizio cloud 24/7 vedi Distribuzione su server cloud; per i problemi più comuni vedi Risoluzione dei problemi in locale 2026.
출처: OpenClaw 오렌지 페이퍼(Orange Paper) v1.2.0, 10-14장
배포 방식 개요
OpenClaw는 로컬부터 클라우드까지 다양한 배포 방식을 지원합니다. 어떤 방식을 선택할지는 기술 수준, 예산, 사용 시나리오에 따라 달라집니다.
배포 방식 비교
| 플랫폼 | 원클릭 배포 | 최소 사양 | 신규 사용자 가격 | 내장 모델 | 난이도 | 추천 대상 |
|---|---|---|---|---|---|---|
| 로컬 | — | Node.js 22+ | 무료 | 없음 | 낮음 | 개발자, macOS/Linux 사용자 |
| npm | — | Node.js 22+ | 무료 | 없음 | 낮음 | 개발자, macOS/Linux 사용자 |
| Docker | — | Docker Engine | 무료 | 없음 | 중간 | 컨테이너에 익숙한 개발자 |
| Alibaba Cloud | 있음 | 2C2G 40GB | ¥9.9/월 | 있음 (qwen3.5-plus) | 매우 낮음 (3단계) | 중국 본토 1순위, 초보자에게 적합 |
| Tencent Cloud | 있음 | 2C2G | ~¥17/월 | 없음 (Coding Plan 구매 필요) | 매우 낮음 (3단계) | WeCom/QQ 생태계 사용자 |
| Baidu Cloud | 있음 | 2C4G | 첫 달 ¥0.01 | 있음 (천판 모델) | 매우 낮음 (4단계) | 빠른 체험, ERNIE(문심) 생태계 |
| Huawei Cloud | 있음 | Flexus L 인스턴스 | ~¥85/월부터 | 없음 (MaaS 연결 필요) | 중간 (5단계 이상) | 기업 사용자, 컴플라이언스 필요 |
| Volcengine | 있음 | 2C4G | ¥9.9/월 | 있음 (Ark(방주) 모델) | 낮음 (3-4단계) | Feishu 사용자 1순위 |
| Coze Coding | 있음 | 서버 불필요 | ¥49/월부터 | 있음 (Seed 2.0 등) | 매우 낮음 (2단계) | 진입장벽 없음, 서버 관리 부담 없음 |
| Railway | 있음 | 자동 할당 | $5/월 무료 크레딧 | 없음 | 매우 낮음 (원클릭) | 해외 사용자, 개발자 |
| Zeabur | 있음 | 전용 2C4G | 사용량 기반 과금 | 있음 (AI Hub) | 매우 낮음 (템플릿) | 다중 모델 failover 필요 |
핵심 조언
진짜 비용은 모델 사용료입니다. 서버 비용은 이미 매우 낮아졌고(¥9.9-99/년), 실제로 계속 발생하는 비용은 모델 API 호출입니다. 플랫폼을 선택할 때는 서버 가격만이 아니라 모델 요금제 가격에 집중하십시오.
로컬 설치
로컬 설치는 개발자와 데이터를 완전히 직접 관리하려는 사용자에게 적합합니다. OpenClaw는 TypeScript 프로젝트이며 Node.js 위에서 실행됩니다.
시스템 요구 사항
| 요구 사항 | 세부 사항 |
|---|---|
| Node.js | >= 22 (필수) |
| 패키지 매니저 | npm / pnpm / bun 모두 사용 가능 |
| macOS | Xcode Command Line Tools 필요 |
| Linux | 표준 빌드 도구 (gcc, make) |
| Windows | WSL2를 강력히 권장 |
방식 1: npm 전역 설치 (권장)
가장 권장되는 설치 방법으로, 명령어 두 개면 끝납니다:
# Install OpenClaw
npm install -g openclaw@latest
# Initialize and install the daemon
openclaw onboard --install-daemon
onboard 명령은 모델 선택, API 키 설정, 메시징 채널 설정 등 초기 설정 전체를 안내합니다. --install-daemon 옵션을 붙이면 데몬도 함께 설치되어 OpenClaw가 백그라운드에서 계속 실행됩니다.
방식 2: 원라인 스크립트 설치 (macOS / Linux)
Node.js를 직접 설치하고 싶지 않다면 공식 원라인 설치 스크립트를 사용하십시오:
curl -fsSL https://openclaw.ai/install.sh | bash
참고: 이 명령은 macOS와 Linux 전용입니다. Windows 사용자는 먼저 WSL2를 설정한 후 실행하십시오.
macOS 추가 준비
macOS 사용자는 설치 전에 Xcode Command Line Tools가 설치되어 있는지 확인해야 합니다:
xcode-select --install
iMessage 채널이나 Apple Notes 스킬이 필요하다면, 이들은 macOS 네이티브 AppleScript 기능에 의존하므로 macOS에서만 실행된다는 점에 유의하십시오.
Windows 사용자를 위한 안내
중요: OpenClaw는 공식적으로 WSL2(Windows Subsystem for Linux)에서 실행할 것을 강력히 권장합니다. Windows 네이티브 환경에서 직접 실행하면 경로, 권한 등에서 호환성 문제가 발생할 수 있습니다.
WSL2를 설치한 후에는 Ubuntu 터미널을 열고 Linux 안내에 따라 진행하십시오.
데몬
데몬은 터미널을 닫아도 OpenClaw가 백그라운드에서 계속 실행되도록 유지합니다. 운영체제별로 프로세스 관리 방식이 다릅니다:
| 운영체제 | 프로세스 관리 | 설명 |
|---|---|---|
| macOS | launchd | macOS 네이티브 서비스 관리, 부팅 시 자동 시작 |
| Linux | systemd | Linux 표준 서비스 관리, systemctl로 제어 |
데몬을 설치하면 OpenClaw Gateway가 ws://127.0.0.1:18789에서 계속 대기합니다.
Docker 배포
Docker 배포는 환경 격리, 간편한 이전, 서버에서의 장기 운영이 필요한 시나리오에 적합합니다.
docker-compose로 빠르게 시작
OpenClaw 저장소에는 docker-compose.yml이 기본 포함되어 있어, 명령어 하나로 시작할 수 있습니다:
# Clone the repository
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# Start
docker-compose up -d
이미지 변형
| 변형 | 설명 | 적합한 시나리오 |
|---|---|---|
| 표준 이미지 | 모든 기능, 모든 확장 의존성 포함 | 일반 용도, 전체 기능 |
| slim 변형 | 멀티스테이지 빌드, 크기 더 작음 | 리소스가 제한된 환경, CI/CD |
| sandbox | 샌드박스 환경 | 보안 격리, 코드 실행 |
| sandbox-browser | 브라우저 포함 샌드박스 | 브라우저 자동화 필요 |
slim 변형을 사용하려면: docker-compose.yml에서 환경 변수 OPENCLAW_VARIANT=slim을 설정하십시오.
마운트할 디렉터리
Docker 배포에서는 데이터를 유지하기 위해 두 개의 핵심 디렉터리를 마운트해야 합니다:
volumes:
- ~/.openclaw:/root/.openclaw # Config and state data
- ~/openclaw/workspace:/workspace # Workspace (YAML config files)
중요: 이 두 디렉터리를 마운트하지 않으면 컨테이너 재시작 시 모든 설정과 대화 기록이 사라집니다.
포트 매핑
OpenClaw Gateway는 기본적으로 18789 포트(WebSocket)에서 대기하고, Web UI는 기본적으로 3000 포트를 사용합니다:
ports:
- "18789:18789" # Gateway WebSocket
- "3000:3000" # Web UI
Podman 호환
OpenClaw는 Podman에서도 실행됩니다:
# Start with Podman
podman-compose up -d
rootless 컨테이너 실행이 필요한 환경(예: 기업 보안 정책)에서는 Podman이 더 적합한 선택입니다.
중국 클라우드 원클릭 배포
중국 본토 대부분 사용자에게는 이 방식이 정석입니다. 주요 중국 클라우드 업체 모두 OpenClaw 원클릭 배포를 지원합니다.
Alibaba Cloud
중국에서 커뮤니티 자료가 가장 풍부한 플랫폼으로, 이미지가 미리 설치되어 있어 바로 사용할 수 있습니다.
| 항목 | 세부 사항 |
|---|---|
| 사양 | 2 vCPU + 2 GiB 메모리 + 40 GiB ESSD 시스템 디스크 |
| OS | Alibaba Cloud Linux 3, OpenClaw 이미지 사전 설치 |
| 가격 | 한정 특가 ¥9.9/월, 연간 결제 시 최저 ¥68/년 |
| 모델 | 기본 내장 qwen3.5-plus; Bailian Coding Plan Lite 첫 달 ¥10 |
| IM 지원 | DingTalk, Feishu 등 (openclaw-china 플러그인 경유) |
배포 단계:
- 원클릭 구매: 프로모션 페이지에서 OpenClaw 이미지가 사전 설치된 Lightweight Application Server를 구매
- 포트 개방 + 설정: 보안 그룹에서 18789(Gateway)와 3000(Web UI) 포트 허용
- Web UI 접속: 브라우저에서
http://YOUR_IP:3000열기
Tencent Cloud
4대 IM을 모두 지원하며, Coding Plan 모델 요금제의 가성비가 좋습니다.
배포 단계:
- Lighthouse 인스턴스 구매
- OpenClaw 템플릿 선택: 애플리케이션 템플릿 → AI Agents → OpenClaw
- 모델 설정 + IM 연결: Coding Plan 구매 후 WeCom/QQ/Feishu/DingTalk 연결
Volcengine
Feishu 사용자에게 최적이며, Feishu 생태계와 깊이 통합되어 있습니다.
Coze Coding
서버 관리가 필요 없는, 진입장벽 없는 선택지입니다.
| 항목 | 세부 사항 |
|---|---|
| 가격 | ¥49/월부터 |
| 모델 | Seed 2.0 등 내장 |
| 난이도 | 매우 낮음 (2단계) |
| 추천 대상 | 서버를 관리하고 싶지 않은 사용자 |
초기 설정
초기화 흐름
- 관리자 비밀번호 설정: Web UI 첫 방문 시 설정
- AI 모델 추가: API 키 구성
- 기본 모델 선택: 가장 많이 사용할 모델 설정
- 채널 구성 (선택): Feishu/DingTalk/WeChat 등 연결
추천 모델 선택
| 사용자 유형 | 추천 모델 | 이유 |
|---|---|---|
| 처음 사용하는 사용자 | Google Gemini | 무료 할당량 제공 |
| 중국 본토 사용자 | DeepSeek / Kimi | 중국 본토 네트워크에 친화적 |
| 품질 우선 | Claude / GPT-4 | 최고 성능 |
| 비용 민감 | 로컬 모델 (Ollama) | 완전 무료 |
API 키 발급
| 제공사 | 발급 위치 |
|---|---|
| Google Gemini | https://aistudio.google.com/apikey |
| Claude | https://console.anthropic.com/ |
| OpenAI | https://platform.openai.com/api-keys |
| DeepSeek | https://platform.deepseek.com/ |
| Kimi | https://platform.moonshot.cn/ |
다음 단계 추천 (실습)
먼저 로컬에서 실행해 보고 싶다면(가장 흔한 경로) 다음 문서를 바로 따라 하십시오:
→ 로컬 컴퓨터에 OpenClaw 배포하기 (15-30분)
클라우드 24시간 운영은 클라우드 서버 배포를, 자주 겪는 문제는 로컬 문제 해결 2026을 참고하십시오.
المصدر: OpenClaw Orange Paper v1.2.0، الفصول 10-14
نظرة عامة على خيارات النشر
يدعم OpenClaw مجموعة متنوعة من خيارات النشر، من النشر المحلي إلى السحابي. يعتمد الخيار الأنسب على مستواك التقني وميزانيتك وحالة الاستخدام.
مقارنة خيارات النشر
| المنصة | نشر بنقرة واحدة | الحد الأدنى للمواصفات | سعر المستخدم الجديد | النماذج المدمجة | الصعوبة | الأنسب لـ |
|---|---|---|---|---|---|---|
| محلي | — | Node.js 22+ | مجاني | لا | منخفضة | المطورون ومستخدمو macOS/Linux |
| npm | — | Node.js 22+ | مجاني | لا | منخفضة | المطورون ومستخدمو macOS/Linux |
| Docker | — | Docker Engine | مجاني | لا | متوسطة | المطورون المتمرسون في الحاويات |
| Alibaba Cloud | نعم | 2C2G 40GB | ¥9.9/شهريًا | نعم (qwen3.5-plus) | منخفضة جدًا (3 خطوات) | الخيار الأول في الصين القارية، مناسب للمبتدئين |
| Tencent Cloud | نعم | 2C2G | ~¥17/شهريًا | لا (يتطلب Coding Plan) | منخفضة جدًا (3 خطوات) | مستخدمو منظومة WeCom/QQ |
| Baidu Cloud | نعم | 2C4G | ¥0.01 للشهر الأول | نعم (نماذج Qianfan) | منخفضة جدًا (4 خطوات) | التجربة السريعة، منظومة ERNIE |
| Huawei Cloud | نعم | مثيل Flexus L | ابتداءً من ~¥85/شهريًا | لا (يتطلب MaaS) | متوسطة (5+ خطوات) | مستخدمو المؤسسات، متطلبات الامتثال |
| Volcengine | نعم | 2C4G | ¥9.9/شهريًا | نعم (نماذج Ark) | منخفضة (3-4 خطوات) | الخيار الأول لمستخدمي Feishu |
| Coze Coding | نعم | لا حاجة لخادم | ابتداءً من ¥49/شهريًا | نعم (Seed 2.0 وغيرها) | منخفضة جدًا (خطوتان) | بلا أي عوائق، دون إدارة خوادم |
| Railway | نعم | توزيع تلقائي | رصيد مجاني بقيمة $5/شهريًا | لا | منخفضة جدًا (نقرة واحدة) | المستخدمون الدوليون والمطورون |
| Zeabur | نعم | 2C4G مخصص | فوترة حسب الاستخدام | نعم (AI Hub) | منخفضة جدًا (قالب) | الحاجة إلى failover متعدد النماذج |
نصيحة أساسية
التكلفة الحقيقية هي تكلفة النماذج. انخفضت تكاليف الخوادم عمومًا إلى مستويات منخفضة جدًا (¥9.9-99/سنويًا)؛ أما التكلفة المستمرة الحقيقية فهي استدعاءات واجهات برمجة تطبيقات النماذج. عند اختيار منصة، ركّز على أسعار باقات النماذج لا على سعر الخادم وحده.
التثبيت المحلي
يناسب التثبيت المحلي المطورين والمستخدمين الذين يريدون تحكمًا كاملًا في بياناتهم. OpenClaw مشروع مكتوب بلغة TypeScript يعمل على Node.js.
متطلبات النظام
| المتطلب | التفاصيل |
|---|---|
| Node.js | >= 22 (إلزامي) |
| مدير الحزم | npm / pnpm / bun جميعها تعمل |
| macOS | مطلوب Xcode Command Line Tools |
| Linux | أدوات البناء القياسية (gcc، make) |
| Windows | يوصى بشدة باستخدام WSL2 |
الخيار 1: التثبيت العام عبر npm (موصى به)
طريقة التثبيت الأكثر توصية — أمران فقط:
# Install OpenClaw
npm install -g openclaw@latest
# Initialize and install the daemon
openclaw onboard --install-daemon
يرشدك أمر onboard خلال الإعداد الأولي، بما في ذلك اختيار النموذج وإعداد مفاتيح API وتهيئة قنوات المراسلة. أما علامة --install-daemon فتثبّت أيضًا البرنامج الخفي ليبقى OpenClaw يعمل في الخلفية.
الخيار 2: التثبيت بسكربت من سطر واحد (macOS / Linux)
إذا كنت تفضل عدم تثبيت Node.js يدويًا، فاستخدم سكربت التثبيت الرسمي المؤلف من سطر واحد:
curl -fsSL https://openclaw.ai/install.sh | bash
ملاحظة: هذا الأمر مخصص لـ macOS وLinux فقط. على مستخدمي Windows إعداد WSL2 أولًا ثم تشغيله.
تحضير إضافي على macOS
قبل التثبيت، يجب على مستخدمي macOS التأكد من تثبيت Xcode Command Line Tools:
xcode-select --install
إذا كنت بحاجة إلى قناة iMessage أو مهارة Apple Notes، فاعلم أنها تعتمد على قدرات AppleScript الأصلية في macOS ولا تعمل إلا عليها.
ملاحظة لمستخدمي Windows
مهم: توصي OpenClaw رسميًا وبقوة بالتشغيل عبر WSL2 (Windows Subsystem for Linux). قد يواجه التشغيل الأصلي على Windows مشكلات توافق تتعلق بالمسارات والأذونات وغيرها.
بعد تثبيت WSL2، افتح طرفية Ubuntu واتبع تعليمات Linux.
البرنامج الخفي
يحافظ البرنامج الخفي على استمرار عمل OpenClaw في الخلفية حتى بعد إغلاق الطرفية. تستخدم الأنظمة المختلفة أدوات مختلفة لإدارة العمليات:
| نظام التشغيل | إدارة العمليات | ملاحظات |
|---|---|---|
| macOS | launchd | إدارة الخدمات الأصلية في macOS، تبدأ عند الإقلاع |
| Linux | systemd | إدارة الخدمات القياسية في Linux، تُدار عبر systemctl |
مع تثبيت البرنامج الخفي، يظل OpenClaw Gateway يستمع على ws://127.0.0.1:18789.
النشر عبر Docker
يناسب النشر عبر Docker السيناريوهات التي تتطلب عزل البيئة أو سهولة النقل أو التشغيل طويل الأمد على خادم.
بداية سريعة مع docker-compose
يأتي مستودع OpenClaw مع ملف docker-compose.yml مدمج — أمر واحد للبدء:
# Clone the repository
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# Start
docker-compose up -d
متغيرات الصورة
| المتغير | الوصف | حالة الاستخدام |
|---|---|---|
| الصورة القياسية | كل الميزات مع جميع تبعيات الامتدادات | الاستخدام العام، كل الوظائف |
| متغير slim | بناء متعدد المراحل وحجم أصغر | البيئات محدودة الموارد، CI/CD |
| sandbox | بيئة معزولة | عزل أمني، تنفيذ التعليمات البرمجية |
| sandbox-browser | بيئة معزولة مع متصفح | احتياجات أتمتة المتصفح |
لاستخدام متغير slim: عيّن متغير البيئة OPENCLAW_VARIANT=slim في docker-compose.yml.
الأدلة المطلوب تركيبها
يتطلب النشر عبر Docker تركيب دليلين رئيسيين لضمان استمرارية البيانات:
volumes:
- ~/.openclaw:/root/.openclaw # Config and state data
- ~/openclaw/workspace:/workspace # Workspace (YAML config files)
مهم: بدون تركيب هذين الدليلين، ستُفقد جميع الإعدادات وسجل المحادثات عند إعادة تشغيل الحاوية.
تعيين المنافذ
يستمع OpenClaw Gateway افتراضيًا على المنفذ 18789 (WebSocket)، بينما تستخدم واجهة الويب المنفذ 3000 افتراضيًا:
ports:
- "18789:18789" # Gateway WebSocket
- "3000:3000" # Web UI
التوافق مع Podman
يعمل OpenClaw أيضًا على Podman:
# Start with Podman
podman-compose up -d
بالنسبة للبيئات التي تتطلب حاويات rootless (مثل سياسات الأمان المؤسسية)، يُعد Podman الخيار الأفضل.
النشر بنقرة واحدة لدى مزودي السحابة الصينيين
هذا هو الخيار المعتاد لمعظم المستخدمين في الصين القارية. جميع مزودي السحابة الصينيين الكبار يدعمون الآن نشر OpenClaw بنقرة واحدة.
Alibaba Cloud
المنصة الأغنى بموارد المجتمع في الصين — الصورة مثبتة مسبقًا وتعمل مباشرة.
| البند | التفاصيل |
|---|---|
| المواصفات | 2 vCPU + 2 GiB ذاكرة + قرص نظام ESSD بسعة 40 GiB |
| نظام التشغيل | Alibaba Cloud Linux 3، مع صورة OpenClaw مثبتة مسبقًا |
| السعر | عرض ترويجي محدود ¥9.9/شهريًا؛ الخطط السنوية تبدأ من ¥68/سنويًا |
| النماذج | qwen3.5-plus مدمج افتراضيًا؛ Bailian Coding Plan Lite بـ ¥10 للشهر الأول |
| دعم المراسلة | DingTalk وFeishu وغيرها (عبر إضافة openclaw-china) |
خطوات النشر:
- الشراء بنقرة واحدة: افتح صفحة الحملة واشترِ خادم تطبيقات خفيفًا (Lightweight Application Server) مع صورة OpenClaw مثبتة مسبقًا
- فتح المنافذ + الإعداد: اسمح بالمنفذين 18789 (Gateway) و3000 (واجهة الويب) في مجموعة الأمان
- زيارة واجهة الويب: افتح
http://YOUR_IP:3000في المتصفح
Tencent Cloud
دعم كامل لأربع منصات المراسلة الكبرى، مع باقات نماذج Coding Plan اقتصادية.
خطوات النشر:
- اشترِ مثيل Lighthouse
- اختر قالب OpenClaw: قوالب التطبيقات → AI Agents → OpenClaw
- إعداد النماذج + ربط المراسلة: اشترِ Coding Plan ثم اربط WeCom/QQ/Feishu/DingTalk
Volcengine
الخيار الأول لمستخدمي Feishu، مع تكامل عميق مع منظومة Feishu.
Coze Coding
خيار بلا أي عوائق — لا خادم لإدارته.
| البند | التفاصيل |
|---|---|
| السعر | ابتداءً من ¥49/شهريًا |
| النماذج | Seed 2.0 والمزيد مدمجة |
| الصعوبة | منخفضة جدًا (خطوتان) |
| الأنسب لـ | المستخدمون الذين لا يريدون إدارة الخوادم |
الإعداد الأول
تدفق التهيئة
- تعيين كلمة مرور المشرف: عيّنها عند زيارتك الأولى لواجهة الويب
- إضافة نموذج ذكاء اصطناعي: قم بإعداد مفتاح API
- اختيار نموذج افتراضي: حدد النموذج الذي ستستخدمه أكثر
- تهيئة القنوات (اختياري): اربط Feishu/DingTalk/WeChat وغيرها
اختيارات النماذج الموصى بها
| نوع المستخدم | النموذج الموصى به | السبب |
|---|---|---|
| المستخدمون الجدد | Google Gemini | تتوفر طبقة مجانية |
| مستخدمو الصين القارية | DeepSeek / Kimi | متوافقة مع شبكات الصين القارية |
| الجودة أولًا | Claude / GPT-4 | أفضل النتائج |
| الحساسية للتكلفة | النماذج المحلية (Ollama) | مجانية تمامًا |
الحصول على مفاتيح API
| المزود | مكان الحصول عليه |
|---|---|
| Google Gemini | https://aistudio.google.com/apikey |
| Claude | https://console.anthropic.com/ |
| OpenAI | https://platform.openai.com/api-keys |
| DeepSeek | https://platform.deepseek.com/ |
| Kimi | https://platform.moonshot.cn/ |
الخطوة التالية الموصى بها (تطبيق عملي)
إذا كنت تريد تشغيله محليًا أولًا (المسار الأكثر شيوعًا)، فاتبع هذا مباشرة:
→ نشر OpenClaw على جهازك المحلي (15-30 دقيقة)
للتشغيل السحابي 24/7 راجع نشر خادم سحابي؛ وللأخطاء الشائعة راجع استكشاف أخطاء التشغيل المحلي 2026.