@lumachat/lumachat
v0.15.5
Published
LumaChat channel plugin for OpenClaw
Readme
LumaChat OpenClaw 通道插件
用于把 OpenClaw 接入 LumaChat App。
从 0.15.5 开始,登录方式升级为 OAuth 2.0 Device Flow(仅扫码),不再使用“配对码 + 安全码”双码流程。
快速开始(站在 OpenClaw 用户视角)
1) 安装或升级插件
在 OpenClaw 项目目录执行:
pnpm openclaw plugins install @lumachat/[email protected]
# 已安装过则可直接升级
pnpm openclaw plugins update lumachat
openclaw gateway restart建议确认当前插件版本:
pnpm openclaw plugins list2) 发起登录授权
pnpm openclaw channels login --channel lumachat预期输出:
- 终端二维码(ASCII)
- 仅显示扫码二维码
3) 在 App 内完成授权
打开 LumaChat App:设置 -> Clawdbot 配对
- 直接扫码授权
授权完成后,插件会自动保存 channelToken 并连接网关。
常用命令
# 重新登录(换绑/重绑)
pnpm openclaw channels logout --channel lumachat
pnpm openclaw channels login --channel lumachat
# 查看插件版本
pnpm openclaw plugins list常见问题
- 仍看到“配对码 + 安全码”:当前还在用旧版本,请升级到
@lumachat/[email protected]后重启网关。 - 提示
授权已过期:重新执行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/codePOST /oauth/token
- WebSocket 地址:
/ws/channel/clawdchat
