佛系程序员_ Ubuntu 部署 OpenClaw + 飞书机器人全流程实战博文

学习笔记

发布日期: 2026-04-08 19:34:05

喜欢量: 9 个

阅读次数: 49

# Ubuntu 部署 OpenClaw + 飞书机器人全流程实战博文 ## 前言...

# Ubuntu 部署 OpenClaw + 飞书机器人全流程实战博文
## 前言
本文基于真实部署场景，完整复现从**飞书机器人创建**到 **Ubuntu（WSL）环境运行 OpenClaw**、解决端口冲突、实现 Web 面板远程访问的全过程，包含大量实战避坑点，新手可直接复制命令落地。

---

## 一、前置说明
- 系统：Ubuntu 22.04（WSL2 / 云服务器通用）
- 工具：OpenClaw 2026.4.5
- 目标：搭建飞书 AI 机器人，提供独立 Web 管理面板，与 Windows 本地 OpenClaw 端口隔离
- 核心问题：WSL 默认仅监听 127.0.0.1、端口冲突、Web 面板无法外部访问

---

## 二、第一步：飞书开放平台创建机器人
### 1. 进入飞书开放平台
打开：https://open.feishu.cn/，使用企业飞书账号登录。

### 2. 创建企业自建应用
- 点击「创建应用」→ 选择「企业自建应用」
- 填写名称：OpenClaw-AI
- 填写描述：AI 智能助手
- 点击「创建」

### 3. 添加机器人能力
- 进入应用 → 「添加应用能力」
- 选择「机器人」→ 点击「添加」

### 4. 配置权限与事件
- 权限管理：开启 `im:message`、`im:message.p2p_msg`
- 事件订阅：订阅「接收消息」事件
- 无需填写请求 URL，OpenClaw 会通过 WebSocket 长连接接入

### 5. 获取凭证并发布
- 进入「凭证与基础信息」，复制 **App ID、App Secret**
- 创建版本并发布，完成企业内审核

---

## 三、第二步：Ubuntu 环境准备与 OpenClaw 安装
### 1. 更新系统依赖
```bash
sudo apt update && sudo apt upgrade -y
sudo apt install curl git socat -y
```

### 2. 安装 OpenClaw
```bash
# 执行官方一键安装
curl -fsSL https://raw.githubusercontent.com/m1heng/clawd/main/install.sh | bash
```

### 3. 验证安装
```bash
openclaw --version
```
出现版本号即安装成功。

---

## 四、第三步：配置飞书渠道
### 1. 添加飞书通道
```bash
openclaw channels add
```
按交互指引：
- 选择飞书
- 输入 App ID
- 输入 App Secret
- 地区选择 china
- 启用 @机器人 回复模式

### 2. 查看配置信息
```bash
openclaw config list
```
确认飞书渠道已加载。

---

## 五、第四步：启动 OpenClaw 网关（核心步骤）
### 1. 关闭残留进程
```bash
pkill -f openclaw
```

### 2. 启动网关服务
```bash
openclaw gateway
```
成功日志关键标识：
```
[gateway] ready
[feishu] WebSocket client started
[ws] ws client ready
[browser] control listening on http://127.0.0.1:18791/
```

### 3. 获取 Web 面板链接
```bash
openclaw dashboard --no-open
```
输出示例：
```
Dashboard URL: http://127.0.0.1:18789/#token=xxx
```

---

## 六、第五步：解决 WSL 外部无法访问 + 端口冲突
### 问题说明
- Windows 本地 OpenClaw 占用 18789
- WSL 内服务默认仅监听 127.0.0.1

### 解决方案：Windows 端口转发
以**管理员身份**打开 PowerShell，执行：
```powershell
netsh interface portproxy add v4tov4 listenport=18790 listenaddress=0.0.0.0 connectport=18789 connectaddress=172.25.193.210
```

### 访问规则
- Windows 本地 OpenClaw：`http://127.0.0.1:18789`
- Ubuntu(WSL) OpenClaw：`http://127.0.0.1:18790/#token=你的token`

---

## 七、第六步：验证与使用
### 1. 本地连通性测试
```bash
curl 127.0.0.1:18789
```
返回 HTML 即为正常。

### 2. Web 面板访问
打开浏览器访问：
```
http://127.0.0.1:18790/#token=21047bd20840d91e9dc61d8176e8d2cd851113404a0cad0c
```

