实战部署OpenClaw

豆芽包
45 阅读7分钟

实战部署OpenClaw：阿里云ECS+千问+钉钉

大家好，最近一直在折腾开源AI智能体框架，挖到了OpenClaw（原名Clawdbot） 这个宝藏工具——支持私有化部署、对接主流大模型，还能接入钉钉/飞书等IM平台，把AI助理搬进日常办公场景。

本篇全程基于阿里云ECS（Alibaba Cloud Linux 3.2104 LTS 64位） 原生系统实操，手把手教大家部署OpenClaw，对接阿里云百炼千问大模型，并完成钉钉机器人接入，实现群聊/单聊直接调用AI执行任务，文末附上新手高频坑和排查思路，零基础也能跟着跑通。

核心亮点：阿里云原生Linux系统兼容性拉满、私有化部署不泄露数据、7×24小时云端运行、钉钉原生交互无风控、千问大模型国内访问零延迟，还能通过Skills扩展自动化能力。

一、前期准备：软硬件&账号清单

部署前先把物料备齐，避免中途卡壳，适配Alibaba Cloud Linux 3系统：

  • Linux云端服务器：阿里云ECS（推荐2核2G起步，Alibaba Cloud Linux 3.2104 LTS 64位系统，公网IP+安全组放行端口）
  • 账号权限：阿里云账号（完成实名认证）、钉钉账号（可创建测试企业/内部应用）
  • 大模型密钥：阿里云百炼API Key（开通百炼，创建AccessKey，保存好ID和Secret）
  • 工具：SSH连接工具（Xshell/FinalShell/阿里云Workbench）、浏览器

二、第一步：阿里云ECS（Alibaba Cloud Linux 3）基础配置

OpenClaw依赖Node.js环境，Alibaba Cloud Linux 3采用yum/dnf包管理器，先给服务器做初始化和环境配置，这一步是后续部署的根基。

2.1 服务器选型&安全组放行

  1. ECS实例硬性要求：2核2G、40G云盘、Alibaba Cloud Linux 3.2104 LTS 64位，个人测试按量付费即可，长期使用选包年包月

  2. 安全组放行核心端口（必须配置，否则服务无法外网访问）：

    1. 22端口：SSH远程连接服务器
    2. 18789端口：OpenClaw核心通信&Web控制台
    3. 80/443端口：钉钉回调备用

2.2 服务器环境初始化（适配Alibaba Cloud Linux 3）

通过SSH或阿里云Workbench连接ECS后，执行以下命令更新系统、安装基础依赖，区别于Ubuntu，这里用yum命令：

# 更新系统软件源（Alibaba Cloud Linux 3专用）
sudo yum update -y && sudo yum upgrade -y

# 安装Git、curl、firewalld防火墙等基础工具
sudo yum install -y git curl firewalld

# 启动并设置防火墙开机自启
sudo systemctl start firewalld
sudo systemctl enable firewalld

# 安装Node.js 22+（OpenClaw强制要求高版本，添加官方源）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
# 兼容Alibaba Cloud Linux 3，执行yum安装
sudo yum install -y nodejs

# 验证版本（必须满足Node≥22.0.0，npm≥10.0.0）
node --version
npm --version

三、第二步：OpenClaw安装与初始化

环境就绪后，开始全局安装OpenClaw，完成初始化配置，全程适配Alibaba Cloud Linux 3系统。

3.1 安装OpenClaw

# 全局安装最新稳定版
npm install -g openclaw@latest

# 验证安装（输出版本号即为安装成功）
openclaw --version

3.2 初始化配置（一键引导）

执行初始化命令，按交互提示一步步配置，新手默认选项即可，同时配置开机自启：

# 初始化并配置系统守护进程（开机自启）
openclaw onboard --install-daemon

交互步骤关键提示：

  • 初始化模式：选 QuickStart 快速模式
  • 模型提供商：暂时选默认，后续替换为百炼千问
  • 通讯渠道：输入 Skip for now 跳过，后续配置钉钉
  • 技能初始化：输入 Yes，启用基础Skills能力

3.3 启动服务&防火墙放行端口

# 启动OpenClaw服务
sudo systemctl start openclaw

# 设置开机自启（服务器重启后自动运行）
sudo systemctl enable openclaw

# 防火墙放行18789端口（Alibaba Cloud Linux 3专属操作）
sudo firewall-cmd --zone=public --add-port=18789/tcp --permanent
# 重载防火墙生效
sudo firewall-cmd --reload

# 查看服务状态（显示active (running)即为正常运行）
sudo systemctl status openclaw

四、第三步：对接阿里云百炼千问大模型

OpenClaw默认模型国内访问不稳定，替换成阿里云百炼的通义千问，和ECS同地域访问，响应更快、兼容性更强。

