OpenClaw 部署指南 — GC俱乐部PR团队

本指南面向GC俱乐部PR团队的6名成员（包括主席和VPPR）。目标是为每位成员部署一套独立的OpenClaw AI助手，并通过飞书实现智能消息互动。整个流程分三个阶段，你只需完成阶段一和阶段三的部分操作，其余由Warren统一处理。

📋 操作流程总览

1 阶段一：申请阿里云ECS服务器你来做

2 阶段二：OpenClaw环境部署 Warren来做

3 阶段三：飞书应用集成你来做 + Warren来做

4 阶段四：验证与故障排查

你申请服务器

→

把信息给Warren

→

Warren远程部署

→

配置飞书连通

→

✅ 上线使用

✦ ✦ ✦

阶段一：申请阿里云ECS服务器

团队成员操作每位PR成员需要申请一台自己的云服务器，用于运行OpenClaw服务。以下是详细步骤。

🔐

Step 1：注册/登录阿里云

如已有账号可跳过

1访问 aliyun.com，点击右上角"免费注册"或"登录"
2推荐使用支付宝扫码快速注册，自动完成实名认证
3注册完成后，进入阿里云控制台首页

📸 参考截图：阿里云注册页面
打开 aliyun.com → 点击"免费注册" → 支付宝扫码完成

🖥️

Step 2：购买ECS云服务器

注意选择正确的配置

1在控制台搜索"ECS"，或直接访问 ecs.console.aliyun.com
2点击"创建实例"（或点击左侧导航"实例" → "创建实例"）
3按照下方配置要求逐项选择

📌 必需配置要求

配置项	推荐选择
付费模式	按量付费（测试阶段）或包年包月（长期使用更省钱）
地域	华北2（北京）或华东1（杭州）— 选离你近的
实例规格	ecs.c7.large（2核4G）或以上 ⚠️ 最低要求：2核CPU + 4GB内存
操作系统	Ubuntu 22.04 64位（必须选这个！）
系统盘	高效云盘，40GB 以上
公网带宽	勾选"分配公网IPv4地址"，按使用流量计费，带宽上限选 5Mbps
安全组	使用默认安全组（后面需开放端口，见下文）
登录凭证	自定义密码— 设置root密码（请牢记！）

⚠️ 重要提醒：操作系统必须选 Ubuntu 22.04 64位，不要选 CentOS、Windows 或其他版本。OpenClaw 的安装脚本仅在 Ubuntu 22.04 上经过完整测试。

📸 参考截图：ECS实例创建页面
付费模式 → 地域选择 → 实例规格（2核4G） → 镜像选Ubuntu 22.04

🔓

Step 3：开放安全组端口

允许OpenClaw的网络访问

服务器创建完成后，需要在安全组中开放OpenClaw所需的端口：

1进入ECS控制台 → 点击你的实例 → 左侧选"安全组"
2点击安全组ID → "配置规则" → "手动添加"
3添加以下入方向规则：

端口范围	授权对象	说明
22/22	0.0.0.0/0	SSH远程连接（通常已默认开放）
18789/18789	0.0.0.0/0	OpenClaw Gateway 端口
443/443	0.0.0.0/0	HTTPS（飞书回调需要）

📸 参考截图：安全组规则配置页面
入方向 → 手动添加 → 端口范围填18789/18789 → 授权对象0.0.0.0/0

📋

Step 4：记录并提交服务器信息

发给Warren即可

服务器创建完成后，请记录以下信息，通过飞书私聊发送给Warren：

需要提供的信息	在哪里找
公网IP地址	ECS控制台 → 实例详情 → "公网IP"栏
登录用户名	固定为 `root`
登录密码	创建实例时你自己设置的密码
操作系统版本	确认是 Ubuntu 22.04

💡 发送示例（直接复制修改）：
Warren，我的服务器信息：
IP: xxx.xxx.xxx.xxx
用户名: root
密码: xxxxxxxx
系统: Ubuntu 22.04

