阿里云服务器怎么部署OpenClaw?2026年云服务器部署OpenClaw保姆级教程

阿里云服务器

在 2026 年,部署 OpenClaw(原 Clawdbot)到阿里云服务器(ECS)的流程已经非常成熟。OpenClaw 本质上是一个基于 Python 的机器人框架,通常用于对接钉钉、飞书或微信,并调用大模型(如阿里云百炼的通义千问)进行智能回复。

以下是一份2026 年最新版保姆级教程,涵盖从购买服务器到机器人跑通的全流程。


📋 准备工作

  1. 阿里云账号:已实名认证。

  2. 阿里云百炼 API Key

  3. 机器人应用配置

    • 如果您对接钉钉/飞书,需先在开放平台创建应用,获取 AppKeyAppSecretWebhook 地址。

  4. 一台云服务器 (ECS)

    • 推荐配置:2核 CPU / 2GB 内存 / 40GB 磁盘(轻量应用服务器即可,约 ¥60-90/年)。

    • 系统镜像:推荐选择 Ubuntu 22.04 LTSAlibaba Cloud Linux 3(兼容性好,文档多)。


第一步:购买并初始化阿里云 ECS

  1. 购买实例

    • 登录 阿里云 ECS 控制台

    • 点击“创建实例”,选择“轻量应用服务器”或“云服务器 ECS”。

    • 地域:选离您最近的(如杭州、北京)。

    • 镜像:选择 Ubuntu 22.04

    • 网络:确保安全组放行 SSH (22) 端口。如果机器人需要接收 Webhook,建议先放行 80/443 或自定义端口(如 8080)。

    • 设置登录密码(记住它!)。

  2. 连接服务器

    • 在 ECS 控制台找到刚买的实例,点击 “远程连接” -> “Workbench”“VNC”

    • 输入用户名 root 和刚才设置的密码登录。


第二步:安装基础环境 (Python & Git)

在终端中依次执行以下命令(以 Ubuntu 为例):

# 1. 更新软件源
sudo apt update && sudo apt upgrade -y

# 2. 安装 Python3, pip, git 和 venv (虚拟环境工具)
sudo apt install python3 python3-pip python3-venv git curl -y

# 3. 验证安装
python3 --version  # 应显示 Python 3.10+
pip3 --version

第三步:获取 OpenClaw 代码

由于 OpenClaw 是开源项目,我们需要从代码仓库拉取最新代码。
注意:请确认您使用的具体分支或版本,以下以官方主分支为例。

# 1. 创建项目目录
mkdir -p /opt/openclaw
cd /opt/openclaw

# 2. 克隆代码 (请替换为最新的官方仓库地址,此处为示例)
# 如果官方仓库改名或迁移,请在 GitHub/Gitee 搜索 "OpenClaw" 或 "Clawdbot"
git clone https://github.com/OpenClawTeam/openclaw.git . 
# 如果上述地址无效,请尝试搜索最新的 fork 版本或官方文档提供的地址

# 3. 创建 Python 虚拟环境 (推荐,避免污染系统环境)
python3 -m venv venv

# 4. 激活虚拟环境
source venv/bin/activate

# 5. 安装依赖
# 通常项目根目录有 requirements.txt
pip3 install -r requirements.txt

第四步:配置核心参数 (关键步骤)

OpenClaw 需要通过配置文件或环境变量来连接大模型和机器人平台。

  1. 找到配置文件
    通常在根目录下有一个 .env 文件,或者 config.yaml / settings.py

    ls -a  # 查看隐藏文件
    nano .env  # 使用 nano 编辑器打开
  2. 修改配置内容
    将以下内容填入(根据实际文件名调整键名):

    # --- 阿里云百炼配置 (大脑) ---
    DASHSCOPE_API_KEY=sk-你的真实APIKey
    MODEL_NAME=qwen-plus  # 或 qwen-turbo, qwen-max
    
    # --- 机器人平台配置 (以钉钉为例) ---
    DINGTALK_APP_KEY=你的钉钉AppKey
    DINGTALK_APP_SECRET=你的钉钉AppSecret
    DINGTACK_WEBHOOK_PORT=8080  # 接收消息的端口
    
    # --- 其他配置 ---
    LOG_LEVEL=INFO
    HOST=0.0.0.0  # 必须设为 0.0.0.0 允许外部访问
    PORT=8080

    保存退出:按 Ctrl+O -> Enter -> Ctrl+X

  3. 配置安全组 (防火墙)

    • 回到阿里云 ECS 控制台 -> 实例详情 -> 防火墙/安全组

    • 添加规则:放行您配置的端口(如 8080),授权对象填 0.0.0.0/0

    • 注意:如果在钉钉/飞书后台配置了回调地址,必须是公网 IP + 端口,例如 http://1.2.3.4:8080/callback


