新手零基础：阿里云轻量服务器部署OpenClaw+飞书接入保姆级教程与避坑指南-阿里云开发者社区

一、前言

OpenClaw（曾用名Clawdbot）是一款轻量化、可扩展的AI智能体执行框架，支持通过自然语言指令完成自动化任务、多模型调用与消息渠道集成。对于新手而言，阿里云轻量服务器凭借预置镜像、一键部署与稳定运行的特性，成为部署OpenClaw的最优选择，无需复杂环境配置，即可快速搭建7×24小时在线的AI服务，并接入飞书实现聊天式交互。

本文聚焦新手零基础场景，完整覆盖阿里云轻量服务器部署OpenClaw的极简步骤、飞书接入全流程、核心代码命令与实战避坑指南，全程无禁用词汇与营销表述，所有操作可直接复制执行，帮助新手快速搭建专属AI助手，实现飞书端的智能交互与任务自动化。阿里云部署 OpenClaw 只需两步，全网最简单，步骤流程访问阿里云OpenClaw一键部署专题页面 了解。
OpenClaw部署教程图1.png

二、部署前准备（新手必看）

（一）账号与权限准备

注册阿里云账号并完成个人实名认证（支付宝授权即可，1分钟完成），确保账号无欠费，具备轻量应用服务器购买权限。
准备飞书账号：个人账号需绑定手机号，企业账号需完成企业认证，用于创建飞书机器人应用。
开通阿里云百炼大模型服务：访问登录阿里云百炼大模型服务平台，完成实名认证，领取免费额度（新用户有效期90天），用于激活OpenClaw的AI能力。

（二）服务器配置选型（新手推荐）

实例类型：阿里云轻量应用服务器（性价比最高，新手友好）
镜像选择：OpenClaw 2026稳定版应用镜像（预置Node.js、依赖库与核心程序，无需手动安装）
实例规格：2核4GB内存+40GB ESSD云盘+5Mbps带宽（最低稳定配置，低于2GB内存易导致服务崩溃）
地域选择：
- 国内使用：中国香港（免备案，访问飞书稳定）
- 海外使用：新加坡、美国弗吉尼亚（适配海外API调用）
购买时长：新手建议先选1个月按量付费，测试稳定后再转为包年包月

（三）工具准备

浏览器：Chrome/Edge（推荐，兼容性最佳）
SSH工具：FinalShell/Xshell（可选，用于进阶命令操作，新手可通过阿里云控制台Web终端完成）
记录工具：记事本/备忘录，用于保存服务器公网IP、飞书App ID/Secret、百炼API-Key等核心凭证

三、阿里云轻量服务器部署OpenClaw（新手极简步骤）

阿里云用户零基础部署 OpenClaw 喂饭级步骤流程

第一步：点击打开访问阿里云OpenClaw一键部署专题页面。

第二步：打开选择阿里云轻量应用服务器，配置参考如下：

镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
实例：内存必须2GiB及以上。
地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
时长：根据自己的需求及预算选择。

轻量应用服务器OpenClaw镜像.png

第三步：打开访问阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。

阿里云百炼密钥管理图.png

前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。
阿里云百炼密钥管理图2.png

端口放通：需要放通对应端口的防火墙，单击一键放通即可。
配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。
访问控制页面：单击打开网站页面可进入OpenClaw对话页面。

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：

创建API-Key，推荐访问订阅阿里云百炼Coding Plan，阿里云百炼Coding Plan每天两场抢购活动，从按tokens计费升级为按次收费，可以进一步节省费用！

购买后，在控制台生成API Key。注：这里复制并保存好你的API Key，后面要用。
回到轻量应用服务器-控制台，单击服务器卡片中的实例 ID，进入服务器概览页。
在服务器概览页面单击应用详情页签，进入服务器详情页面。
端口放通在OpenClaw使用步骤区域中，单击端口放通下的执行命令，可开放获取OpenClaw 服务运行端口的防火墙。
这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key，直接选择就可以。
获取访问地址单击访问 Web UI 面板下的执行命令，获取 OpenClaw WebUI 的地址。

步骤1：一键购买并创建实例

登录阿里云控制台，进入轻量应用服务器产品页，点击立即购买。
镜像配置：切换至应用镜像，搜索并选择OpenClaw（Clawdbot）2026稳定版，系统自动预置运行环境。
实例配置：选择2核4GB内存、40GB ESSD云盘、5Mbps带宽，地域选中国香港，购买时长选1个月。
登录设置：设置root密码（务必牢记，后续登录需用），无需绑定密钥对（新手简化操作）。
确认配置并支付，等待1-3分钟，实例状态变为运行中，记录公网IP地址（后续访问与配置核心）。