🔒 安全提醒：密码信息请通过飞书私聊发送，不要发在群聊里。收到后Warren会尽快完成部署，部署完成后建议修改密码。

💰 费用参考

方案	配置	月费用（约）
入门方案	2核4G + 40G云盘 + 5Mbps	约 ¥100-150/月（包月）
按量付费	同上	约 ¥0.3-0.5/小时（用时才收费）
新用户优惠	阿里云新用户首购	可能低至 ¥50/月，具体看活动

✅ 阶段一完成标志：你已成功把服务器IP、用户名、密码发送给Warren。

✦ ✦ ✦

阶段二：OpenClaw环境部署

Warren操作收到你的服务器信息后，Warren会远程登录你的服务器，完成以下全部操作。你不需要做任何事，等通知就好。

⚙️

Warren的部署清单

以下仅供了解，无需你操作

2.1 系统环境准备

# 更新系统包
apt update && apt upgrade -y

# 安装必要依赖
apt install -y curl wget git build-essential

# 安装 Node.js 18+（OpenClaw 运行环境）
curl -fsSL https://deb.nodesource.com/setup_18.x | bash -
apt install -y nodejs

2.2 安装 OpenClaw

# 通过官方安装脚本一键安装
npm install -g @anthropic-ai/openclaw

# 验证安装
openclaw --version
openclaw doctor

2.3 配置并启动 Gateway

# 启动 OpenClaw Gateway 后台服务
nohup openclaw gateway > /root/openclaw.log 2>&1 &

# 检查是否正常运行
tail -20 /root/openclaw.log

# 验证端口监听
ss -tlnp | grep 18789

2.4 创建连接脚本

Warren会为你创建一个连接OpenClaw.bat文件，双击即可从本地电脑连接你的云端OpenClaw。

✅ 部署完成后，Warren会通知你："你的OpenClaw已部署完成，请进入阶段三创建飞书应用。"

✦ ✦ ✦

阶段三：飞书应用集成

团队成员操作这个阶段需要你在飞书开放平台创建一个应用，并把关键信息提供给Warren来完成对接。

📱

Step 1：创建飞书企业自建应用

在飞书开放平台操作

1访问 open.feishu.cn，使用你的飞书账号登录
2点击右上角"开发者后台" → 进入"应用开发"
3点击"创建企业自建应用"
4填写应用信息：
   • 应用名称：OpenClaw助手（或你喜欢的名称）
   • 应用描述：GC俱乐部AI助手
   • 应用图标：可随意上传一张图片

📸 参考截图：飞书开放平台 - 创建应用
open.feishu.cn → 开发者后台 → 创建企业自建应用 → 填写应用名称

🔑

Step 2：获取应用凭证

这是最关键的信息

应用创建完成后，进入应用详情页面：

1在左侧导航找到 "凭证与基础信息"
2记录以下两个关键信息：

凭证名称	说明
App ID	应用的唯一标识，格式类似：`cli_a5xxxxxxxxxxxxxx`
App Secret	应用密钥，点击"显示"按钮可查看，格式类似一串长字符

🔒 App Secret 是机密信息！请通过飞书私聊发送给Warren，不要截图发群、不要发朋友圈。

📸 参考截图：凭证与基础信息页面
应用详情 → 凭证与基础信息 → 复制 App ID 和 App Secret

🤖

Step 3：启用机器人能力

让应用能收发消息

1在应用详情页左侧，找到 "添加应用能力"
2点击添加 "机器人" 能力
3在机器人配置页面：
• Bot Name（机器人名称）：OpenClaw（或你喜欢的名字）
• 记下这个 Bot Name，后面要提供给Warren

📸 参考截图：添加机器人能力
应用能力 → 添加"机器人" → 填写 Bot Name

🛡️

Step 4：配置权限

授予必要的API权限

在应用详情页左侧，找到 "权限管理"，搜索并开通以下权限：

