在阿里云上部署 OpenClaw 完整指南

覆盖阿里云百炼模型配置、飞书 / 钉钉（传统机器人 + DEAP 高级方案）/ QQ / Discord 全平台接入、Qoder CLI 集成，以及高级配置与运维。

---

⚠️ 安全警告

在开始之前，请务必阅读以下注意事项：

1. 切勿在个人主力电脑上部署 OpenClaw——它具有高文件系统和命令执行权限
2. 务必使用云服务器（如阿里云 ECS）进行部署，与本地环境隔离
3. 保护好你的 API 密钥——使用环境变量或安全保险箱，不要硬编码在代码中
4. 使用强随机令牌限制 Gateway 访问，避免使用简单密码
5. 定期轮换凭证——特别是钉钉/飞书/QQ 等平台的应用密钥

---

使用场景

• 在阿里云 ECS 服务器上从零部署 OpenClaw AI 助手
• 通过钉钉（Stream 机器人或 DEAP 高级方案）与 AI 对话
• 通过飞书、QQ 或 Discord 接入 OpenClaw
• 配置阿里云百炼 Coding Plan 作为 AI 推理后端
• 将 Qoder CLI 注册为 ACP Agent，实现钉钉/飞书中的代码开发

示例

# 安装 OpenClaw
curl -fsSL https://clawd.bot/install.sh | bash

# 启动 Gateway
openclaw gateway --port 18789 --verbose

# 交互式配置模型和渠道
openclaw onboard

# 查看所有渠道状态
openclaw channel list

# 查看实时日志
tail -f /tmp/openclaw-gateway.log

注意事项

• 切勿在本地主力电脑部署，务必使用云服务器（如阿里云 ECS）
• 钉钉应用必须完成「版本发布」流程，仅保存配置不生效
• 钉钉 Client Secret、百炼 API Key、QQ 机器人密钥均只显示一次，需立即保存
• 飞书集成需选择「WebSocket 长连接」模式，不要使用 HTTP 回调
• 钉钉 DEAP 方案需在同一服务器运行 Connector，确保 18789 端口本地可访问
• 建议为 Gateway 配置随机强令牌认证（openssl rand -hex 24）

---

概述

本指南将带你完成一套完整的 OpenClaw 云端部署，实现通过多种 IM 平台与 AI 助手对话，并可选接入 Qoder CLI 进行代码开发。

整体架构：

┌────────────────────────────────────────────────────────────┐
│                         用户层                              │
│  ┌────────┐  ┌────────┐  ┌──────┐  ┌─────────┐           │
│  │  飞书  │  │  钉钉  │  │  QQ  │  │ Discord │           │
│  └───┬────┘  └───┬────┘  └──┬───┘  └────┬────┘           │
└──────┼───────────┼──────────┼───────────┼─────────────────┘
       │           │          │           │
       └───────────┴──────────┴───────────┘
                              │
                     Stream / WebSocket
                              │
┌─────────────────────────────▼──────────────────────────────┐
│                   OpenClaw Gateway :18789                   │
│  ┌──────────────────────────────────────────────────────┐  │
│  │  ACP 协议层                                           │  │
│  │  ┌──────────┐  ┌──────────┐  ┌──────────┐           │  │
│  │  │  acpx    │  │  调度器  │  │  会话管理 │           │  │
│  │  └──────────┘  └──────────┘  └──────────┘           │  │
│  └──────────────────────────────────────────────────────┘  │
│  ┌──────────────────────────────────────────────────────┐  │
│  │  渠道连接器层（飞书 / 钉钉 / QQ / Discord）           │  │
│  └──────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────┘
                              │
                    阿里云百炼 API / Qoder CLI

部署步骤总览：

1. 购买并配置阿里云 ECS 服务器
2. 安装 Node.js 与 OpenClaw
3. 配置阿里云百炼模型（Coding Plan）
4. 配置 Gateway 外部访问与认证
5. 配置 ACP 协议支持
6. 安装并配置 Qoder CLI（可选）
7. 接入 IM 平台（飞书 / 钉钉 / QQ / Discord）

---

前置要求

必需账号和权限

• 阿里云账号
• 阿里云百炼账号（用于模型 API）
• 目标 IM 平台的开发者/管理员账号

