# @clisbot/hub 中文文档

规范地址：https://npmcn.com/package/%40clisbot/hub/

版本：2\.2\.3
npm 元数据更新时间：2026-11-05T01:34:10.101Z
中文译文更新时间：2026-11-10T02:12:15.452Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40clisbot/hub
原文对照：https://npmcn.com/package/%40clisbot/hub/?lang=original
项目主页：https://clisbot.com/docs/hub
源码仓库：https://github.com/longbkit/clisbot

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：60.1 MB，4005 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：56 个
- 首次发布：2026-10-10T10:33:22.056Z
- 最新版本发布：2026-11-05T01:34:09.912Z
- 近 30 天下载量：3432（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 18 个）

## 中文简介

Clisbot 守护进程自动托管

## 安装

```sh
npm install @clisbot/hub
```

也可以使用：`pnpm add @clisbot/hub`、`yarn add @clisbot/hub`、`bun add @clisbot/hub`

## README

![Clisbot logo](https://clisbot.com/logo.svg)

# 克莱斯博特枢纽

运行来自 GitHub, Linear, Slack, 和Discord 的编码代理 .

[文档](https://clisbot.com/docs/hub) • 妇女 [克莱斯博特](https://github.com/longbkit/clisbot) • 妇女 [Apache 2.0 (英语)](https://npmcn.com/package/%40clisbot/hub/LICENSE)

> \[尖叫声\] Clisbot Hub在早期开发. 期待突破变化和数据丢失. [加入 Clisbot 迪斯科](https://discord.gg/awGmcmFXC) 了解更多项目.

Clisbot Hub是用于 [克莱斯博特](https://clisbot.com/)。连接工作抵达的服务,并在您已经居住开发环境的机器上运行代理.

-   **你的机器:** Hub 发送到 Clisbot 守护进程 在您的笔记本上, devbox, 或构建服务器 .
-   **您的配置 :** 通过 Hub API 或 UI 更新资源; 当您需要便携式副本时导出 .
-   **您的服务:** 从GitHub、Linear、Slack、Discord或手动运行开始代理.
-   **一个审计线索:** 查看每个事件,配置修改,执行,以及结果.

```text
 GitHub ─┐                 ┌─ laptop
 Linear ─┼─ Clisbot Hub ────┼─ devbox
 Slack  ─┤                 └─ build server
 Discord ┘
```

## 快开始

你需要Node.js、Clisbot 和守护进程上的代理供应商.

```sh
clisbot hub init --provider codex
```

这将创建一个种子的本地助理工作空间及其守护进程, 然后启动 需要的地方枢纽。 默认的个人工作空间是 `<resolved Clisbot home>/workspaces/default`,独立于当前目录. 使用团队助理 `workspaces/team`。保存现有文件.

在 Clisbot 应用集成的 Hub 设置中完成账户设置 。 灵枢 后端 URL 没有单独的管理 UI. 供应堵塞或 电报证书到 `hub init` 或者说 `bot start` 配置连接, 成员路线,和通过API的拥有者身份. 以前链接的拥有者可以使用 机器人立即; 一个没有链接的拥有者获得一个私有的一次性链接命令. 见 [助理快速启动](https://npmcn.com/package/public-docs/hub/quickstart.md) 页:1 证书标记, 不监视所有者的设置, 并重新开始行为 .

Hub 没有项目可以创建或选择 。 出口/编辑/部署不需要 正常配置流程。 继承的CLI脚手架/项目/部署地表是: 仅在 `CLISBOT_ONBOARDING_ENABLED=0` 明确选择.

见 [枢纽文件](https://clisbot.com/docs/hub) 用于 PostgreSQL, Docker, 公共URL, 环境管理配置,以及生产部署.

## 本地开发

你需要节点和npm。 使用嵌入式数据库且没有外部服务的新检查退出 :

```sh
npm install
npm run dev
```

汉克听 [http://localhost:6870 (英语)](http://localhost:6870/) 只用于后端请求。 使用 `npm run dev:clisbot` 用于集成应用程序开发设置的单列波根;参见 [发展](https://npmcn.com/package/docs/development.md)中存储嵌入式数据库及其生成的认证密钥 `$XDG_DATA_HOME/clisbot-hub`后退为 `~/.local/share/clisbot-hub`,并保持二者的重启。 设定 `CLISBOT_HUB_DATA_DIR` 要使用不同的目录,或设置 `DATABASE_URL` 改为使用 PostgreSQL :

```sh
DATABASE_URL=postgres://postgres:postgres@localhost:5432/clisbot_hub npm run dev
```

嵌入模式支持每个数据目录一个Hub进程. Docker Confose继续用PostgreSQL运行Hub.

## 用多克编曲运行

连接外部提供者时需要多克,多克编曲,以及一个公共的HTTPS URL.

```sh
git clone https://github.com/longbkit/clisbot.git
cd clisbot/packages/hub
cp .env.example .env
```

设置这些值为 `.env`数字 :

```dotenv
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
CLISBOT_BOOTSTRAP_OWNER_EMAIL=me@example.com
CLISBOT_BOOTSTRAP_OWNER_PASSWORD=replace-with-a-temporary-password
```

生成证书加密密钥一次 `openssl rand -base64 32` 财务报告和审定财务报表 保持你的部署秘密。 复用过复用. 或者, 配置 `CLISBOT_HUB_CREDENTIAL_MASTER_KEY_FILE` 绝对密 路径。 见 [Docker 服务模式](https://npmcn.com/package/docs/docker.md#service-modes)。 。 。 .

Hub在数据库中生成并存储其认证秘密. 高级部署可能设定 `CLISBOT_HUB_AUTH_SECRET` 不替换存储的秘密.

账单是可选的:请假 `STRIPE_SECRET_KEY` 未设置和Hub运行 完全没有计费表面。 见 [文件/帐单,md](https://npmcn.com/package/%40clisbot/hub/docs/billing.md)。 。 。 .

邀请电子邮件也是可选的: 设置 `RESEND_API_KEY` 财务报告和审定财务报表 `RESEND_FROM` 到电子邮件组织 请通过Resend。 没有他们,管理者仍然可以复制和分享邀请链接. 同样的两个变量提供电子邮件注册链接, 电子邮件注册要求根据 域名自动注册。 Google 登录和域名自我注册在 [文件/地物/谷歌-社交-登录](https://npmcn.com/package/docs/features/google-social-login/README.md)。 。 。 .

然后启动 Hub 和 PostgreSQL :

```sh
docker compose up -d
```

服务 Clisbot 网络用户界面 `CLISBOT_HUB_APP_URL`,引导其枢纽API到此 后端 。 守护进程可选 `CLISBOT_HUB_PROXY_URL` 处理此路由. 对于装有应用程序的单个容器,守护进程和枢纽,请使用 `CLISBOT_RUN_MODE=all` 打开 `http://localhost:6868`; 见 [Docker 服务模式](https://npmcn.com/package/docs/docker.md#service-modes)。 。 。 . 用应用程序中的靴子套接字签入并替换其临时密码. 使用为 Hub API 服务的公共源头连接守护进程 :

```sh
clisbot hub connect https://hub.example.com
```

枢纽使用共享 `ghcr.io/longbkit/clisbot` 图像。 此编译文件选中 `CLISBOT_RUN_MODE=hub`。见 [容器模式和构建](https://npmcn.com/package/docs/docker.md)。 。 。 .

见 [自主办指南](https://clisbot.com/docs/hub/self-hosting) 关于生产部署的细节. 关于线性设置和工作流程,请参见公众 [线性应用](https://clisbot.com/docs/hub/self-hosting/linear-app) 财务报告和审定财务报表 [线性触发器](https://clisbot.com/docs/hub/triggers/linear) 向导.

## 供应商选项和枢纽工具

工作流程步骤可能通过一个与JSON兼容、提供者-本土 `agent.options` 对象。 保护中心 ; 选定的 Clisbot 提供者验证和应用它们:

```yaml
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 指南](https://npmcn.com/package/%40clisbot/hub/docs/public-api.md) 覆盖 CLI 登录、版本、, 验证范围,并要求关联.

## 许可证

阿帕奇 - 2.0

## 常见问题

### @clisbot/hub 是什么？

Clisbot 守护进程自动托管

### 如何安装 @clisbot/hub？

在项目目录运行 npm install @clisbot/hub，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 clisbot-hub，可以用 npx clisbot-hub 直接运行。

### @clisbot/hub 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/clisbot\_\_hub 是否存在。

### @clisbot/hub 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @clisbot/hub 可以商用吗？

@clisbot/hub 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @clisbot/hub 的下载量有多少？

根据 npm 官方下载统计，@clisbot/hub 在 2026/10/10 – 2026/11/08 这 30 天内被下载 3,432 次，日均约 114 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @clisbot/hub 还在维护吗？

最新版本 2\.2\.3 发布于 2026/11/05（5 天前）；至今共发布 18 个版本，其中过去 12 个月发布了 18 个；首次发布于 2026/10/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。