权限名称	用途
`im:message`	发送和接收消息
`im:message.group_at_msg`	接收群聊@消息
`im:message.p2p_msg`	接收私聊消息
`im:chat`	获取会话信息
`im:resource`	获取消息中的资源文件
`contact:user.base`	获取用户基本信息

💡 提示：在权限管理页面的搜索框中逐个输入上面的权限名称，找到后点击"开通"即可。有些权限可能需要管理员审批。

📸 参考截图：权限管理页面
权限管理 → 搜索 "im:message" → 点击"开通"

🌐

Step 5：配置事件订阅（关键步骤）

让飞书消息能推送到OpenClaw

这一步需要填入你的服务器地址，请等Warren通知你服务器部署完成后再操作。

1在应用详情页左侧，找到 "事件订阅"
2请求地址（Request URL）填入：
https://你的服务器IP:443/feishu/webhook
（具体地址Warren会告诉你）
3添加事件：搜索并订阅 im.message.receive_v1（接收消息事件）

📌 Verification Token 和 Encrypt Key：在事件订阅页面顶部可以看到这两个值，也请一并发给Warren。

📸 参考截图：事件订阅配置
事件订阅 → 填写请求地址 → 添加 im.message.receive_v1 事件

🚀

Step 6：发布应用

最后一步

1在应用详情页，点击 "版本管理与发布"
2点击 "创建版本" → 填写版本号（如 1.0.0）→ 点击"发布"
3如果你是企业管理员，直接审批通过；如果不是，需要联系管理员审批

✅ 发布后，你就可以在飞书中搜索你的机器人名字来找到它了。

📋 需要提交给Warren的飞书信息汇总

请将以下信息通过飞书私聊发送给Warren：

信息项	示例
App ID	`cli_a5xxxxxxxxxxxxxx`
App Secret	`xxxxxxxxxxxxxxxxxxxxxxxx`
Bot Name（机器人名称）	`OpenClaw`
Verification Token	在事件订阅页面顶部
Encrypt Key	在事件订阅页面顶部

Warren收到后，会将这些信息写入OpenClaw的配置文件中（即 openclaw.json 的飞书渠道配置），完成飞书与OpenClaw的连通。

// openclaw.json 中的飞书配置示例（Warren来配） { "channels": { "feishu": { "accounts": { "default": { "appId": "cli_a5xxxxxxxxxxxxxx", "appSecret": "你的App Secret", "botName": "OpenClaw", "verificationToken": "你的Token", "encryptKey": "你的Key" } } } } }

✅ 阶段三完成标志：你已把 App ID、App Secret、Bot Name、Verification Token、Encrypt Key 五项信息全部发送给Warren，且应用已发布。

✦ ✦ ✦

阶段四：验证与故障排查

Warren完成所有配置后，会通知你进行验证测试。

✅

验证清单

逐项检查是否正常

在飞书中搜索你的机器人名称，能找到并发起对话
发送一条消息（如"你好"），机器人能回复
发送一个具体任务（如"帮我写一段GC活动介绍"），能正常完成
（可选）使用 连接OpenClaw.bat 连接到服务器，浏览器能打开控制台

🔧 常见问题排查

❌ 阿里云ECS创建失败 / 提示余额不足

原因：阿里云账户需要先充值才能创建按量付费实例（最低充100元），或者所选地域资源不足。

解决：

先往阿里云账户充值 ¥100
如果提示库存不足，换一个可用区试试（如北京A → 北京B）
考虑选择"包年包月"模式，提前付费更省心

📸 常见报错：账户余额不足提示
"账户余额不足以支付" → 先充值 → 再创建

❌ 找不到 Ubuntu 22.04 选项

原因：可能在"镜像"选择步骤没切换到正确的分类。

解决：

镜像选择区域，确保选择的是 "公共镜像"（不是"镜像市场"或"共享镜像"）
在操作系统下拉框中选择 "Ubuntu"
版本选择 "22.04 64位"

