手把手教你一步一步部署Openclaw 中文版

OpenClaw（中文名：OpenClaw 中文版，曾用名 Moltbot/Clawdbot）是一个开源的私有化 AI 智能助手。以下是 openclaw-cn 2026.1.31 版本的详细部署教程，支持本地和云端部署。

一、环境准备

检查 Node.js 版本：

node -v

二、部署方式选择

方式一：一键脚本安装（推荐，最简单）

适合 macOS 和 Linux 用户（含云服务器）：

curl -fsSL https://openclaw.bot/install.sh | bash

Windows (PowerShell)：

iwr -useb https://openclaw.bot/install.ps1 | iex

安装完成后会自动进入初始化向导。如未自动进入，手动运行：

openclaw-cn onboard --install-daemon

方式二：npm 全局安装

如果你已有 Node.js 环境：

# 使用 npm
npm install -g openclaw-cn@latest

# 或使用 pnpm（推荐）
pnpm add -g openclaw-cn@latest

如遇 sharp 模块安装错误（常见于 macOS Homebrew 用户）：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw-cn@latest

安装后命令找不到？ 添加 npm 全局路径到 PATH：

export PATH="$(npm prefix -g)/bin:$PATH"
# 添加到 ~/.zshrc 或 ~/.bashrc 永久生效

方式三：源码构建（开发者）

git clone https://github.com/jiulingyun/openclaw-cn.git
cd openclaw-cn

pnpm install
pnpm ui:build
pnpm build

# 运行安装向导
pnpm openclaw-cn onboard --install-daemon

方式四：云服务器镜像部署（7×24 小时运行）

阿里云部署（推荐）

1. 访问阿里云轻量应用服务器，选择 应用镜像 → Moltbot（版本 2026.1.24+）

2. 配置：2核 CPU + 2GB 内存（最低配置）

3. 地域：建议美国弗吉尼亚（联网搜索能力更完整）

4. 创建后进入控制台：

   • 点击 一键放通端口（放行 18789 端口）

   • 点击 一键配置，粘贴阿里云百炼 API Key

   • 点击 执行命令 生成访问 Token

   • 点击 打开网站页面 即可使用

腾讯云部署

1. 轻量应用服务器选择 AI 智能体 → Clawdbot 模板

2. 登录实例后运行：

   clawdbot onboard

3. 按向导配置模型和渠道

三、初始化配置（Onboarding）

无论哪种安装方式，首次运行需执行初始化向导：

openclaw-cn onboard --install-daemon

向导步骤：

1. 风险确认
   提示 Agent 拥有读写文件和执行命令权限，输入 Yes 确认

2. 端口设置
   默认 18789，直接回车保持默认

3. 配置 AI 模型（核心步骤）
   选择模型提供商并输入 API Key：

   • 海外：Anthropic Claude（推荐）、OpenAI GPT

   • 国内：阿里云百炼（通义千问）、智谱 GLM-4、MiniMax、Moonshot

   输入 Key 时可能不会显示字符，粘贴后直接回车

4. 选择通信渠道

   • Web 界面：最简单，浏览器访问 http://localhost:18789

   • Telegram：需 Bot Token（@BotFather 申请）

   • WhatsApp：终端生成二维码，手机扫码连接

   • 钉钉/飞书：见下方集成教程

5. 安装技能包（Skills）
   建议全部安装（文件读写、网页搜索、代码执行等），输入 Yes

6. 守护进程安装
   选择安装为系统服务，实现开机自启：

   • macOS：LaunchAgent

   • Linux：systemd 用户单元

四、启动与使用

手动启动网关：

openclaw-cn gateway --port 18789 --verbose

查看状态：

openclaw-cn status --deep

健康检查：

openclaw-cn health

访问 Web 界面：
浏览器打开 http://localhost:18789 或服务器公网 IP:18789

五、接入国内平台（钉钉/飞书）

钉钉集成

1. 钉钉开放平台创建企业内部应用，获取 Client ID 和 Client Secret

2. 创建消息卡片模板（AI 卡片类型），复制模板 ID

3. 阿里云 AppFlow 创建连接流，填入 OpenClaw Token 和钉钉凭证

4. 钉钉后台启用机器人，消息接收模式选 Stream 模式

5. 发布应用后，在钉钉 @机器人即可对话

飞书集成

1. 飞书开放平台创建企业自建应用，开启机器人能力

2. 事件订阅选择 使用长连接接收事件，添加 im.message.receive_v1 事件

3. 运行 openclaw-cn channels add 选择 Feishu，输入 App ID 和 Secret

4. 发布版本后，在飞书搜索应用或群聊 @它

六、配置文件说明

最小配置文件路径：~/.openclaw/openclaw.json

{
  "agent": {
    "model": "anthropic/claude-opus-4-5",
    "apiKey": "your-api-key"
  },
  "gateway": {
    "port": 18789,
    "auth": {
      "token": "your-secure-token"
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "your-bot-token"
    }
  }
}

七、常见问题

八、SSL/HTTPS 部署（生产环境）

使用 Nginx + Let's Encrypt：

# 安装 Certbot
sudo apt install certbot python3-certbot-nginx

# 申请证书
sudo certbot --nginx -d your-domain.com

# Nginx 配置反向代理到 127.0.0.1:18789

完整配置参考官方文档 SSL 部署指南。

提示： 如果只是想尝鲜且不想折腾服务器，可考虑国产平替 实在 Agent（支持钉钉/飞书零代码接入），或直接使用阿里云的一键部署镜像。

部署完成后，你的 OpenClaw 就是一个 7×24 小时在线的私有化 AI 助手，数据完全存储在本地，支持文件管理、代码编写、网页浏览等多种技能。