第五步:运行与守护进程 (让机器人 24 小时在线)

直接运行 python main.py 会在关闭终端后停止。我们需要用 SystemdScreen 让它后台运行。

方案 A:使用 Screen (简单快捷)

# 1. 安装 screen (如果未安装)
sudo apt install screen -y

# 2. 创建一个名为 bot 的会话
screen -S bot

# 3. 在会话中运行启动脚本 (具体脚本名看项目说明,通常是 main.py 或 app.py)
python3 main.py 

# 4. 暂时离开会话 (机器人继续运行)
# 按键盘:Ctrl + A,然后按 D

# 5. 以后想查看日志或停止,输入:
screen -r bot

方案 B:使用 Systemd (专业,开机自启 - 推荐)

创建一个服务文件,让服务器重启后机器人自动运行。

  1. 创建服务文件

    sudo nano /etc/systemd/system/openclaw.service
  2. 填入以下内容 (注意修改路径):

    [Unit]
    Description=OpenClaw Bot Service
    After=network.target
    
    [Service]
    User=root
    WorkingDirectory=/opt/openclaw
    Environment="PATH=/opt/openclaw/venv/bin"
    ExecStart=/opt/openclaw/venv/bin/python3 main.py
    Restart=always
    RestartSec=10
    
    [Install]
    WantedBy=multi-user.target
  3. 启动服务

    # 重载配置
    sudo systemctl daemon-reload
    
    # 启动服务
    sudo systemctl start openclaw
    
    # 设置开机自启
    sudo systemctl enable openclaw
    
    # 查看运行状态
    sudo systemctl status openclaw

    看到 Active: active (running) 即表示成功。


第六步:对接机器人平台 (最后一步)

  1. 获取公网 IP
    在 ECS 控制台查看您的实例公网 IP 地址(例如 123.123.123.123)。

  2. 配置回调地址

    • 登录 钉钉开放平台 (或飞书/企业微信)。

    • 找到您的应用 -> 事件订阅回调配置

    • 填写回调 URL:http://<您的公网IP>:8080/callback (端口和路径需与 OpenClaw 配置一致)。

    • 填写加密密钥(如果有)。

  3. 验证

    • 开放平台通常会发送一个验证请求。

    • 查看服务器日志:sudo journalctl -u openclaw -f

    • 如果日志显示验证通过,恭喜您,部署完成!


🛠️ 常见问题排查 (FAQ)

问题现象可能原因解决方案
连接超时/无法回调安全组未放行端口去阿里云控制台安全组添加入方向规则,放行 8080。
ModuleNotFoundError依赖没装全激活虚拟环境 source venv/bin/activate 后重新 pip install -r requirements.txt
API Key 无效配置错误或欠费检查 .env 文件中 Key 是否有空格;去百炼控制台确认账户余额。
机器人不回复代码逻辑错误或未通过验证查看日志 journalctl -u openclaw -f,根据报错信息修复。
端口被占用其他程序用了 8080修改 OpenClaw 配置中的端口,或杀掉占用进程 lsof -i:8080

💡 2026 年新特性提示

  • Serverless 部署:如果您不想维护服务器,2026 年阿里云函数计算 (FC) 对 Python 支持更好,可以将 OpenClaw 改造为 Serverless 模式,按调用次数付费,成本更低。

  • 容器化:如果项目提供 Dockerfile,直接使用 docker run 部署会更简单,无需配置 Python 环境。

祝您部署顺利,让 OpenClaw 成为您的得力助手!