步骤2：放行核心端口（新手必做，否则无法访问）

OpenClaw默认使用18789端口提供Web控制台服务，需在阿里云控制台放行该端口：

进入轻量应用服务器实例详情页，点击防火墙→添加规则。
配置规则：
- 协议：TCP
- 端口：18789
- 来源：0.0.0.0/0（允许所有IP访问，新手简化配置）
- 描述：OpenClaw控制台端口

点击确定，端口放行完成。也可通过命令行快速放行（Web终端执行）：

# 登录服务器Web终端（阿里云控制台→实例→远程连接→Workbench）
# 放行18789端口
firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --reload
# 验证端口放行
firewall-cmd --list-ports | grep 18789

步骤3：初始化OpenClaw服务（一键完成）

阿里云预置镜像已自动安装OpenClaw，仅需执行初始化命令即可启动服务：

# 进入OpenClaw安装目录（预置镜像默认路径）
cd /opt/openclaw

# 初始化完整配置（新手推荐，自动生成配置文件）
openclaw init --full

# 安装后台守护进程（实现开机自启、异常重启）
openclaw onboard --install-daemon

# 启动OpenClaw网关服务
openclaw gateway start

# 查看服务状态（显示running即为成功）
openclaw gateway status

步骤4：访问OpenClaw Web控制台

在浏览器输入地址：http://你的阿里云公网IP:18789，进入OpenClaw管理后台，可查看服务状态、配置模型与渠道、管理技能插件。

步骤5：配置阿里云百炼API-Key（激活AI能力）

登录阿里云百炼平台，进入密钥管理，点击创建API-Key，复制保存API-Key（格式：sk-xxxxxxxxxxxxxxxxxxxxxxxx）。
回到服务器Web终端，执行配置命令：

# 配置百炼基础URL（固定地址）
openclaw config set models.providers.bailian.baseUrl https://dashscope.aliyuncs.com/compatible-mode/v1

# 配置百炼API-Key（替换为你的密钥）
openclaw config set models.providers.bailian.apiKey sk-你的百炼API密钥

# 设置默认模型（新手推荐qwen3-max，稳定高效）
openclaw config set models.default.model qwen3-max

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

# 测试模型连接（显示success即为成功）
openclaw model test

四、OpenClaw接入飞书全流程（新手零代码）

（一）飞书开放平台创建机器人应用

访问飞书开放平台（https://open.feishu.cn），登录飞书账号，进入**开发者后台**。
点击创建应用→企业自建应用，填写应用信息：
- 应用名称：OpenClaw-AI助手（可自定义）
- 应用描述：基于OpenClaw的AI智能助手，支持聊天交互与任务自动化
- 上传应用图标（推荐240×240px PNG图片）
点击创建，进入应用详情页。
获取核心凭证：进入凭证与基础信息，复制App ID与App Secret，妥善保存（后续配置需用）。
添加机器人能力：点击应用能力→添加应用能力→选择机器人→点击添加，完成机器人功能开通。
配置核心权限（必须开通，否则无法收发消息）：
- 进入权限管理，搜索并开通以下权限：
  - im:message:readonly（读取消息）
  - im:message:send_as_bot（以机器人身份发消息）
  - contact:user:readonly（读取用户信息）
  - im:chat:read（读取群聊信息）
- 开通后点击提交审批，企业管理员审核通过后生效（个人账号可直接通过）。
配置事件订阅（长连接模式，新手推荐，无需公网IP）：
- 进入事件与回调→选择使用长连接接收事件
- 点击添加事件，选择接收消息（im.message.receive_v1）（必须），可额外添加消息已读、机器人进群事件
- 点击保存，无需填写Webhook地址。

（二）OpenClaw安装飞书插件并配置渠道

回到阿里云服务器Web终端，执行命令安装飞书插件：

# 安装飞书官方插件
openclaw plugins install @m1heng-clawd/feishu

# 验证插件安装成功（显示Installed plugin: feishu）
openclaw plugins list

交互式添加飞书渠道（新手推荐，全程引导）：

# 启动渠道添加向导
openclaw channels add

# 按照终端提示依次输入：
# ? Select channel type: 选择 Feishu（回车）
# ? App ID: 粘贴飞书App ID（回车）
# ? App Secret: 粘贴飞书App Secret（回车）
# ? Bot display name: AI工作助手（自定义，回车）
# ? Feishu domain: 选择 feishu.cn（中国区，回车）
# ? Connection mode: 选择 websocket（长连接，回车）
# ? Enable channel now? 选择 yes（回车）