4.1 获取百炼API Key

  1. 登录阿里云百炼控制台，进入左侧密钥管理模块
  2. 创建API Key，妥善保存AccessKey ID 和 AccessKey Secret（仅显示一次，务必备份）

4.2 配置OpenClaw对接千问

执行命令一键配置，替换成自己的密钥信息，配置后重启服务生效：

# 配置百炼AccessKey
openclaw config set models.providers.bailian.accessKeyId "你的AK ID"
openclaw config set models.providers.bailian.accessKeySecret "你的AK Secret"

# 配置国内官方API地址
openclaw config set models.providers.bailian.baseUrl "https://dashscope.aliyuncs.com/compatible-mode/v1"

# 设置默认模型（推荐qwen3-max，兼顾性能与成本）
openclaw config set models.default "qwen3-max"

# 重启服务+网关生效
sudo systemctl restart openclaw
openclaw gateway restart

4.3 验证大模型对接

生成Web控制台Token，测试AI对话功能：

# 生成访问Token
openclaw token generate

# 查看并复制Token（直接执行即可输出）
cat ~/.openclaw/openclaw.json | grep '"token"' | awk -F'"' '{print $4}'

浏览器访问：http://ECS公网IP:18789/?token=你的Token，发送对话指令，能正常回复即为大模型对接成功。

五、第四步：接入钉钉机器人（群聊直接调用AI）

这是最实用的一步，把OpenClaw变成钉钉机器人，群里@就能发指令、执行任务，全程原生适配无风控，适合团队协作使用。

5.1 安装钉钉Skills插件

OpenClaw通过Skills扩展能力，钉钉对接需要安装专属插件，命令通用无系统差异：

# 安装钉钉机器人插件
clawhub install dingtalk-bot

# 验证插件安装成功
openclaw skill list | grep "dingtalk-bot"

5.2 钉钉开放平台创建机器人

  1. 登录钉钉开放平台，创建测试企业+企业内部应用（无需企业认证，测试专用）
  2. 进入应用后台，开启机器人功能，记录 AppKey、AppSecret、AgentId 三大参数
  3. 配置事件订阅，回调地址填写：http://ECS公网IP:18789/api/channels/dingtalk
  4. 勾选接收消息、消息已读权限，保存并发布应用

5.3 配置OpenClaw钉钉参数

# 替换为你的钉钉机器人参数
openclaw config set channels.dingtalk.appKey "你的AppKey"
openclaw config set channels.dingtalk.appSecret "你的AppSecret"
openclaw config set channels.dingtalk.agentId "你的AgentId"

# 重启网关生效配置
openclaw gateway restart

5.4 功能测试

把机器人拉进钉钉群，发送指令测试联动效果：

  • @机器人 + 帮我写一份技术博客大纲
  • @机器人 + 查看当前Linux服务器状态

机器人自动回复、执行指令，即为钉钉接入成功！

六、Skills用法：解锁OpenClaw自动化能力

OpenClaw的Skills怎么用，其实就是AI的“技能库”，开箱即用+自定义扩展，适配Alibaba Cloud Linux 3系统的核心命令汇总：

# 查看所有已安装的Skills
openclaw skill list

# 安装新Skills（示例：Linux文件管理、定时任务）
clawhub install file-manager
clawhub install schedule-task

# 卸载不需要的Skills
openclaw skill uninstall 技能名

# 查看单个Skills使用帮助
openclaw skill help 技能名

适配Linux服务器的常用Skills推荐：

  • dingtalk-bot：钉钉消息交互（已安装）
  • file-manager：Alibaba Cloud Linux服务器文件读写、整理、备份
  • code-runner：代码运行、调试、语法检查
  • schedule-task：定时任务、消息推送、服务器巡检

七、新手避坑：Alibaba Cloud Linux 3专属问题排查

这部分是针对Alibaba Cloud Linux 3系统的踩坑总结，遇到问题先看这里，90%的故障都能快速解决

  1. Web控制台无法访问：检查ECS安全组18789端口放行、firewalld防火墙是否开放端口、OpenClaw服务是否正常运行
  2. 千问模型调用失败：核对AK密钥是否正确、API地址是否为国内版、百炼账号是否有可用额度
  3. 钉钉机器人不回复：检查回调地址是否正确、AgentId/AppKey是否填错、服务是否重启生效
  4. OpenClaw启动崩溃：Alibaba Cloud Linux 3内存不足（升级2核2G以上）、Node.js版本过低不兼容
  5. Skills安装失败：切换npm淘宝镜像、检查服务器网络连通性，重试安装命令
  6. yum安装依赖报错：执行sudo yum clean all && sudo yum makecache刷新软件源重试

八、部署总结

整套流程基于Alibaba Cloud Linux 3.2104 LTS原生系统跑通，不仅成功在阿里云ECS私有化部署了OpenClaw，还完成了千问大模型+钉钉的全链路闭环，打造了一个7×24小时在线的专属AI助理。

avatar
文章
阅读
粉丝