https://mirrors.aliyun.com/ubuntu-releases/

# 访问阿里云镜像站
https://mirrors.aliyun.com/ubuntu-releases/

# 下载后上传到飞牛 NAS
```plaintext
#### 2. 创建虚拟机

在飞牛 NAS 中创建虚拟机：

**步骤：**
1. 输入虚拟机名称
2. 操作系统选择 Linux
3. 配置性能大小（根据需求设置）
4. 添加储存空间
5. 添加网卡
6. 开机，通过 VNC 访问

### 二、安装 Ubuntu 系统

#### 1. 进入安装界面

开机访问 VNC 后，进入安装页面：

#### 2. 配置用户信息

#### 3. 安装 SSH 服务

#### 4. 重启系统

**重启后，我们就能使用这个 IP 通过 SSH 工具登录终端了。**

### 三、安装 OpenClaw

#### 1. SSH 登录终端

使用 SSH 工具登录，进入 root 权限：
```bash
`sudo -i`
```plaintext
#### 2. 设置环境变量（重要！）

**这里有个坑尽量要注意：**

很多朋友在安装后对接飞书时会报错"应用未建立长连接"，这是因为网关没运行起来，缺少环境变量导致的。

**先运行下面的命令再安装：**
```bash
# 依次运行下面的命令
sudo loginctl enable-linger $(whoami)
export XDG_RUNTIME_DIR=/run/user/$(id -u)
```plaintext
#### 3. 安装 OpenClaw 中文社区版
```bash
# 自动安装 Node.js 和所有依赖（使用国内镜像）
curl -fsSL https://clawd.org.cn/install.sh | bash -s -- --registry https://registry.npmmirror.com
```plaintext
**安装选项：**
- 选择 yes，同意继续
- 选择 快速安装

#### 4. 配置模型

选择 DeepSeek 模型：
- 自己去 DeepSeek 开发平台创建 API Key
- 在终端输入 API Key

#### 5. 配置飞书（免费）

**步骤：**
1. 选择 飞书
2. 选择 本地插件路径
3. 平台选择 国内版，敲回车
4. 去飞书创建应用获取应用凭证（终端别关）

### 四、飞书应用配置

#### 1. 创建飞书应用

访问飞书开放平台：

**配置步骤：**
1. 创建应用
2. 设置应用名称、描述、上传图标
3. 添加机器人（点击添加按钮）

#### 2. 配置权限

在权限管理中，使用 JSON 一键导入所需权限：

**权限配置：**
```json
{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}
```plaintext
**操作：**
- 右边菜单栏 权限管理 → 批量导入/导出权限
- 粘贴代码，确认新增权限
- 发布版本

#### 3. 获取凭证密钥

返回终端，继续配置：
- 依次填入 App ID 和 App Secret
- 按空格键，选择暂时跳过启用钩子
- 保存令牌（后面网页版要用）

### 五、完成配置

#### 1. 修改网关为 LAN

在终端输入（或在飞书里让 AI 修改）：

#### 2. 配置飞书事件与回调

**步骤：**
1. 左边菜单栏 事件与回调
2. 订阅方式 ☑️ 使用 长连接 接收事件
3. 保存
4. 点击右下角添加事件：`im.message.receive_v1`
5. 再发布一个版本（配置才生效）

#### 3. 配对飞书

去飞书和机器人对话，会返回匹配码：
```bash
# 在终端运行
openclaw-cn pairing approve feishu <配对码>
```plaintext
**此时就能和飞书聊天了！**

---

## 💡 使用体验

**我实际用了一段时间，说几点真实感受：**

**优点：**
1. 部署简单，按照教程 30 分钟就能搞定
2. 文档齐全，遇到问题好解决
3. 社区活跃，更新频繁
4. 真正能干活，不只是聊天

**注意点：**
- 第一次配置需要仔细看文档
- 飞书聊天时只显示结果，不展示过程
- Token 消耗较大，不适合高频使用

---

## 🌐 Web 访问配置（可选）

### 1. 关闭设备匹配

因为 NAS 部署，客户端需要访问，最好关闭设备匹配认证：
```bash
# 依次运行下面的两行命令
openclaw-cn config set gateway.controlUi.allowInsecureAuth true
openclaw-cn gateway restart
```plaintext
### 2. 获取网关令牌

如果忘记令牌，能通过下面命令重新获取：
```bash
openclaw-cn dashboard --no-open
# 复制 url 后面的令牌，备份下来