### 3. 飞书机器人测试
在飞书单聊/群组中 @机器人，发送测试消息，机器人正常回复即部署完成。

---

## 八、常见问题排坑
### 1. curl: (7) Failed to connect
- 原因：gateway 未真正启动
- 解决：`pkill -f openclaw && openclaw gateway`

### 2. 未知命令 --host / --port
- 原因：OpenClaw 版本不支持启动参数
- 解决：直接使用 `openclaw gateway`，配合 Windows 端口转发

### 3. Web 面板无法打开
- 原因：WSL 虚拟 IP 无法直接访问
- 解决：必须使用 netsh 端口转发

### 4. 飞书机器人不回复
- 原因：WebSocket 未连接、权限未发布
- 解决：检查网关日志，重新发布飞书应用

---

## 九、总结
本文完成了一套**生产可用**的 OpenClaw + 飞书机器人部署方案：
1. 飞书机器人创建与权限配置标准化
2. Ubuntu 环境一键部署 OpenClaw
3. 解决 WSL 网络隔离与端口冲突
4. 双环境隔离运行，Web 面板独立访问
5. 飞书长连接稳定在线，支持群内 @交互

整套流程无需公网 IP、无需域名，适合本地/内网快速搭建 AI 协作助手。

---

要不要我把这篇博文整理成**可直接发布的 Markdown 文件**，附带目录、代码高亮与排版优化？

明白了，你现在在 WSL2 启动 OpenClaw，浏览器访问 `http://127.0.0.1:18789/` 仍然不可用，这完全符合 WSL2 的常见网络问题。我们来理清楚原理和解决办法。

---

### **问题原因**

1. **WSL2 的 localhost 并不总是映射到 Windows localhost**

* WSL2 是一个轻量虚拟机，它有自己的虚拟网络。
   * 在某些情况下，WSL2 内部的 `127.0.0.1` **只能在 WSL2 内部访问**，Windows 浏览器访问 `127.0.0.1` 可能不通。

2. **OpenClaw 默认只监听 127.0.0.1**

* 这意味着它不会对外网（包括 Windows 主机）开放端口。

3. **你没有 systemd / OpenClaw Gateway 服务**

* 之前的命令无法启动 systemd 服务，Dashboard 只是临时启动，也没有绑定到 WSL2 的虚拟 IP 或 0.0.0.0。

---

### **解决方案**

#### **方案 1：使用 WSL2 IP 访问**

1. 在 WSL2 内查询 IP：

```bash
hostname -I
```

输出类似：

```
172.25.193.96
```

2. 启动 OpenClaw Dashboard：

```bash
openclaw dashboard
```

3. Windows 浏览器访问：

```
http://172.25.193.96:18789/#token=你的token
```

> 如果访问失败，可能是 Windows 防火墙阻止端口访问，需要放行 TCP 18789。

---

#### **方案 2：用端口转发（推荐，稳定）**

在 WSL2 内运行：

```bash
# 这里把 WSL2 内部 18789 映射到 Windows localhost:18789
powershell.exe -Command "netsh interface portproxy add v4tov4 listenport=18789 listenaddress=127.0.0.1 connectport=18789 connectaddress=172.25.193.96"
```

然后 Windows 浏览器访问：

```
http://127.0.0.1:18789/#token=你的token
```

* 这比直接访问 WSL2 IP 更稳定。

---

#### **方案 3：在 WSL2 内直接打开 Windows 浏览器**

```bash
explorer.exe "http://127.0.0.1:18789/#token=你的token"
```

* 这条命令只在 WSL2 内部 Dashboard 监听 `127.0.0.1` 的情况下有效。
* 有些版本 WSL2 + OpenClaw 不自动映射，可能还是打不开。

---

### **结论**

你遇到的问题不是 OpenClaw 本身，而是 **WSL2 的网络隔离**。要让 Windows 浏览器访问 Dashboard，有两种靠谱方法：

1. **用 WSL2 的 IP 直接访问（最简单）**
2. **用端口转发把 WSL2 的 127.0.0.1 映射到 Windows localhost（最稳定）**

---

我可以帮你写一个 **完整一条命令脚本**，在 WSL2 启动 OpenClaw Dashboard 并自动让 Windows 浏览器能访问，无需手动输入 IP 或 token。

你希望我写吗？

yyii

https://amtb.info/show/MzQ1

本博客所有文章除特別声明外,转载请注明来源佛系程序员 !