必需软件（本地）

• SSH 客户端
• 现代浏览器（用于访问各平台开发者控制台）

---

第一阶段：阿里云服务器购买与配置

1.1 推荐服务器配置

配置项	最低要求	推荐配置
CPU	2 核	2 核
内存	2 GiB	4 GiB
磁盘	20 GB SSD	40 GB ESSD
带宽	1 Mbps	20 Mbps+
操作系统	Ubuntu 22.04 / CentOS 8	Alibaba Cloud Linux 3
地域	任意	美国弗吉尼亚 / 中国香港（访问 AI 服务延迟低）

1.2 购买方式

方式一：通过计算巢快速部署（推荐新手）

访问阿里云计算巢，一键部署预配置环境：

🔗 阿里云计算巢 - OpenClaw 快速部署

按页面指引：选择地域 → 选择实例规格 → 配置网络和安全组 → 确认创建。

方式二：手动购买 ECS 实例

1. 访问 阿里云 ECS 控制台
2. 点击「创建实例」
3. 关键选项：
   • 镜像：Alibaba Cloud Linux 3 / Ubuntu 22.04（如有 OpenClaw 应用镜像可直接选用）
   • 实例规格：ecs.c7.large（2 核 4 GiB）或更高
   • 系统盘：40 GB ESSD
   • 公网 IP：分配公网 IPv4
   • 带宽：按使用流量或按固定带宽（至少 1 Mbps）
4. 配置安全组（见下方）
5. 设置登录凭证（密钥对推荐）
6. 确认并创建

1.3 配置安全组规则

端口	协议	用途	授权对象
22	TCP	SSH 远程连接	你的 IP 地址
18789	TCP	OpenClaw Gateway	0.0.0.0/0

配置步骤：

1. ECS 控制台 → 找到实例 → 点击「安全组」
2. 「配置规则」→「入方向」→「手动添加」以上规则

1.4 连接到服务器

# 使用密码登录
ssh root@<你的服务器公网IP>

# 使用密钥登录
ssh -i /path/to/your-key.pem root@<你的服务器公网IP>

# 或通过阿里云控制台网页终端：
# ECS 控制台 → 实例详情 → 远程连接

---

第二阶段：安装 Node.js 与 OpenClaw

2.1 安装 Node.js（推荐 nvm）

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc

# 安装 Node.js 22 LTS
nvm install 22
nvm use 22
node -v  # 验证：应输出 v22.x.x

2.2 安装 OpenClaw

方式一：通过官方安装脚本（推荐）

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

方式二：通过 npm 全局安装

npm install -g openclaw

验证安装：

openclaw --version
# 预期输出：版本号如 "2026.1.x"
# 若提示命令不存在，尝试旧名称：clawdbot --version

2.3 启动 OpenClaw Gateway

# 方式一：前台启动（调试用）
openclaw gateway --port 18789 --verbose

# 方式二：后台启动
nohup setsid openclaw gateway --port 18789 --verbose > /tmp/openclaw-gateway.log 2>&1 &

# 检查状态
systemctl --user status openclaw-gateway.service
# 或
openclaw gateway status

---

第三阶段：配置阿里云百炼模型（Coding Plan）

3.1 购买 Coding Plan 套餐

套餐	首月价格	次月价格	每月请求量
Lite 基础版	7.9 元	40 元/月	18,000 次
Pro 高级版	39.9 元	200 元/月	90,000 次

1. 访问 阿里云百炼控制台
2. 导航至「Coding Plan」或「订阅套餐」
3. 选择 Lite 或 Pro 完成支付

3.2 获取 API 凭证

• Base URL（固定）：https://coding.dashscope.aliyuncs.com/v1
• API Key 格式：sk-sp-xxxxx

获取步骤：

1. 登录 阿里云百炼控制台
2. 进入「密钥管理」或「API Keys」
3. 点击「创建 API Key」
4. 立即复制并保存——关闭后无法再次查看

支持的模型：

• qwen3.5-plus - 通用场景（推荐入门）
• qwen3-max-2026-01-23 - 高级推理
• kimi-k2.5 - 代码生成（如可用）
• glm-5 - 中文优化

3.3 配置 OpenClaw 使用百炼

方式一：交互式引导

openclaw onboard

