OpenClaw + OpenList：在懒猫微服上用 AI 管理文件

> 通过 OpenList REST API 让 OpenClaw 实现对话式文件管理——浏览目录、搜索文件、移动/复制/重命名/创建目录。

本文介绍如何通过 OpenList 的 REST API 让 OpenClaw 成为你的文件管理助手，实现类似这样的对话：

```
你：帮我看看网盘里 documents 目录下有什么
你：把 report-v2.docx 移到 archive 文件夹
你：搜一下上周的会议记录
你：建一个新目录叫 2026-Q1
```


https://appstore.lazycat.cloud/#/shop/detail/iamxiaoe.lzcapp.openclaw


## 前置条件

- 懒猫微服已安装 OpenList、端口转发工具
- OpenClaw 已部署可用
- OpenList 管理员权限

---

## 1. 端口转发
通过端口转发工具把 openlist 的 5244 端口转发到其他容器可以访问。如图

![image.png](https://dl.playground.lazycat.cloud/guidelines/976/0c5bef21-aa12-4a4a-a44a-d70f93ef05e6.png "image.png")
之后去 openclaw 命令行确认 OpenClaw 能连到 OpenList：

```bash
curl http://host.lzcapp:5244/api/public/settings
```

返回 `"code":200` 以及 success即成功。


![image.png](https://dl.playground.lazycat.cloud/guidelines/976/96dc8c61-a288-491f-9cd7-89c5c4288288.png "image.png")

## 2. 创建受限用户

> **安全原则：不要让 OpenClaw 使用管理员账户。**

在 OpenList 后台 → 用户 → 添加，创建专用用户：

| 字段 | 值 | 说明 |
|------|------|------|
| 用户名 | `openclaw` | - |
| 密码 | 自行设置 | 我这里直接设置成 123456|
| 基本路径 | `/懒猫网盘/.....` | 限制可访问范围，按你的实际目录调整 |



**权限配置：**

文件管理场景需要开启读写相关权限，但建议**不开删除**，防止误操作：

| 权限 | 开启？ | 说明 |
|------|--------|------|
| 无需密码访问 | ❌ | 保持认证 |
| 创建目录或上传 | ✅ | 建目录需要 |
| 重命名 | ✅ | 重命名文件/目录 |
| 移动 | ✅ | 移动文件 |
| 复制 | ✅ | 复制文件 |
| 删除 | ❌ | 危险操作，建议不开 |
| WebDAV 读取 | ✅ | 可选，备用 |

> **为什么用 REST API 而不是 WebDAV？** REST API 支持搜索、分页、文件元信息查询，更适合 AI 对话式交互。WebDAV 更适合 rclone 挂载这类场景。

## 3. 配置

在写 Skill 之前，先手动跑通每个接口。

```bash
curl -X POST http://host.lzcapp:5244/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"openclaw","password":"你的密码"}'
```

成功 会返回：

```json
{"code":200,"message":"success","data":{"token":"eyJhbG..."}}
```

之后我们就可以直接让龙虾帮我们完成全部。
但是我搜索之后，暂时没有发现有 openlist api 相关的 skills，但是我搜到了官方文档的给 llm 看的文档。我们可以复制了直接给大模型。

![image.png](https://dl.playground.lazycat.cloud/guidelines/976/719d6839-b41f-433a-be32-01d37ad948ef.png "image.png")
网址在：https://fox.oplist.org.cn/llms.txt
我们之后直接把这个网址给龙虾。

---
现在我们可以直接让龙虾来创造 skills 了，我们先确认龙虾是否有 skill-creator

![image.png](https://dl.playground.lazycat.cloud/guidelines/976/5924250d-4cec-48ff-9ff9-3a331f7b2f3e.png "image.png")
然后告诉龙虾，我们要做 openlist 的文件管理，端口在http://host.lzcapp:5244, 文档在https://fox.oplist.org.cn/llms.txt, 你去抓取一下，创建一个 openlist 文件管理 skill。

![image.png](https://dl.playground.lazycat.cloud/guidelines/976/95af4b75-7e8f-4dee-9b43-5413d2c1bdcd.png "image.png")
写完了，我们再把用户名和密码告诉他，然后测试一下，让他随便读一下。

![image.png](https://dl.playground.lazycat.cloud/guidelines/976/52a486f5-c220-495f-ac5a-1a5565e5edae.png "image.png")

读取成功，我们实现可 openclaw 对 openlist 中文件的读写控制，从而可以完成文件搜索、整理等工作