open-index/open-npm huggingface dataset:
npm package: @lumachat/lumachat
Description: LumaChat channel plugin for OpenClaw
Latest version: 0.15.5

# LumaChat OpenClaw 通道插件

用于把 OpenClaw 接入 LumaChat App。  
从 `0.15.5` 开始，登录方式升级为 **OAuth 2.0 Device Flow（仅扫码）**，不再使用“配对码 + 安全码”双码流程。

## 快速开始（站在 OpenClaw 用户视角）

### 1) 安装或升级插件

在 OpenClaw 项目目录执行：

```bash
pnpm openclaw plugins install @lumachat/lumachat@0.15.5
# 已安装过则可直接升级
pnpm openclaw plugins update lumachat
openclaw gateway restart
```

建议确认当前插件版本：

```bash
pnpm openclaw plugins list
```

### 2) 发起登录授权

```bash
pnpm openclaw channels login --channel lumachat
```

预期输出：
- 终端二维码（ASCII）
- 仅显示扫码二维码

### 3) 在 App 内完成授权

打开 LumaChat App：`设置 -> Clawdbot 配对`
- 直接扫码授权

授权完成后，插件会自动保存 `channelToken` 并连接网关。

## 常用命令

```bash
# 重新登录（换绑/重绑）
pnpm openclaw channels logout --channel lumachat
pnpm openclaw channels login --channel lumachat

# 查看插件版本
pnpm openclaw plugins list
```

## 常见问题

- 仍看到“配对码 + 安全码”：当前还在用旧版本，请升级到 `@lumachat/lumachat@0.15.5` 后重启网关。
- 提示 `授权已过期`：重新执行 `pnpm openclaw channels login --channel lumachat`。
- 提示 `OAuth client_id 无效`：插件和后端版本不匹配，请同时升级。
- 一直等待授权：确认 App 已登录账号，并停留在配对页面完成授权。

## 可选环境变量

- `LUMACHAT_API_BASE_URL`：后端地址（默认 `https://api-love2.huaizuo2029.cn`）
- `LUMACHAT_CHANNEL_KEY` / `LUMACHAT_SHARED_KEY`：后端要求 `X-Clawdchat-Channel-Key` 时使用
- `CLAWDCHAT_API_BASE_URL`：同上（兼容旧变量）
- `CLAWDCHAT_CHANNEL_KEY` / `CLAWDCHAT_SHARED_KEY`：同上（兼容旧变量）

## 技术备注

- OAuth 设备授权接口：
  - `POST /oauth/device/code`
  - `POST /oauth/token`
- WebSocket 地址：`/ws/channel/clawdchat`