@huo15/clawbutler-oauth

龙虾管家企业版鉴权插件 — 手机号注册/登录 + JWT + per-user 会话隔离 + 管理后台

安装

npm install @huo15/clawbutler-oauth

在 OpenClaw 网关配置中启用：

plugins:
  load:
    paths:
      - node_modules/@huo15/clawbutler-oauth/dist/index.js
  entries:
    clawbutler-oauth:
      enabled: true
      config: {}

环境变量

| 变量 | 必填 | 说明 | |---|---|---| | HUIHUO_JWT_SECRET | 是 | JWT 签名密钥（固定值，避免重启后 token 失效） | | HUIHUO_JWT_TTL | 否 | JWT 有效期秒数（默认 604800 = 7 天） | | HUIHUO_SMS_AK_ID | 否 | 阿里云 AccessKey ID（不填则 dev 模式） | | HUIHUO_SMS_AK_SECRET | 否 | 阿里云 AccessKey Secret | | HUIHUO_SMS_SIGN_NAME | 否 | 短信签名（默认：逸寻智库） | | HUIHUO_SMS_TEMPLATE_CODE | 否 | 短信模板 CODE（不填则 dev 模式，验证码写日志） | | HUIHUO_SMS_DEV | 否 | "1" = 强制 dev 模式 | | HUIHUO_ADMIN_PHONE | 否 | 管理员手机号 |

API 端点

| 路径 | 方法 | 说明 | |---|---|---| | /plugins/huihuo/auth/send-code | POST | 发送验证码 | | /plugins/huihuo/auth/register | POST | 注册 | | /plugins/huihuo/auth/login | POST | 登录 | | /plugins/huihuo/auth/me | GET | 当前用户信息 | | /plugins/huihuo/auth/gateway-token | GET | JWT 换网关 token | | /plugins/huihuo/auth/verify | GET | nginx auth_request 校验 | | /plugins/huihuo/auth/my-agents | GET | 获取当前用户可用的智能体 ID 列表 | | /plugins/huihuo/admin | GET | 管理后台页面 | | /plugins/huihuo/admin/users | GET | 用户列表 JSON | | /plugins/huihuo/admin/agents | GET | 网关所有智能体 ID（管理员） | | /plugins/huihuo/admin/bindings | GET | 所有用户-智能体绑定（管理员） | | /plugins/huihuo/admin/bindings | POST | 设置用户-智能体绑定（管理员） |

架构

src/
  index.ts          插件入口 (definePluginEntry)
  config.ts         环境变量配置
  runtime.ts        OpenClaw runtime 注入
  auth/
    jwt.ts          JWT 签发/验证
    password.ts     bcrypt 密码哈希
    sms.ts          阿里云短信
    routes.ts       鉴权 HTTP 路由
  admin/
    store.ts        用户存储 (JSON 文件)
    routes.ts       管理后台路由
  guard/
    agent.ts        用户隔离 agent 创建
    rpc-guard.ts    RPC 会话隔离

构建

npm run build

发布

npm publish --access public

License

MIT — 青岛火一五信息科技有限公司