@const_j/chatbi-plugin
v1.0.1
Published
将 LuciBI ChatBI 作为 OpenClaw 插件发布,提供:
Downloads
29
Readme
LuciBI ChatBI OpenClaw Plugin
将 LuciBI ChatBI 作为 OpenClaw 插件发布,提供:
- 一个纯 JS 的
chatbi_querytool - 一个插件内置的
lucibi_chatbi_assistantskill - 基于
requesterSenderId的发送者绑定和会话续聊
不再依赖 config.yaml、handler.py、requests 或 pyyaml。
安装
在安装了 OpenClaw 的机器上,直接从本地路径安装插件:
openclaw plugins install /absolute/path/to/openclaw_chatbi_plugin然后在 ~/.openclaw/openclaw.json 中启用并配置插件:
{
plugins: {
entries: {
"lucibi-chatbi": {
enabled: true,
config: {
baseUrl: "http://127.0.0.1:9000",
timeoutMs: 120000,
conversationIdleTimeoutMs: 1800000,
},
},
},
},
}配置说明:
baseUrl: LuciBI 实例地址timeoutMs: ChatBI HTTP 请求超时conversationIdleTimeoutMs: ChatBI 会话空闲多久后自动开启新会话,默认 30 分钟
修改配置后重启 Gateway:
openclaw gateway restart发布到 npm
仓库根目录提供了一键发布脚本:
OPENCLAW_CHATBI_NPM_TOKEN=<your-token>
./scripts/publish_openclaw_chatbi_plugin.sh可选环境变量:
OPENCLAW_CHATBI_NPM_REGISTRY: 默认https://registry.npmjs.org/OPENCLAW_CHATBI_NPM_TAG: npm dist-tag,默认latestOPENCLAW_CHATBI_NPM_OTP: npm 账号开启发布 2FA 时使用的 6 位验证码
发布成功后,其他用户只需要让本机 npm 指向同一个 registry,然后直接安装:
openclaw plugins install @const_j/chatbi-plugin@<version>使用
插件会提供 chatbi_query tool,并通过内置 lucibi_chatbi_assistant skill 指导模型调用它。
常见用法:
/chatbi:auth cbak_user_xxxxxxxxxx
/chatbi_auth cbak_user_xxxxxxxxxx
/chatbi auth cbak_user_xxxxxxxxxx
/chatbi 最近 30 天销售趋势
/chatbi:new 重新按新问题看一下本月销售额
/chatbi new 重新按新问题看一下本月销售额
/chat_new 重新按新问题看一下本月销售额
/chatbi:reset
/chatbi_reset
/chatbi:unauth
/chatbi_unauth
/chatbi unauth也可以直接自然语言触发:
本月销售额是多少?
最近 30 天销售趋势是怎样的?
帮我解绑 ChatBI绑定说明:
/chatbi:auth <auth_key>、/chatbi:new <问题>、/chatbi:reset和/chatbi:unauth是插件直接处理的快捷命令,不依赖 skill 命令名匹配/chatbi <问题>现在也优先走插件原生命令,这样 Telegram slash 查询会显示 typing indicator- Telegram 原生命令菜单只支持字母、数字和下划线,所以菜单里会显示
/chatbi_auth、/chat_new、/chatbi_reset和/chatbi_unauth,不会显示带冒号的别名 - 内置 skill 故意不再命名为
chatbi,避免和 Telegram 的/chatbi插件命令冲突 /chatbi auth <auth_key>绑定的是当前 OpenClaw 发送者对应的 LuciBI 用户授权- 绑定成功后会像企业微信接入一样长期保持,不再依赖插件侧 access token / refresh token
- 插件会自动使用当前发送者的
requesterSenderId作为external_subject - 查询时默认会按发送者维持
conversation_id,/chatbi ...和普通自然语言会共享同一个 ChatBI 会话 /chatbi:new <问题>、/chat_new <问题>、/chatbi new <问题>或用户明确要求“重新开始/换个问题/忽略前文”时,会优先新建 ChatBI 会话/chatbi:reset或/chatbi_reset会清空当前发送者绑定的 ChatBI 会话,但不会立即发起查询- 如果会话空闲超过
conversationIdleTimeoutMs,插件会自动开启新的 ChatBI 会话