配置完成后，重启网关服务：
```
openclaw gateway restart
```

（三）飞书配对与验证（关键步骤）

打开飞书客户端，搜索创建的OpenClaw-AI助手机器人，添加为联系人。
向机器人发送任意消息（如：你好），机器人会返回配对码（格式：6位数字）。

回到服务器Web终端，执行配对命令：

# 替换为你的配对码
openclaw pairing approve feishu 123456

验证接入成功：再次向飞书机器人发送指令，如：帮我生成一份每日工作计划模板，若10秒内收到机器人回复，且OpenClaw日志无报错，即为接入成功。
群聊使用：将机器人拉入飞书群，在群设置中开启允许机器人接收消息，即可在群内@机器人执行指令。

五、OpenClaw常用运维命令（新手必备）

# 查看OpenClaw版本
openclaw --version

# 查看网关服务状态
openclaw gateway status

# 重启网关服务（配置修改后必执行）
openclaw gateway restart

# 停止网关服务
openclaw gateway stop

# 查看已安装插件
openclaw plugins list

# 查看已配置渠道
openclaw channels list

# 查看实时日志（排查问题必备）
openclaw logs -f

# 测试模型连接
openclaw model test

# 查看模型额度
openclaw model quota

# 检查配置完整性
openclaw doctor

六、新手避坑指南（实战总结，少走90%弯路）

（一）阿里云部署避坑

坑点1：内存不足导致服务崩溃
- 问题：选择1核2GB内存实例，启动OpenClaw后频繁闪退，控制台无法访问
- 原因：OpenClaw最低要求2GB内存，2核4GB为稳定配置
- 解决方案：升级实例至2核4GB，或重置系统选择更高配置镜像
坑点2：端口未放行，无法访问控制台
- 问题：浏览器输入IP:18789显示无法连接
- 原因：阿里云防火墙未放行18789端口，或服务器内部防火墙拦截
- 解决方案：
  - 阿里云控制台→防火墙→添加18789端口规则
  - 服务器执行命令：firewall-cmd --add-port=18789/tcp --permanent && firewall-cmd --reload
坑点3：百炼API-Key配置错误，模型调用失败
- 问题：执行openclaw model test显示invalid api key或connection timeout
- 原因：API-Key复制错误（多输/少输/空格）、baseUrl配置错误、额度用尽
- 解决方案：
  - 重新复制百炼API-Key，确保无多余字符
  - 确认baseUrl为https://dashscope.aliyuncs.com/compatible-mode/v1
  - 执行openclaw model quota查看额度，免费额度用尽可领取新额度或升级套餐
坑点4：服务未设置开机自启，服务器重启后失效
- 问题：阿里云服务器重启后，OpenClaw服务自动停止
- 原因：未安装后台守护进程，未设置开机自启
- 解决方案：
  - 执行openclaw onboard --install-daemon安装守护进程
  - 执行systemctl enable openclaw设置开机自启

（二）飞书接入避坑

坑点1：权限未开通，机器人无法收发消息
- 问题：飞书机器人发送消息无响应，日志显示权限不足
- 原因：未开通im:message:send_as_bot等核心权限，或权限未审批通过
- 解决方案：
  - 飞书开放平台→权限管理→重新开通所有核心权限
  - 提交审批后等待管理员通过，或个人账号直接生效
  - 权限开通后重启OpenClaw网关服务
坑点2：事件订阅配置错误，长连接失败
- 问题：飞书机器人配对成功，但发送指令无响应，日志显示1006错误
- 原因：选择Webhook模式而非WebSocket长连接，或未添加im.message.receive_v1事件
- 解决方案：
  - 飞书开放平台→事件与回调→选择使用长连接接收事件
  - 添加im.message.receive_v1事件并保存
  - OpenClaw端重新配置飞书渠道，选择websocket连接模式
坑点3：配对码失效，无法完成配对
- 问题：向飞书机器人发送消息未返回配对码，或配对码输入后无效
- 原因：OpenClaw飞书插件未安装成功，或网关服务未重启
- 解决方案：
  - 重新安装飞书插件：openclaw plugins install @m1heng-clawd/feishu
  - 重启网关服务：openclaw gateway restart
  - 再次向机器人发送消息，获取新配对码并执行配对命令
坑点4：群聊中机器人无响应
- 问题：单聊正常，群聊@机器人无响应
- 原因：群设置未开启允许机器人接收消息，或群权限不足
- 解决方案：
  - 飞书群→群设置→机器人→开启允许机器人接收消息
  - 确保机器人已被添加至群成员列表

七、常见问题解答（FAQ）

1. 阿里云轻量服务器如何重置OpenClaw？