按提示操作：

1. 选择「添加自定义模型供应商」
2. 供应商 ID：bailian
3. Base URL：https://coding.dashscope.aliyuncs.com/v1
4. API Key：粘贴 sk-sp-xxxxx
5. API 类型：openai-completions
6. 添加模型：qwen3.5-plus
7. 设为默认模型

方式二：手动编辑配置文件

编辑 ~/.openclaw/openclaw.json：

{
  "models": {
    "providers": {
      "bailian": {
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "apiKey": "sk-sp-YOUR_KEY_HERE",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-plus",
            "name": "Qwen 3.5 Plus",
            "reasoning": true,
            "input": ["text"],
            "contextWindow": 32000,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3.5-plus"
      }
    }
  }
}

---

第四阶段：配置 Gateway 外部访问与认证

当需要通过钉钉 DEAP 或其他外部服务访问 Gateway 时，需配置认证和 HTTP 端点。

4.1 生成强认证令牌

openssl rand -hex 24
# 示例输出：a3f7c2e1d4b5a6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3

4.2 更新 Gateway 配置

编辑 ~/.openclaw/openclaw.json，添加 gateway 部分：

{
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "controlUI": {
      "allowInsecureAuth": false
    },
    "auth": {
      "mode": "token",
      "token": "在此处填入上一步生成的强令牌"
    },
    "http": {
      "endpoints": {
        "chatCompletions": {
          "enabled": true
        }
      }
    }
  }
}

4.3 重启 Gateway

openclaw gateway restart

# 或手动重启：
pkill -f "openclaw gateway"
nohup setsid openclaw gateway --port 18789 --verbose > /tmp/openclaw-gateway.log 2>&1 &

4.4 验证 Gateway 正常运行

curl http://127.0.0.1:18789/health
# 应返回 {"status":"ok"} 或类似响应

---

第五阶段：配置 ACP 协议支持

ACP（Agent Client Protocol）协议允许 OpenClaw 调度多种 AI Agent。

5.1 安装并启用 ACPX 插件

# 安装 ACPX 插件
openclaw plugins install @openclaw/acpx

# 启用插件
openclaw config set plugins.entries.acpx.enabled true

5.2 配置 ACP 参数

# 启用 ACP
openclaw config set acp.enabled true

# 启用 ACP 调度
openclaw config set acp.dispatch.enabled true

# 设置后端为 acpx
openclaw config set acp.backend "acpx"

how to use openclaw-complete-deployment-guide
CursorClaude CodeClineCodexWindsurfGooseGitHub CopilotVS CodeGemini CLIKiloOpencodeKimi CLIRoo ClineAiderContinueZedBolt.newLovablev0Replit AgentSweepSmol DeveloperDevinCavemanAmpAntigravity
How to use openclaw-complete-deployment-guide on Cursor
AI-first code editor with Composer
1
Prerequisites
Before installing skills in Cursor, ensure your development environment meets these requirements:
›Cursor installed and configured on your development machine
›Node.js version 16.0+ with npm package manager (verify with node --version)
›Active project directory or workspace where you want to add openclaw-complete-deployment-guide
2
Execute installation command
Execute the skills CLI command in your project's root directory to begin installation:
$npx skills add https://github.com/nathansteelqoder/openclaw-config-qoder-integration --skill openclaw-complete-deployment-guidecopy
The skills CLI fetches openclaw-complete-deployment-guide from GitHub repository nathansteelqoder/openclaw-config-qoder-integration and configures it for Cursor.
3
Select Cursor when prompted
The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:
◆ Which agents do you want to install to?
│
│ ── Universal (.agents/skills) ── always included ────
│   • Amp
│   • Antigravity
│   • Cline
│   • Codex
│ ●Cursor(selected)
│   • Cursor
│   • Windsurf
4
Verify installation
Confirm successful installation by checking the skill directory location:
.cursor/skills/openclaw-complete-deployment-guide
Reload or restart Cursor to activate openclaw-complete-deployment-guide. Access the skill through slash commands (e.g., /openclaw-complete-deployment-guide) or your agent's skill management interface.
⚠
Security & Verification Notice
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.
Additional Resources
›View source code on GitHub›Skills CLI documentation›Learn more about Cursor›What are agent skills?