📸 参考：镜像选择 → 公共镜像 → Ubuntu → 22.04

❌ 飞书开放平台登录后看不到"创建应用"

原因：可能你的飞书账号不属于任何企业/团队，个人账号无法创建企业自建应用。

解决：

确认你是GC俱乐部飞书工作区的成员
如果你还没加入GC飞书工作区，请联系主席或VPPR邀请
登录后在左上角确认选择的是 GC俱乐部 的工作区（不是个人区）

📸 参考：确认左上角显示的是正确的组织名称

❌ 权限申请被拒绝 / 需要管理员审批

原因：部分飞书API权限需要组织管理员审批。

解决：

在权限申请时填写用途说明："GC俱乐部PR团队AI助手，用于辅助活动宣传和信息管理"
联系GC飞书工作区管理员（主席/VPPR）审批
如果你本身就是管理员，在"管理后台"→"应用审核"中通过即可

❌ 飞书机器人搜不到 / 发消息没反应

原因：可能是应用未发布、事件订阅未配置、或OpenClaw服务未启动。

解决：

检查1：确认应用已经"创建版本"并"发布"，且审批已通过
检查2：确认事件订阅的请求地址填写正确（问Warren拿准确地址）
检查3：直接联系Warren，由他检查服务器端OpenClaw日志：
tail -30 /root/openclaw.log

❌ 连接OpenClaw.bat 双击后报错 / 连不上

原因：SSH连接失败，可能是密码错误、服务器未启动、或网络问题。

解决：

检查1：确认服务器在阿里云控制台显示"运行中"状态
检查2：确认密码正确（注意大小写和特殊字符）
检查3：如果提示"Connection refused"，可能是安全组22端口未开放
检查4：公司/学校网络可能屏蔽SSH，换成手机热点试试

✦ ✦ ✦

附录：常用操作速查

📖

本地连接你的OpenClaw

部署完成后的日常使用

Warren部署完成后会给你一个 连接OpenClaw.bat 文件：

1双击 连接OpenClaw.bat
2输入你的服务器密码，回车
3看到 "OpenClaw Gateway Started" 表示连接成功
4打开浏览器访问 http://127.0.0.1:28789 即可使用OpenClaw控制台
5使用期间保持终端窗口打开，关闭窗口即断开连接

💡

常用服务器命令（高级用户）

连接到服务器后在终端中使用

# 查看 OpenClaw 运行状态
openclaw doctor

# 重启 OpenClaw Gateway
pkill -f "openclaw gateway"
nohup openclaw gateway > /root/openclaw.log 2>&1 &

# 查看最近日志（排查问题时用）
tail -30 /root/openclaw.log

# 查看已安装的技能
openclaw skills list

# 检查端口是否正常监听
ss -tlnp | grep 18789

📞

遇到问题？联系方式

问题类型	联系谁
服务器购买/付费问题	阿里云客服（工单或在线客服）
飞书应用创建/权限问题	GC飞书工作区管理员
OpenClaw部署/配置/使用	Warren（飞书私聊）
其他技术问题	Warren（飞书私聊）

OpenClaw 部署操作指南

📋 操作流程总览

阶段一：申请阿里云ECS服务器

Step 1：注册/登录阿里云

Step 2：购买ECS云服务器

📌 必需配置要求

Step 3：开放安全组端口

Step 4：记录并提交服务器信息

💰 费用参考

阶段二：OpenClaw环境部署

Warren的部署清单

阶段三：飞书应用集成

Step 1：创建飞书企业自建应用

Step 2：获取应用凭证

Step 3：启用机器人能力

Step 4：配置权限

Step 5：配置事件订阅（关键步骤）

Step 6：发布应用

📋 需要提交给Warren的飞书信息汇总

阶段四：验证与故障排查

验证清单

🔧 常见问题排查

附录：常用操作速查

本地连接你的OpenClaw

常用服务器命令（高级用户）

遇到问题？联系方式