个人用户龙虾接入指南：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。 ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/f5cf03b2-9c3a-4d31-a2cc-1856a0cd072f.png "image.png") 打开 WebShell 后，在右侧终端管理面板中确认当前容器是 OpenClaw，然后点击右上角的 `添加`。 ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/763cb04c-64cd-467b-8404-4086e90d3be1.png "image.png") #### 1.1.1 添加服务发布在 `服务配置` 页面中填写： - `上游协议`：选择 `HTTP`。 - `上游地址`：填写 `127.0.0.1`。 - `端口`：必须填写 `18789`。 - `标题`：可以按自己的习惯填写，例如 `我的 OpenClaw`。 - `子域名`：可以按自己的习惯填写，例如 `myopenclaw`。 - `不使用懒猫账号保护`：必须勾选。端口必须填写 `18789`，并勾选 `不使用懒猫账号保护`。填写完成后，点击 `部署服务`。 ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/4a1b38dc-3b59-4278-94ec-dd3edbd39c09.png "image.png") #### 1.1.2 找到刚发布的服务应用部署完成后，回到懒猫微服应用列表，进入 `我的` 页面，找到刚才发布的应用。应用名称就是上一步在 `标题` 中填写的名称。打开应用右键菜单，点击 `应用详情`。 ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/75387d6c-172d-4663-b6f6-924a0a1bfc3d.png "image.png") #### 1.1.3 获取 OpenClaw 访问地址进入应用详情后，找到 `应用域名`。这个域名后续要填写到 MiniTeamClawUI。例如应用域名为： ```text myopenclaw.ailab.heiyu.space ``` 在 MiniTeamClawUI 中填写 `OpenClaw 地址` 时，需要加上 `wss://` 前缀，最终填写为： ```text wss://myopenclaw.ailab.heiyu.space ``` 获取到这个访问地址后，本步骤完成。 ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/b19518ed-2f19-4652-ab2c-70a1e39697a4.png "image.png") 如果使用自建 OpenClaw，请填写实际可访问的 OpenClaw Gateway 地址。 ## 2. 配置 MiniTeamClawUI 连接小龙猫里的龙虾这一部分的目标是让 MiniTeamClawUI 成功连接到小龙猫中的 OpenClaw，并完成后续登录。 ### 2.1 完成部署向导初始化首次启动 MiniTeamClawUI 后，会进入部署向导页面。按照页面提示填写后，点击开始部署。填写时建议注意以下几点： - `懒猫用户名` 必须填写正确，否则后续网盘文件选择和附件上传可能异常。 - `应用登录密码` 是后续进入 MiniTeamClawUI 时使用的密码，建议提前记录。 - `OpenClaw 默认 Agent 名称` 如果没有特殊定制需求，建议保持默认值。 - `懒猫网盘选择文件支持` 一般建议保持开启，便于后续团队协作时上传文件到 OpenClaw。完成后，页面会进入连接工作区的引导配置环节。 ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/26962a8a-4f20-4fc0-bc72-71eb7d4e72fb.png "image.png") ### 2.2 填写 OpenClaw 连接信息 ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/711f2250-33e1-4d0d-8bad-5207499721aa.png "image.png") 这一步会进入 `连接你的工作区` 页面。按下面方式填写。 #### 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 值。 - `工作区访问地址` 使用的是当前应用可以正常访问的协议和域名。确认无误后，点击 `保存并继续`。 ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/da529df3-5068-4124-a1ba-f6928c092ba7.png "image.png") ### 2.4 检查连接状态 ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/36cb3eb5-34b1-411a-899a-6812bd4975b7.png "image.png") 保存后，点击 `检查连接`。如果页面提示需要审批设备访问，复制页面给出的审批命令，到 OpenClaw 所在环境的终端中执行。使用小龙猫时，在小龙猫 WebShell 中执行。 ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/fdabd177-a38a-4fed-856b-06cd955de726.png "image.png") ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/a79751c9-a353-4006-b4c4-ddf04bddefa1.png "image.png") 命令格式通常如下： ```bash openclaw devices approve ``` 示例： ```bash openclaw devices approve 60d5433d-3f04-4ae9-8ced-7dfc7605c386 ``` ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/43c9ff22-e639-4719-9d17-da18ee813557.png "image.png") 执行完成后，回到页面，再次点击 `检查连接`。 ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/3e5ae4aa-a05a-4f3e-a346-0afbb1a42f1c.png "image.png") 页面提示连接成功，并出现 `继续登录` 按钮后，连接完成。 ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/954ca900-e39b-4cc5-a78e-de600ea1c198.png "image.png") ### 2.5 连接失败时的排查方法如果连接检查没有通过，检查： 1. 确认 `OpenClaw 地址` 是否填写正确，并且 MiniTeamClawUI 所在微服能够访问该地址。 2. 确认 `Gateway Token` 是否填写正确，且没有包含多余引号或标点。 3. 确认 OpenClaw 当前处于运行状态。 4. 确认审批命令已经在 OpenClaw 所在环境的终端中成功执行。 5. 确认 `工作区访问地址` 是当前应用真实可访问的协议和域名，例如 `https://xxx.heiyu.space`，不要填写路径。 ## 3. 登录并绑定懒猫账号当页面出现 `继续登录` 后，点击进入登录流程。 ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/1bbf3e1f-14eb-4964-8b09-89db3f3d513d.png "image.png") ### 3.1 使用懒猫微服账号登录在登录页点击 `使用懒猫微服登录`，然后在授权页面点击 `Grant Access`。 ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/7031df21-9a18-4329-bc0b-4fd8977e5229.png "image.png") ### 3.2 绑定本地账号授权完成后，页面会返回本地账号绑定界面。请填写： 1. `用户名`：当前工作区中的本地账号名 2. `密码`：该本地账号对应的密码填写后点击 `绑定账号`。 ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/6d2bedf5-a1ec-4cf1-8a66-2cb054c4feaa.png "image.png") ### 3.3 完成验证绑定成功后，如果页面进入 MiniTeamClawUI 主界面，就表示整个接入流程已经完成。建议最后确认以下内容： - 可以正常进入 MiniTeamClawUI 主界面。 - 可以正常发起与 OpenClaw 相关的操作。 - 当前账号可以正常使用文件选择、附件上传等功能。 ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/f5bc2ac3-996d-4207-bad1-235c0dd7a778.png "image.png") ## 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 移动端截图 ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/3b1822e8-cba2-4168-a35e-924d83a3873e.png "image.png") ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/5553ff3e-96b0-47b2-84e3-c2eb499015ac.png "image.png") ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/aa8f43be-6e1b-47c2-9f3c-8e2c8d4123ea.png "image.png") ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/756d53f6-3520-4f3b-a263-063cab17f488.png "image.png") ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/eaeb6711-e267-44a1-8b36-59ff906ac290.png "image.png") ### 5.2 PC 截图 ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/b3d47110-41de-4ddb-afdc-dcdf362ac274.png "image.png") ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/bc07351b-e0be-4450-b533-308f7da2e129.png "image.png") ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/dd6c93f0-70c9-493b-b17c-ad5a10fbca04.png "image.png") ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/5de338fa-4848-456b-a8b9-59f0d3c0508e.png "image.png") ![image.png](https://dl.playground.lazycat.cloud/guidelines/779/414c4878-dd14-4d9c-9a82-25dd7f2b8750.png "image.png")