在 2026 年,部署 OpenClaw(原 Clawdbot)到阿里云服务器(ECS)的流程已经非常成熟。OpenClaw 本质上是一个基于 Python 的机器人框架,通常用于对接钉钉、飞书或微信,并调用大模型(如阿里云百炼的通义千问)进行智能回复。
以下是一份2026 年最新版保姆级教程,涵盖从购买服务器到机器人跑通的全流程。
📋 准备工作
阿里云账号:已实名认证。
阿里云百炼 API Key:
访问 阿里云百炼控制台 -> API-KEY 管理 -> 创建并复制 Key(以
sk-开头)。机器人应用配置:
如果您对接钉钉/飞书,需先在开放平台创建应用,获取
AppKey、AppSecret和Webhook地址。一台云服务器 (ECS):
推荐配置:2核 CPU / 2GB 内存 / 40GB 磁盘(轻量应用服务器即可,约 ¥60-90/年)。
系统镜像:推荐选择 Ubuntu 22.04 LTS 或 Alibaba Cloud Linux 3(兼容性好,文档多)。
第一步:购买并初始化阿里云 ECS
购买实例:
登录 阿里云 ECS 控制台。
点击“创建实例”,选择“轻量应用服务器”或“云服务器 ECS”。
地域:选离您最近的(如杭州、北京)。
镜像:选择 Ubuntu 22.04。
网络:确保安全组放行 SSH (22) 端口。如果机器人需要接收 Webhook,建议先放行 80/443 或自定义端口(如 8080)。
设置登录密码(记住它!)。
连接服务器:
在 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 需要通过配置文件或环境变量来连接大模型和机器人平台。
找到配置文件:
通常在根目录下有一个.env文件,或者config.yaml/settings.py。ls -a # 查看隐藏文件 nano .env # 使用 nano 编辑器打开
修改配置内容:
将以下内容填入(根据实际文件名调整键名):# --- 阿里云百炼配置 (大脑) --- 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。配置安全组 (防火墙):
回到阿里云 ECS 控制台 -> 实例详情 -> 防火墙/安全组。
添加规则:放行您配置的端口(如
8080),授权对象填0.0.0.0/0。注意:如果在钉钉/飞书后台配置了回调地址,必须是公网 IP + 端口,例如
http://1.2.3.4:8080/callback。
第五步:运行与守护进程 (让机器人 24 小时在线)
直接运行 python main.py 会在关闭终端后停止。我们需要用 Systemd 或 Screen 让它后台运行。
方案 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 (专业,开机自启 - 推荐)
创建一个服务文件,让服务器重启后机器人自动运行。
创建服务文件:
sudo nano /etc/systemd/system/openclaw.service
填入以下内容 (注意修改路径):
[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
启动服务:
# 重载配置 sudo systemctl daemon-reload # 启动服务 sudo systemctl start openclaw # 设置开机自启 sudo systemctl enable openclaw # 查看运行状态 sudo systemctl status openclaw
看到
Active: active (running)即表示成功。
第六步:对接机器人平台 (最后一步)
获取公网 IP:
在 ECS 控制台查看您的实例公网 IP 地址(例如123.123.123.123)。配置回调地址:
登录 钉钉开放平台 (或飞书/企业微信)。
找到您的应用 -> 事件订阅 或 回调配置。
填写回调 URL:
http://<您的公网IP>:8080/callback(端口和路径需与 OpenClaw 配置一致)。填写加密密钥(如果有)。
验证:
开放平台通常会发送一个验证请求。
查看服务器日志:
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 成为您的得力助手!