@ cloop/ 运行器
这个 cloop CLI:设备登录,一个stdio MCP服务器(Cloop Swills),和一个克洛德代码钩子可以使你的特工心跳入克洛普网. Harness-和域-可知性 – Claude Code, Cowork,和Codex都通过MCP服务器获得存在; Claude Code hooks 添加会话-生命周期细节.
安装
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 排出他们.
开发
npm install
npm run build
npm test
OAuth 倒计时
Claude Code和Codex可以在供应商登录失败后相互携带运行.
这对直接CLI跑车和T3跑车有效.
见 运行本 限制和释放步骤.
发行后合并, 运行 bash tools/ops/runner-oauth-fallback-wizard.sh 从寄存器根开始批准并安装.