MiniTeamClawUI 接入小龙猫 OpenClaw 教程

0. 准备条件

0.1 环境前提

已拥有一个可正常运行的小龙猫环境下的 OpenClaw 类型助手。

https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.totoro

当前应用已经安装完成，并能正常打开。

https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.miniteamclawui

0.2 前置准备

确认小龙猫已完成基础配置，并且 OpenClaw 助手能够正常运行。
确认 MiniTeamClawUI 已安装完成，并可以正常进入部署向导。
后续需要在小龙猫助手对话区域右上角的 webshell 中查询 Gateway Token，并在需要时执行设备审批命令。

0.3 参考教程

如果尚未完成小龙猫的基础配置，请先参考小龙猫使用攻略。

1. 配置小龙猫里的龙虾访问方式

先在 LightOS WebShell 中发布 OpenClaw Gateway 服务，获取应用域名。后续 MiniTeamClawUI 会用这个域名连接龙虾。

1.1 配置端口转发

在 LightOS WebShell 中发布 OpenClaw Gateway 服务。

1.1.0 打开龙虾的 WebShell

打开 LightOS 应用，找到小龙猫里的 OpenClaw，也就是龙虾应用，然后打开它的 WebShell。

打开 WebShell 后，在右侧终端管理面板中确认当前容器是 OpenClaw，然后点击右上角的 添加。

1.1.1 添加服务发布

在 服务配置 页面中填写：

上游协议：选择 HTTP。
上游地址：填写 127.0.0.1。
端口：必须填写 18789。
标题：可以按自己的习惯填写，例如 我的 OpenClaw。
子域名：可以按自己的习惯填写，例如 myopenclaw。
不使用懒猫账号保护：必须勾选。

端口必须填写 18789，并勾选 不使用懒猫账号保护。

填写完成后，点击 部署服务。

1.1.2 找到刚发布的服务应用

部署完成后，回到懒猫微服应用列表，进入 我的 页面，找到刚才发布的应用。

应用名称就是上一步在 标题 中填写的名称。

打开应用右键菜单，点击 应用详情。

1.1.3 获取 OpenClaw 访问地址

进入应用详情后，找到 应用域名。这个域名后续要填写到 MiniTeamClawUI。

例如应用域名为：

myopenclaw.ailab.heiyu.space

在 MiniTeamClawUI 中填写 OpenClaw 地址 时，需要加上 wss:// 前缀，最终填写为：

wss://myopenclaw.ailab.heiyu.space

获取到这个访问地址后，本步骤完成。

如果使用自建 OpenClaw，请填写实际可访问的 OpenClaw Gateway 地址。

2. 配置 MiniTeamClawUI 连接小龙猫里的龙虾

这一部分的目标是让 MiniTeamClawUI 成功连接到小龙猫中的 OpenClaw，并完成后续登录。

2.1 完成部署向导初始化

首次启动 MiniTeamClawUI 后，会进入部署向导页面。按照页面提示填写后，点击开始部署。

填写时建议注意以下几点：

懒猫用户名 必须填写正确，否则后续网盘文件选择和附件上传可能异常。
应用登录密码 是后续进入 MiniTeamClawUI 时使用的密码，建议提前记录。
OpenClaw 默认 Agent 名称 如果没有特殊定制需求，建议保持默认值。
懒猫网盘选择文件支持 一般建议保持开启，便于后续团队协作时上传文件到 OpenClaw。

完成后，页面会进入连接工作区的引导配置环节。

2.2 填写 OpenClaw 连接信息

这一步会进入 连接你的工作区 页面。按下面方式填写。

2.2.1 OpenClaw 地址

填写 OpenClaw Gateway 的访问地址。地址格式必须以 ws:// 或 wss:// 开头。

如果使用小龙猫，请填写第 1.1.3 步获取到的应用域名，并在前面加上 wss://。示例：

wss://myopenclaw.ailab.heiyu.space

如果你使用的是自建 OpenClaw，请根据实际部署环境填写 OpenClaw Gateway 访问地址。常见情况如下：

局域网访问地址

如果 MiniTeamClawUI 能访问 OpenClaw 所在设备的局域网地址，可以填写局域网地址，例如：
```
ws://192.168.1.100:18789
```
填写的 IP 必须能被 MiniTeamClawUI 所在微服访问。
公网访问地址

