前言：为什么 OpenClaw 如此火爆？
最近，一个名为 OpenClaw（前身为 Clawdbot/Moltbot）的开源项目在 GitHub 上创造了历史——短短 10 天内 Star 数突破 10 万，成为史上增长最快的开源项目之一。
这不仅仅是一个聊天机器人，而是一个真正的"AI 数字员工"：
- 🖥️ 本地优先：数据完全保存在你的设备上，隐私无忧
- 💬 全平台接入：支持微信、飞书、钉钉、Telegram、Discord 等 10+ 平台
- 🧠 持久记忆：跨对话、跨平台记住你的偏好
- ⚡ 系统级操作：能读写文件、执行命令、控制浏览器
本文将详细介绍如何在本地电脑（Windows/macOS/Linux）上完整部署 OpenClaw，让你拥有专属的 24 小时 AI 助手。
一、环境准备与前置要求
1.1 系统配置要求
| 配置项 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | Windows 10 / macOS 12 / Ubuntu 20.04 | Windows 11 / macOS 14 / Ubuntu 22.04 |
| 内存 | 4GB | 8GB+ |
| 磁盘空间 | 2GB 可用空间 | 10GB+ SSD |
| Node.js | v22 LTS | v22 LTS 最新版 |
1.2 必要环境安装
安装 Node.js v22+：
# 使用 nvm 安装（推荐）
nvm install 22
nvm use 22
# 验证版本
node --version # 应显示 v22.x.x
npm --version
配置国内镜像（加速下载）：
npm config set registry https://registry.npmmirror.com
二、OpenClaw 安装方案详解
方案一：NPM 全局安装（推荐）
这是最直接的方式，一条命令即可完成：
npm install -g openclaw@latest
但国内用户常遇到下载卡顿或依赖安装失败的问题。由于 OpenClaw 依赖较多的原生编译模块，从 GitHub 下载预编译二进制文件时速度可能极慢。
💡 加速技巧：如果你遇到下载进度卡死的情况，建议尝试使用支持多线程下载和 GitHub 加速的浏览器获取离线安装包。
安装完成后，验证是否成功：
openclaw --version
方案二：Docker 部署（适合开发者）
如果你已安装 Docker，可以使用容器化部署：
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 启动服务
docker compose up -d openclaw-gateway
三、初始化配置向导
安装完成后，运行配置向导：
openclaw onboard
你将看到交互式配置菜单：
3.1 选择 AI 模型提供商
推荐选择：
- Anthropic (Claude) ：功能最强，适合复杂任务
- OpenAI (GPT-4) ：通用性好
- 阿里云百炼：国内访问稳定，支持 Deepseek-V3/Qwen
以阿里云百炼为例：
- 前往 阿里云百炼控制台 创建 API-Key
- 在向导中选择 "Alibaba Cloud Bailian"
- 粘贴 API-Key（格式为
sk-xxxxxxxx）
3.2 配置通信渠道
OpenClaw 支持多种接入方式：
| 平台 | 适用场景 | 配置难度 |
|---|---|---|
| 飞书 | 团队协作 | ⭐⭐ |
| 钉钉 | 企业办公 | ⭐⭐ |
| Telegram | 个人使用 | ⭐ |
| Discord | 社区管理 | ⭐⭐ |
| 微信 | 国内个人 | ⭐⭐⭐ |
示例：配置飞书机器人
- 在飞书开放平台创建企业自建应用
- 获取 App ID 和 App Secret
- 在向导中选择 Feishu/Lark，填入凭证
四、启动与使用
4.1 启动 Gateway 服务
配置完成后，启动核心网关：
openclaw gateway --port 18789 --verbose
看到以下日志即表示成功：
Gateway listening on http://0.0.0.0:18789
WebSocket server ready for connections
4.2 访问控制面板
打开浏览器，访问：
http://localhost:18789
首次进入需要输入配置 Token（在初始化时生成，请妥善保存）。
4.3 实际使用场景
部署完成后，你可以通过日常聊天软件向 OpenClaw 发送指令：
- 📧 邮件处理："帮我整理上周的未读邮件，提取其中的会议纪要"
- 📁 文件整理："将桌面上的所有 PDF 按日期归档到文档文件夹"
- 🔍 信息查询："查一下公司最新的服务器 CPU 使用情况并生成图表"
- ⏰ 定时任务："每天早 9 点给我发送今日待办事项"
五、进阶配置与资源获取
5.1 汉化与优化
原版 OpenClaw 对国内平台支持有限，建议使用社区维护的汉化增强版 openclaw-cn，针对微信、企业微信等做了适配：
npm install -g openclaw-cn@latest
5.2 完整视频教程与配置模板
文字教程难以覆盖所有细节，如果你希望获取：
- 📹 完整的 Windows/macOS 安装视频演示
- 📦 预配置好的 Docker Compose 模板
- 🔧 国内网络环境专用加速配置文件
- 📋 飞书/钉钉机器人一键配置脚本
建议搜索【小武哥分享】获取完整资源包，内含针对国内用户优化的详细部署指南和排错方案。
六、常见问题与排错
Q1: 安装时卡在 node-gyp rebuild？
原因：缺少 Python 和 C++ 编译工具
解决：
# Windows
npm install --global windows-build-tools
# macOS
xcode-select --install
Q2: 启动后无法访问 18789 端口？
检查防火墙设置，确保端口放行：
# Linux
sudo ufw allow 18789/tcp
# Windows PowerShell
New-NetFirewallRule -DisplayName "OpenClaw" -Direction Inbound -LocalPort 18789 -Protocol TCP -Action Allow
Q3: 如何保持后台运行？
使用 PM2 进程管理器：
npm install -g pm2
pm2 start "openclaw gateway" --name openclaw
pm2 startup
pm2 save
结语
OpenClaw 代表了个人 AI 助手的新范式——从"使用云端服务"转向"拥有本地智能"。通过本文的指南，你应该已经成功在本地部署了自己的 AI 助手。
随着项目的快速迭代（目前几乎每日更新），建议关注官方 GitHub 仓库获取最新特性。如果在部署过程中遇到网络问题或需要更直观的指导，记得获取【小武哥分享】的完整资源包，里面包含了针对国内环境优化的一键安装脚本和视频演示。
开始享受你的 24 小时私人 AI 助手吧！🦞
参考资源：
- OpenClaw 官方文档
- 阿里云 OpenClaw 部署指南
- 汉化版社区支持
