实战部署OpenClaw

大家好，最近一直在折腾开源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 firewalldsudo 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 --versionnpm --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对接千问

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

# 配置百炼AccessKeyopenclaw 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 openclawopenclaw gateway restart

4.3 验证大模型对接

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

# 生成访问Tokenopenclaw 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系统的核心命令汇总：

# 查看所有已安装的Skillsopenclaw skill list# 安装新Skills（示例：Linux文件管理、定时任务）clawhub install file-managerclawhub install schedule-task# 卸载不需要的Skillsopenclaw 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助理。

作者：豆芽包链接：https://juejin.cn/post/7615590290816794666