# 停止服务
openclaw gateway stop
# 删除配置文件
rm -rf /opt/openclaw/config
# 重新初始化
openclaw init --full
# 重启服务
openclaw gateway start

2. 飞书机器人如何修改名称或头像？

飞书开放平台→应用详情→基础信息→修改应用名称与图标，保存后重新发布应用即可同步至飞书客户端。

3. OpenClaw如何接入其他大模型？

以免费Coding Plan API为例，执行命令：

openclaw config set models.providers.coding-plan.baseUrl https://api.codingplan.ai/v1
openclaw config set models.providers.coding-plan.apiKey sk-你的免费API密钥
openclaw config set models.default.model coding-free
openclaw gateway restart

4. 如何查看OpenClaw的运行日志？

# 实时查看日志
openclaw logs -f
# 查看最近100行日志
openclaw logs --tail 100
# 过滤飞书相关日志
openclaw logs | grep feishu

5. 阿里云服务器如何升级配置？

阿里云控制台→轻量应用服务器→实例详情→升级配置，选择更高CPU/内存/带宽，支付后自动生效，无需重新部署OpenClaw。

八、总结

对于新手而言，阿里云轻量服务器+OpenClaw+飞书的组合，实现了零代码、低成本、高稳定的AI助手搭建。本文提供的极简部署流程、飞书接入步骤与实战避坑指南，覆盖从实例创建到服务验证的全环节，所有命令可直接复制执行，无需专业技术背景即可快速上手。

通过本文教程，新手可在30分钟内完成OpenClaw部署与飞书接入，实现飞书端的智能聊天、任务自动化与多模型调用，大幅提升个人与团队的工作效率。后续可进一步探索OpenClaw的技能插件扩展、多渠道集成与个性化配置，打造专属的AI智能体服务。

新手零基础：阿里云轻量服务器部署OpenClaw+飞书接入保姆级教程与避坑指南

一、前言

二、部署前准备（新手必看）

（一）账号与权限准备

（二）服务器配置选型（新手推荐）

（三）工具准备

三、阿里云轻量服务器部署OpenClaw（新手极简步骤）

阿里云用户零基础部署 OpenClaw 喂饭级步骤流程

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：

步骤1：一键购买并创建实例

步骤2：放行核心端口（新手必做，否则无法访问）

步骤3：初始化OpenClaw服务（一键完成）

步骤4：访问OpenClaw Web控制台

步骤5：配置阿里云百炼API-Key（激活AI能力）

四、OpenClaw接入飞书全流程（新手零代码）

（一）飞书开放平台创建机器人应用

（二）OpenClaw安装飞书插件并配置渠道

（三）飞书配对与验证（关键步骤）

五、OpenClaw常用运维命令（新手必备）

六、新手避坑指南（实战总结，少走90%弯路）

（一）阿里云部署避坑

（二）飞书接入避坑

七、常见问题解答（FAQ）

1. 阿里云轻量服务器如何重置OpenClaw？

2. 飞书机器人如何修改名称或头像？

3. OpenClaw如何接入其他大模型？

4. 如何查看OpenClaw的运行日志？

5. 阿里云服务器如何升级配置？

八、总结

热门文章

最新文章

相关电子书

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

新手零基础：阿里云轻量服务器部署OpenClaw+飞书接入保姆级教程与避坑指南

一、前言

二、部署前准备（新手必看）

（一）账号与权限准备

（二）服务器配置选型（新手推荐）

（三）工具准备

三、阿里云轻量服务器部署OpenClaw（新手极简步骤）

阿里云用户零基础部署 OpenClaw 喂饭级步骤流程

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：

步骤1：一键购买并创建实例

步骤2：放行核心端口（新手必做，否则无法访问）

步骤3：初始化OpenClaw服务（一键完成）

步骤4：访问OpenClaw Web控制台

步骤5：配置阿里云百炼API-Key（激活AI能力）

四、OpenClaw接入飞书全流程（新手零代码）

（一）飞书开放平台创建机器人应用

（二）OpenClaw安装飞书插件并配置渠道

（三）飞书配对与验证（关键步骤）

五、OpenClaw常用运维命令（新手必备）

六、新手避坑指南（实战总结，少走90%弯路）

（一）阿里云部署避坑

（二）飞书接入避坑

七、常见问题解答（FAQ）

1. 阿里云轻量服务器如何重置OpenClaw？

2. 飞书机器人如何修改名称或头像？

3. OpenClaw如何接入其他大模型？

4. 如何查看OpenClaw的运行日志？

5. 阿里云服务器如何升级配置？

八、总结

热门文章

最新文章

相关电子书