从零打造专属 AI 助手：阿里云部署 OpenClaw 并接入飞书全攻略

从零打造专属 AI 助手：阿里云部署 OpenClaw 并接入飞书全攻略

OpenClaw（龙虾）作为一款强大的 AI 智能体框架，支持本地部署和多种通讯渠道接入。本文将详细介绍如何从租用云服务器开始，一步步部署 OpenClaw，并最终接入飞书，打造随时待命的 AI 助手。

第一步：阿里云服务器租用与配置

在开始部署之前，我们需要一台性能合适的云服务器。这里以阿里云 ECS 为例。

1. 选购服务器

访问阿里云官网，进入云服务器 ECS 购买页面。

  • 实例规格：建议选择 2核4G 或以上配置（OpenClaw 运行模型和浏览器工具对内存有一定要求）。
  • 镜像选择：选择 Ubuntu 22.04 64位，这个版本稳定且软件包较新。
  • 网络和安全组：勾选分配公网 IP。在安全组配置中，务必放行 18789 端口（OpenClaw 默认网关端口）以及 SSH 默认端口 22。

2. 连接服务器

购买完成后，获取服务器的公网 IP 地址。在本地电脑终端（Windows 使用 PowerShell）执行以下命令连接服务器：

1
ssh root@您的服务器公网IP

输入购买时设置的 root 密码即可登录。

3. 基础环境准备

OpenClaw 依赖 Node.js 环境，且版本必须 ≥ v22.0.0。

1
2
3
4
5
6
7
8
9
10
11
12
13
# 更新系统软件包
sudo apt update && sudo apt upgrade -y

# 安装 Node.js (推荐使用 nvm 管理)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc

# 安装 Node.js 22 版本
nvm install 22
nvm use 22

# 验证版本
node -v

第二步：部署 OpenClaw (直接启动 Gateway)

本教程的核心在于最简洁的启动方式：直接运行 OpenClaw 的网关命令。这种方式适合快速测试和体验，无需额外的进程管理工具。

1. 一键安装

执行官方提供的安装脚本，等待自动完成：

1
curl -fsSL https://openclaw.ai/install.sh | bash

2. 配置向导 (Onboard)

安装完成后，运行初始化向导：

1
openclaw onboard

按照提示操作：

  1. Security Warning: 输入 Yes。
  2. Onboarding mode: 选择 QuickStart。
  3. Model Provider: 选择您需要的模型（如 DeepSeek、通义千问等），并输入 API Key。
    • 注意：必须正确配置模型，否则后续飞书消息将无法得到响应。
  4. Gateway: 保持默认端口 18789。
  5. Hatch: 选择 Hatch in TUI。

3. 启动 OpenClaw

直接在终端运行以下命令启动服务：

1
openclaw gateway

启动成功后，您会看到类似日志：

1
[gateway] listening on ws://0.0.0.0:18789

注意：

  • 采用这种方式，终端窗口必须保持开启。如果关闭窗口或断开 SSH 连接，服务会随之停止。
  • 如果您希望关闭窗口后服务仍继续运行，可以在命令前加 nohup，并在命令末尾加 &，例如：nohup openclaw gateway &。

第三步：接入飞书

本步骤参考了菜鸟教程的 OpenClaw 接入飞书 指导，结合实际配置完成。

1. 飞书开放平台配置

参考文章 https://www.runoob.com/ai-agent/openclaw-feishu.html

登录 飞书开放平台，创建企业自建应用。

  • 配置机器人能力：在左侧菜单“应用功能” -> “机器人”中，启用机器人能力。
  • 获取凭证：在“凭证与基础信息”页面，获取 App ID 和 App Secret。

2. OpenClaw 侧配置

回到服务器，配置 OpenClaw 连接飞书。执行配置命令：

1
openclaw configure

按照提示选择 Feishu 通道：

  • Connection Mode: 建议选择 WebSocket。这种模式无需配置复杂的公网回调地址，避免了因服务器 IP 变动或 HTTPS 证书导致的连接失败，更加稳定。
  • App ID & App Secret: 输入刚才在飞书后台获取的凭证。
  • Domain: 选择 Feishu (feishu.cn) (中国区)。注意输入正确的 App ID 和 App Secret。

3. 飞书后台权限与发布

回到飞书开放平台，完成最后的配置：

  • 权限管理：搜索并开通 im:message（获取与发送消息）、im:message:send_as_bot 等必要权限。
  • 事件订阅：在“事件与回调”中，添加事件 im.message.receive_v1。
  • 版本发布：在“版本管理与发布”-“创建版本”并提交发布。

4. 配对验证

在飞书中搜索您的机器人，发送一条消息。由于是首次连接，机器人会返回一段配对提示：

1
2
3
Pairing code: XXXXXX
Ask the bot owner to approve with:
openclaw pairing approve feishu XXXXXX

回到服务器终端执行该命令：

1
openclaw pairing approve feishu XXXXXX

显示 Pairing approved 后，您的 AI 助手就正式上线了！现在您可以随时在飞书中与它对话，享受 AI 带来的便利。

总结：通过阿里云服务器部署 OpenClaw 并直接运行 openclaw gateway 命令，结合飞书的 WebSocket 连接方式，我们成功搭建了一个 AI 智能体。这种方式简单直接，非常适合快速体验 OpenClaw 的强大功能。如果您希望长期稳定运行，建议后续研究使用 Systemd 或 PM2 进行进程守护。