克莱斯博特枢纽
运行来自 GitHub, Linear, Slack, 和Discord 的编码代理 .
文档 • 妇女 克莱斯博特 • 妇女 Apache 2.0 (英语)
[尖叫声] Clisbot Hub在早期开发. 期待突破变化和数据丢失. 加入 Clisbot 迪斯科 了解更多项目.
Clisbot Hub是用于 克莱斯博特。连接工作抵达的服务,并在您已经居住开发环境的机器上运行代理.
- 你的机器: Hub 发送到 Clisbot 守护进程 在您的笔记本上, devbox, 或构建服务器 .
- 您的配置 : 通过 Hub API 或 UI 更新资源; 当您需要便携式副本时导出 .
- 您的服务: 从GitHub、Linear、Slack、Discord或手动运行开始代理.
- 一个审计线索: 查看每个事件,配置修改,执行,以及结果.
GitHub ─┐ ┌─ laptop
Linear ─┼─ Clisbot Hub ────┼─ devbox
Slack ─┤ └─ build server
Discord ┘
快开始
你需要Node.js、Clisbot 和守护进程上的代理供应商.
clisbot hub init --provider codex
这将创建一个种子的本地助理工作空间及其守护进程, 然后启动
需要的地方枢纽。 默认的个人工作空间是
<resolved Clisbot home>/workspaces/default,独立于当前目录.
使用团队助理 workspaces/team。保存现有文件.
在 Clisbot 应用集成的 Hub 设置中完成账户设置 。 灵枢
后端 URL 没有单独的管理 UI. 供应堵塞或
电报证书到 hub init 或者说 bot start 配置连接,
成员路线,和通过API的拥有者身份. 以前链接的拥有者可以使用
机器人立即; 一个没有链接的拥有者获得一个私有的一次性链接命令.
见 助理快速启动 页:1
证书标记, 不监视所有者的设置, 并重新开始行为 .
Hub 没有项目可以创建或选择 。 出口/编辑/部署不需要
正常配置流程。 继承的CLI脚手架/项目/部署地表是:
仅在 CLISBOT_ONBOARDING_ENABLED=0 明确选择.
见 枢纽文件 用于 PostgreSQL, Docker, 公共URL, 环境管理配置,以及生产部署.
本地开发
你需要节点和npm。 使用嵌入式数据库且没有外部服务的新检查退出 :
npm install
npm run dev
汉克听 http://localhost:6870 (英语) 只用于后端请求。 使用 npm run dev:clisbot 用于集成应用程序开发设置的单列波根;参见
发展中存储嵌入式数据库及其生成的认证密钥 $XDG_DATA_HOME/clisbot-hub后退为 ~/.local/share/clisbot-hub,并保持二者的重启。 设定 CLISBOT_HUB_DATA_DIR 要使用不同的目录,或设置 DATABASE_URL 改为使用 PostgreSQL :
DATABASE_URL=postgres://postgres:postgres@localhost:5432/clisbot_hub npm run dev
嵌入模式支持每个数据目录一个Hub进程. Docker Confose继续用PostgreSQL运行Hub.
用多克编曲运行
连接外部提供者时需要多克,多克编曲,以及一个公共的HTTPS URL.
git clone https://github.com/longbkit/clisbot.git
cd clisbot/packages/hub
cp .env.example .env
设置这些值为 .env数字 :
CLISBOT_HUB_APP_URL=https://hub.example.com
CLISBOT_HUB_CREDENTIAL_MASTER_KEY=replace-with-a-persistent-32-byte-base64-key
CLISBOT_BOOTSTRAP_ORGANIZATION=My organization
[email protected]
CLISBOT_BOOTSTRAP_OWNER_PASSWORD=replace-with-a-temporary-password
生成证书加密密钥一次 openssl rand -base64 32 财务报告和审定财务报表
保持你的部署秘密。 复用过复用. 或者,
配置 CLISBOT_HUB_CREDENTIAL_MASTER_KEY_FILE 绝对密
路径。 见 Docker 服务模式。 。 。 .
Hub在数据库中生成并存储其认证秘密. 高级部署可能设定
CLISBOT_HUB_AUTH_SECRET 不替换存储的秘密.
账单是可选的:请假 STRIPE_SECRET_KEY 未设置和Hub运行 完全没有计费表面。 见 文件/帐单,md。 。 。 .
邀请电子邮件也是可选的: 设置 RESEND_API_KEY 财务报告和审定财务报表 RESEND_FROM 到电子邮件组织
请通过Resend。 没有他们,管理者仍然可以复制和分享邀请链接.
同样的两个变量提供电子邮件注册链接, 电子邮件注册要求根据
域名自动注册。 Google 登录和域名自我注册在
文件/地物/谷歌-社交-登录。 。 。 .
然后启动 Hub 和 PostgreSQL :
docker compose up -d
服务 Clisbot 网络用户界面 CLISBOT_HUB_APP_URL,引导其枢纽API到此
后端 。 守护进程可选 CLISBOT_HUB_PROXY_URL 处理此路由.
对于装有应用程序的单个容器,守护进程和枢纽,请使用 CLISBOT_RUN_MODE=all
打开 http://localhost:6868; 见 Docker 服务模式。 。 。 .
用应用程序中的靴子套接字签入并替换其临时密码.
使用为 Hub API 服务的公共源头连接守护进程 :
clisbot hub connect https://hub.example.com
枢纽使用共享 ghcr.io/longbkit/clisbot 图像。 此编译文件选中
CLISBOT_RUN_MODE=hub。见 容器模式和构建。 。 。 .
见 自主办指南 关于生产部署的细节. 关于线性设置和工作流程,请参见公众 线性应用 财务报告和审定财务报表 线性触发器 向导.
供应商选项和枢纽工具
工作流程步骤可能通过一个与JSON兼容、提供者-本土 agent.options 对象。 保护中心
; 选定的 Clisbot 提供者验证和应用它们:
agent:
provider: codex
model: gpt-5.5
mode: full-access
thinkingOptionId: high
options:
sandbox_workspace_write:
writable_roots:
- /var/cache/npm
network_access: false
选项和模式是被选中的提供者所特有的,不是便携式的。 新触发器需要
明确 mode· ; thinkingOptionId 可省略使用提供者默认值。 中心总是赠款
执行范围 finish_execution 工具。 对话触发器也得到无限的
事件本土 reply 进展和最后反应工具。 供应商或机器保单仍在提供
控制每个无关的工具。 只读提供者配置是深度防御; Hub 输出
授权仍由执行 MCP 服务器执行 .
公共 API
每个枢纽服务其生成的OpenAPI 3.1合同 /api/openapi.json。 。 。 .
短数 公共 API 指南 覆盖 CLI 登录、版本、,
验证范围,并要求关联.
许可证
阿帕奇 - 2.0