# @cloop/runner 中文文档

规范地址：https://npmcn.com/package/%40cloop/runner/

版本：0\.3\.59
npm 元数据更新时间：2026-11-09T17:36:40.044Z
中文译文更新时间：2026-11-10T02:15:03.969Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40cloop/runner
原文对照：https://npmcn.com/package/%40cloop/runner/?lang=original
项目主页：https://mycloop.com/
源码仓库：https://github.com/ClosedLoopTechnologies/clo0p

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

- 包体积（解压后）：553 kB，34 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：2 个
- 首次发布：2026-10-07T16:20:40.102Z
- 最新版本发布：2026-11-09T17:36:39.898Z
- 近 30 天下载量：8539（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：57（近 12 个月 57 个）

## 中文简介

制作你的电脑和特工克洛普机器:设备登录,机器守护进程,克洛普MCP服务器,克洛德代码钩子.

## 安装

```sh
npm install @cloop/runner
```

也可以使用：`pnpm add @cloop/runner`、`yarn add @cloop/runner`、`bun add @cloop/runner`

## README

# @ cloop/ 运行器

这个 `cloop` CLI:设备登录,一个stdio MCP服务器(Cloop Swills),和一个克洛德代码钩子可以使你的特工心跳入克洛普网. Harness-和域-可知性 – Claude Code, Cowork,和Codex都通过MCP服务器获得存在; Claude Code hooks 添加会话-生命周期细节.

## 安装

```bash
npm install -g @cloop/runner
cloop login          # approve the device in your browser
cloop install        # register the MCP server with Claude Code / others
```

全权证书存于 `~/.cloop/credentials.json`。API来源于 `CLOOP_ORIGIN`,存储值,或中转默认值.

`npx -y @cloop/runner@latest connect` 让电脑成为克洛普机器 作为最后一步,它将远程Cloop MCP服务器添加到机器上每个克洛德码和Codex上,并在终端上与OAuth一起签名. 它运行 通常的行: `claude mcp add -s user --transport http cloop https://app.mycloop.com/api/mcp/mcp` 财务报告和审定财务报表 `codex mcp add cloop --url https://app.mycloop.com/api/mcp/mcp`,则 `claude mcp login cloop` 财务报告和审定财务报表 `codex mcp login cloop`。显示使用名称 `cloop-staging` 财务报告和审定财务报表 `https://mcp-staging.mycloop.com/mcp`。当任何名称下的一个条目已经拥有 URL时, `connect` 没有增加什么。 这个步骤从来没有做到 `connect` 失败。 细节 : `docs/runbooks/cloop-local.md`"相接",第五步.

要断开一个机器,请在线索页面上的QQ菜单中使用Disconnect.

### 窗口

`cloop connect` 在 Windows 上写入 `%LOCALAPPDATA%\Cloop\cloop-runner.cmd` 并登记每个用户的任务调度器任务, `Cloop Runner`在登录时运行。 不需要管理权。 日志是 `%LOCALAPPDATA%\Cloop\cloop-runner.log`。 。 。 . `cloop disconnect` 删除任务和发射器。 使用本地的 Claude 代码安装,即 `claude.exe` 打开 `PATH`。 Windows 路径由单位测试覆盖,尚未在 Windows 机上运行;细节和开点在其中 `docs/runbooks/cloop-local.md`,"温道"一节.

## 图标

| 命令 | 它会做什么 |
| --- | --- |
| `cloop login [--name <device>]` | 设备代码流 → 长寿符 |
| `cloop install` | `claude mcp add cloop -- cloop serve` + 同事/编码指令 |
| `cloop serve [--platform <p>]` | 运行 stdio MCP 服务器( 心跳存在) |
| `cloop hook session-start` | Claude 代码会话启动钩 - **未在第一阶段登记** |

### 存在模式(第1阶段)

MCP 服务器`cloop serve`)是唯一的存在来源:1 `agent_sessions` 每个活服务器进程行 。 内容 `session_key` 实值 `CLAUDE_SESSION_ID` 当吊带提供了它, 否则是一个每个进程 UUID. `name` (一) 系带标签( "Claude Code" / "Codex" / "Cowork"); `machine` 是主机名; 登录 `deviceName` 单独存在(`cli_devices.name`) (中文(简体) ).

`cloop hook session-start` 存在于树上,但 `cloop install` 已经 **没有** 接通了——克洛德码钩是第2阶段的编码适配器(richer session security complex). 将第1阶段保留为每个MCP进程一行.

## MCP工具

服务器会显示一个内置工具 加上共享的每个工具 app-side 注册 - 它获取 `GET {origin}/api/agent/mesh/tools` 启动时和 每个动态注册,代理呼叫通过 `POST {origin}/api/agent/mesh/tools` `{tool, input}`新的技能土地没有CLI的释放.

-   `cloop_status {}` ——内置:谁活在你的网状上,在什么表面上(服务) 当地 `/api/agent/mesh/status`,而不是登记册)
-   `cloop_inbox {action?}` ——内置: `drain` (默认)返回并清除 委托的任务/模式草案被推到这个代理人的网格之上; `list` 偷窥
-   登记工具——例如:. `search`, (中文(简体) ), `list_tasks`, (中文(简体) ), `get_task`, (中文(简体) ), `get_task_context`, (中文(简体) ), `get_contact`, (中文(简体) ), `list_cloops`, (中文(简体) ), `get_cloop`

如果启动时无法访问注册, 服务器只运行状态( 警告一次) (原始内容存档于2017-10-21). on stderr. A 类 `401` 从任何代理呼叫返回一个 `isError` 询问结果 要运行的用户 `cloop login`。 。 。 .

## 活生生存在的网状网状网状网状网状网状网状网(`cloop serve`(中文(简体) )

一开始, `serve` 打开一个 WebSocket 到 clop-mesh 工人的每个用户持久 对象在 `{CLOOP_MESH_URL}/mesh/agent?session_key=…` (默认) `https://mcp.mycloop.com`· ; `--staging` 或者说 `CLOOP_MESH_URL` 选择另一个 网格,选择被存储为 `meshUrl`) (中文(简体) ). 设备代号是第一个 `Sec-WebSocket-Protocol` 输入,永远不要 uRL( 流出到边缘日志中)。 当它升起时,出现 击打会骑上套接字( DO 镜像它们进入心跳路径) 和 HTTP `HeartbeatClient` 是后退;它与 1s-60s 后退 + jitter 重联. 来了 `delegate` 编号 : `dm` 框架附件为 `~/.cloop/inbox.jsonl` 编辑 状态行显示 a `✉ N` 待发徽章; `cloop_inbox` 排出他们.

## 开发

```bash
npm install
npm run build
npm test
```

## OAuth 倒计时

Claude Code和Codex可以在供应商登录失败后相互携带运行. 这对直接CLI跑车和T3跑车有效. 见 [运行本](https://npmcn.com/package/%40cloop/docs/runbooks/runner-oauth-fallback.md) 限制和释放步骤. 发行后合并, 运行 `bash tools/ops/runner-oauth-fallback-wizard.sh` 从寄存器根开始批准并安装.

## 常见问题

### @cloop/runner 是什么？

制作你的电脑和特工克洛普机器:设备登录,机器守护进程,克洛普MCP服务器,克洛德代码钩子\.

### 如何安装 @cloop/runner？

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

### @cloop/runner 支持 TypeScript 吗？

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

### @cloop/runner 支持 ESM 还是 CommonJS？

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

### @cloop/runner 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @cloop/runner 可以商用吗？

@cloop/runner 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @cloop/runner 的下载量有多少？

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

### @cloop/runner 还在维护吗？

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