个人用户龙虾接入指南：MiniTeamClawUI 配置与登录流程

# 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 参考教程 如果尚未完成小龙猫的基础配置，请先参考[小龙猫使用攻略](https://playground.lazycat.cloud/#/guideline/1558)。 ## 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。 例如应用域名为： ```text myopenclaw.ailab.heiyu.space ``` 在 MiniTeamClawUI 中填写 `OpenClaw 地址` 时，需要加上 `wss://` 前缀，最终填写为： ```text 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://`。示例： ```text wss://myopenclaw.ailab.heiyu.space ``` 如果你使用的是自建 OpenClaw，请根据实际部署环境填写 OpenClaw Gateway 访问地址。常见情况如下： 1. 局域网访问地址 如果 MiniTeamClawUI 能访问 OpenClaw 所在设备的局域网地址，可以填写局域网地址，例如： ```text ws://192.168.1.100:18789 ``` 填写的 IP 必须能被 MiniTeamClawUI 所在微服访问。 2. 公网访问地址 如果 OpenClaw Gateway 已经通过公网域名或公网 IP 暴露，并且当前微服可以访问互联网，可以填写公网地址，例如： ```text wss://openclaw.example.com ``` 公网地址需要能被 MiniTeamClawUI 所在微服访问。 #### 2.2.2 Gateway 认证方式 `Gateway 认证方式` 选择： ```text Token ``` #### 2.2.3 Gateway Token `Gateway Token` 在 OpenClaw 所在环境的终端中查询。如果使用小龙猫，就在小龙猫 WebShell 中执行。 在终端中执行： ```bash grep '"token"' ~/.openclaw/openclaw.json ``` 输出结果通常类似于： ```text "token": "abc" ``` 只填写引号中的 token 值，例如： ```text abc ``` 请注意： - 不要复制前后的引号。 - 不要复制 `token:` 这一段键名。 - 不要把结尾逗号一起复制进去。 首次连接当前工作区时，`Gateway Token` 必须填写。已保存过 token 的工作区可以留空。 #### 2.2.4 工作区访问地址 填写团队成员访问这个前端工作区时使用的地址，只填写协议和域名即可。 可以点击 `填入当前页面域名` 自动填写，也可以手动填写当前 MiniTeamClawUI 应用地址： ```text https://miniteamclaw.${你的微服名字}.heiyu.space ``` 请将 `${你的微服名字}` 替换为当前微服实例的实际名称。 ### 2.3 保存配置并继续 填写完成后，核对： - `OpenClaw 地址` 与当前小龙猫或自建 OpenClaw Gateway 的实际访问地址一致。 - `Gateway Token` 填写的是纯 token 值。 - `工作区访问地址` 使用的是当前应用可以正常访问的协议和域名。 确认无误后，点击 `保存并继续`。  ### 2.4 检查连接状态  保存后，点击 `检查连接`。 如果页面提示需要审批设备访问，复制页面给出的审批命令，到 OpenClaw 所在环境的终端中执行。使用小龙猫时，在小龙猫 WebShell 中执行。   命令格式通常如下： ```bash openclaw devices approve <device-id> ``` 示例： ```bash openclaw devices approve 60d5433d-3f04-4ae9-8ced-7dfc7605c386 ```  执行完成后，回到页面，再次点击 `检查连接`。  页面提示连接成功，并出现 `继续登录` 按钮后，连接完成。  ### 2.5 连接失败时的排查方法 如果连接检查没有通过，检查： 1. 确认 `OpenClaw 地址` 是否填写正确，并且 MiniTeamClawUI 所在微服能够访问该地址。 2. 确认 `Gateway Token` 是否填写正确，且没有包含多余引号或标点。 3. 确认 OpenClaw 当前处于运行状态。 4. 确认审批命令已经在 OpenClaw 所在环境的终端中成功执行。 5. 确认 `工作区访问地址` 是当前应用真实可访问的协议和域名，例如 `https://xxx.heiyu.space`，不要填写路径。 ## 3. 登录并绑定懒猫账号 当页面出现 `继续登录` 后，点击进入登录流程。  ### 3.1 使用懒猫微服账号登录 在登录页点击 `使用懒猫微服登录`，然后在授权页面点击 `Grant Access`。  ### 3.2 绑定本地账号 授权完成后，页面会返回本地账号绑定界面。 请填写： 1. `用户名`：当前工作区中的本地账号名 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`，不要填写路径。 ### 4.3 LightOS 环境中无法访问 MiniTeamClawUI 或 OpenClaw 如果需要在 LightOS 中访问当前 MiniTeamClawUI 应用，请将 LightOS 网络模式改为 `host`。 `macvlan` 和 `ipvlan` 可能导致页面无法访问或连接检查失败。 ### 4.4 登录后无法正常使用附件或网盘功能 检查部署向导中的 `懒猫用户名` 是否填写正确。 ## 5. 界面截图 ### 5.1 移动端截图      ### 5.2 PC 截图