OpenClaw 完整安装部署指南

OpenClaw 是一款功能强大的开源 AI 助手框架，支持多种部署方式和平台集成。下面将详细介绍在不同环境下的安装配置流程。

🛠️ 环境准备

系统要求与 Node.js 环境

所有部署方式都需要先配置 Node.js 环境：

# 使用 nvm 管理 Node.js 版本（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22.22.0
nvm use 22.22.0

# 验证安装
node --version
npm --version

注意：建议使用 Node.js LTS 版本，避免安装冗余工具 。

🚀 主流部署方式对比

部署方式	适用场景	核心优势	关键配置点
腾讯云轻量服务器	生产环境、企业部署	7×365小时在线，零代码部署	飞书应用创建 + API Key 配置
Windows + WSL2	Windows 开发环境	完整的 Linux 兼容环境	systemd 启用 + 端口转发
Windows 原生	本地测试开发	快速上手，无需虚拟机	nvm 环境 + PowerShell 配置
本地大模型集成	隐私敏感场景	支持 Ollama 本地模型	JSON 配置文件修改

📝 详细安装步骤

方法一：腾讯云服务器部署（生产推荐）

# 1. 连接腾讯云轻量服务器
ssh root@your-server-ip

# 2. 一键安装 OpenClaw
npm install -g @openclaw/cli

# 3. 初始化配置
openclaw init

关键配置项：

• 大模型 API（如小米 MiMo、智谱 GLM 等）
• 飞书机器人凭据配置
• Webhook 回调地址设置

方法二：Windows WSL2 部署

# 1. 启用 WSL2 并安装 Ubuntu
wsl --install -d Ubuntu

# 2. 进入 WSL 环境并启用 systemd
sudo vi /etc/wsl.conf
# 添加以下内容：
# [boot]
# systemd=true

# 3. 重启 WSL 并安装 OpenClaw
wsl --shutdown
wsl
sudo apt update
npm install -g @openclaw/cli

局域网访问配置：

# 配置端口转发（Windows PowerShell）
netsh interface portproxy add v4tov4 listenport=18789 listenaddress=0.0.0.0 connectport=18789 connectaddress=$(wsl hostname -I)

# 开放防火墙规则
New-NetFirewallRule -DisplayName "OpenClaw Gateway" -Direction Inbound -LocalPort 18789 -Protocol TCP -Action Allow

方法三：Windows 原生部署

# 1. 以管理员身份运行 PowerShell
# 2. 安装 OpenClaw
npm install -g @openclaw/cli

# 3. 初始化项目
openclaw init my-openclaw
cd my-openclaw

# 4. 版本 3.2+ 需要授予本地权限
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

常见问题排查：

# 检查 Node.js 版本
node --version

# 清理 npm 缓存
npm cache clean --force

# 重新安装
npm uninstall -g @openclaw/cli
npm install -g @openclaw/cli

🔗 飞书机器人集成配置

飞书应用创建步骤

1. 访问飞书开放平台 → 创建企业自建应用
2. 启用机器人能力 → 配置权限
3. 事件订阅配置：
   • 请求地址：http://your-domain:18789/webhook/feishu
   • 验证令牌匹配
4. 发布应用 → 获取版本凭证

API Key 配置

在 OpenClaw 配置文件中设置大模型 API：

{
  "model": {
    "provider": "mimo",
    "apiKey": "your-api-key-here"
  },
  "feishu": {
    "appId": "your-app-id",
    "appSecret": "your-app-secret"
  }
}

🏠 本地大模型集成

使用 Ollama 部署本地模型

# 1. 安装 Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# 2. 下载模型（如 qwen3:32b）
ollama pull qwen3:32b

# 3. 修改 OpenClaw 配置
vi config.json

配置示例：

{
  "model": {
    "provider": "ollama",
    "baseURL": "http://localhost:11434/v1",
    "model": "qwen3:32b"
  }
}

🌐 网关服务与访问

启动网关服务

# 启动 Gateway 服务
openclaw gateway

# 访问 Web 界面
http://127.0.0.1:18789

网关功能：

• Web 可视化界面调试
• 多平台消息路由
• API 接口管理

🔧 验证与测试

服务状态检查

# 检查服务运行状态
systemctl status openclaw-gateway

# 测试飞书机器人
# 在飞书群组中 @机器人 发送消息测试响应

终端对话测试

# 使用 CLI 进行对话测试
openclaw chat

💡 最佳实践建议

1. 环境隔离：使用 nvm 管理 Node.js 版本，避免全局污染
2. 权限管理：生产环境使用最小权限原则配置飞书应用
3. 备份策略：定期备份配置文件和应用数据
4. 监控告警：设置服务健康检查机制

⚠️ 常见问题解决

问题现象	可能原因	解决方案
安装失败	Node.js 版本不兼容	使用 nvm 切换至 Node.js 22.22.0
权限错误	执行策略限制	PowerShell 中设置 RemoteSigned 策略
局域网无法访问	防火墙阻止	配置 Windows 防火墙规则
飞书消息无响应	Webhook 配置错误	检查事件订阅 URL 和令牌匹配

通过以上步骤，您可以在不同环境下成功部署 OpenClaw，并实现与飞书机器人的无缝集成。建议根据实际需求选择合适的部署方式，生产环境推荐使用云服务器部署以确保服务稳定性 。

---

参考来源

• 15分钟搞定！OpenClaw保姆级安装教程
• OpenClaw 在 Windows 上的完整安装教程
• OpenClaw！安装教程 
• OpenClaw 安装 + 接入飞书机器人完整教程
• Windows11 OpenClaw安装部署教程
• 最新中文版OpenClaw详细安装教程 包含云模型和本地模型部署方法