如果 OpenClaw Gateway 已经通过公网域名或公网 IP 暴露，并且当前微服可以访问互联网，可以填写公网地址，例如：
```
wss://openclaw.example.com
```
公网地址需要能被 MiniTeamClawUI 所在微服访问。

2.2.2 Gateway 认证方式

Gateway 认证方式 选择：

Token

2.2.3 Gateway Token

Gateway Token 在 OpenClaw 所在环境的终端中查询。如果使用小龙猫，就在小龙猫 WebShell 中执行。

在终端中执行：

grep '"token"' ~/.openclaw/openclaw.json

输出结果通常类似于：

"token": "abc"

只填写引号中的 token 值，例如：

abc

请注意：

不要复制前后的引号。
不要复制 token: 这一段键名。
不要把结尾逗号一起复制进去。

首次连接当前工作区时，Gateway Token 必须填写。已保存过 token 的工作区可以留空。

2.2.4 工作区访问地址

填写团队成员访问这个前端工作区时使用的地址，只填写协议和域名即可。

可以点击 填入当前页面域名 自动填写，也可以手动填写当前 MiniTeamClawUI 应用地址：

https://miniteamclaw.${你的微服名字}.heiyu.space

请将 ${你的微服名字} 替换为当前微服实例的实际名称。

2.3 保存配置并继续

填写完成后，核对：

OpenClaw 地址 与当前小龙猫或自建 OpenClaw Gateway 的实际访问地址一致。
Gateway Token 填写的是纯 token 值。
工作区访问地址 使用的是当前应用可以正常访问的协议和域名。

确认无误后，点击 保存并继续。

2.4 检查连接状态

保存后，点击 检查连接。

如果页面提示需要审批设备访问，复制页面给出的审批命令，到 OpenClaw 所在环境的终端中执行。使用小龙猫时，在小龙猫 WebShell 中执行。

命令格式通常如下：

openclaw devices approve <device-id>

示例：

openclaw devices approve 60d5433d-3f04-4ae9-8ced-7dfc7605c386

执行完成后，回到页面，再次点击 检查连接。

页面提示连接成功，并出现 继续登录 按钮后，连接完成。

2.5 连接失败时的排查方法

如果连接检查没有通过，检查：

确认 OpenClaw 地址 是否填写正确，并且 MiniTeamClawUI 所在微服能够访问该地址。
确认 Gateway Token 是否填写正确，且没有包含多余引号或标点。
确认 OpenClaw 当前处于运行状态。
确认审批命令已经在 OpenClaw 所在环境的终端中成功执行。
确认 工作区访问地址 是当前应用真实可访问的协议和域名，例如 https://xxx.heiyu.space，不要填写路径。

3. 登录并绑定懒猫账号

当页面出现 继续登录 后，点击进入登录流程。

3.1 使用懒猫微服账号登录

在登录页点击 使用懒猫微服登录，然后在授权页面点击 Grant Access。

3.2 绑定本地账号

授权完成后，页面会返回本地账号绑定界面。

请填写：

用户名：当前工作区中的本地账号名
密码：该本地账号对应的密码

填写后点击 绑定账号。

3.3 完成验证

绑定成功后，如果页面进入 MiniTeamClawUI 主界面，就表示整个接入流程已经完成。

建议最后确认以下内容：

可以正常进入 MiniTeamClawUI 主界面。
可以正常发起与 OpenClaw 相关的操作。
当前账号可以正常使用文件选择、附件上传等功能。

4. 常见问题

4.1 服务发布后无法访问 OpenClaw 地址

如果第 1.1.3 步获取到的 OpenClaw 地址无法访问，检查：

服务发布时端口是否填写为 18789。
服务发布时是否勾选了 不使用懒猫账号保护。
当前发布的服务是否属于小龙猫里的 OpenClaw，也就是龙虾容器。
小龙猫里的 OpenClaw 是否处于正常运行状态。

4.2 连接检查无法通过

检查：

OpenClaw 地址 是否正确，并且已经加上 wss:// 前缀。
OpenClaw 地址 是否来自第 1.1.3 步获取到的应用域名。
Gateway Token 是否正确。
OpenClaw 是否处于运行状态。
设备审批命令是否已在小龙猫 WebShell 中执行。
工作区访问地址 是否是当前 MiniTeamClawUI 应用真实可访问的协议和域名，例如 https://xxx.heiyu.space，不要填写路径。