跳到正文
你的 AI@https://hoody.com Connect to Hoody

开发者模式

我们说得很直白。下面是 Hoody 的具体样子。

现在每个部分都会列出背后的 Bot API 调用,并带有“复制”按钮。完整的调用列表在最后。

查看调用

hoody / bots

Bots

跟你的 Bots 说话。
它们负责运行智能体

Bot 是长期运行的助手,只有一个聊天,整段对话都会保留。想做什么直接说:它会在你的电脑上启动智能体,跟进它们的工作,并汇报它们做了什么。给它一个 .hoody.bot URL,再用带名称的密钥分享给你信任的人和 AI。

你的第一个 Bot chief 从一开始就在。内置 Hoody AI(免费)。也可以用 ChatGPT 登录。经你允许后,Bot 的帮手可以通过 Claude Code 使用 Claude Pro 或 Max。

整体结构示例
你

修正我的网站上的错别字和商店的价格,再整理新照片。

你的 Bot

chief一个聊天 · 较早内容已总结 · 你设定的限制

智能体

已完成修正我的网站上的错别字

待你确认修正商店价格

处理中整理新照片

你的电脑
我的网站 商店 照片库

每个智能体都是你某台电脑上的一个完整 Hoody Agent 会话。

具体说明

你的第一个 Bot
GET /api/v1/agent/bots/chiefchief 在首次使用时创建,所以 Bots 列表不会为空。
运行位置
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/botsBots 运行在 Hoody Agent (agent-1) 上,不是 /api/bot/ 的聊天应用服务。
hoody / how it flows

一条消息一路送达,报告会回到你手上。

你

从以下任一方式发起

报告完成。商店已修复。

你的电脑

你的 Bot

立刻接收你的消息,做完后汇报

智能体

它的帮手

智能体

它的帮手

  • 我的网站更新
  • 商店修复
  • 照片库备份

示例这一切都在你的电脑上运行。你的 Bot 认得每一台。

具体说明

它的智能体
GET /api/v1/agent/bots/chief/delegates?state=open每个受委派的智能体都是一个普通会话,用 /sessions 路由读取或接入。已打开的会话带有 capability 和 current_step。
它自己的实时回合
GET /api/v1/agent/sessions/{session_id}/stream回复文本和思考内容会边写边出现,还有工具调用和每个回合的结束。Bot 收到第一条消息后,session_id 来自 GET /bots/{id}。
更多:一次一个 Bot,看完整的一个回合

你只提问一次,它来分派工作

它先回复,把耗时的部分交给新启动的智能体,再带着智能体的提问和结果回来找你。

示例回合

你,09:12

修正我的网站上价格的错别字。再查一下商店的结账为什么变慢了。

Chief,09:12

收到。我来启动两个智能体:一个在我的网站上修正,一个在商店测量结账耗时。做完我向你汇报。

已启动 2 个智能体 · 我的网站、商店

Chief,09:19

我的网站智能体改好了错别字,想运行这个操作。允许吗?

bash: ./publish.sh

你,09:20

可以,执行。

[报告] 我的网站智能体已完成:错别字已修正,网站已更新。

Chief,09:31

我的网站已完成:修复已上线。结账在等一次缓慢的查询,商店的智能体已有可试的修复方案。

随时发消息它忙的时候,发来的消息会排队等候。再发一条更正,它会把两条一起读。
在你的电脑上工作智能体就在你的代码和文件所在的地方运行,关掉标签页后也会继续。
回来问你只有你发送的消息才能批准智能体的请求,智能体的报告不能。

具体说明

你的消息
POST /api/v1/agent/bots/chief/messages返回 202,附带 message_id、state 和 turn_id;Bot 忙时返回 state: queued。
它的回复
GET /api/v1/agent/bots/chief/streamSSE:先发一个 state 帧,之后每条日志行发一个 row;用 Last-Event-ID 续接。
停止一个智能体
POST /api/v1/agent/bots/chief/delegates/{sid}/stop立即停止该智能体的工作,不会停止 Bot。{"close": true} 还会关闭它的会话。
直接开口说
POST /api/v1/agent/bots/chief/messages/audiowav 或 mp3 录音会转写成文字,作为你的消息发出。
hoody / api

给 Bot 一个公开 URL,连接你信任的人、应用和 AI

一个 URL,三种接入方式:作为模型,供接受 base URL 的应用和 SDK 使用(OpenAI 或 Anthropic 格式);作为 MCP 服务器;或在脚本中通过纯 HTTP 调用。

chief · Bot URL

https://<label>.hoody.bot
Bot 的二维码,中间是 Bot 标志,样式与 Hub 生成的一致:用手机扫描,就能打开该 Bot 的聊天页面。此示例打开 hoody.com/bots。

1在应用中

你的应用示例 ID
格式
Base URL<Bot URL>/v1
模型bot:global/chief
API Key你的 hbk_ Key
Base URL<Bot URL>
模型bot:global/chief
API Key你的 hbk_ Key
Server URL<Bot URL>/mcp
传输方式HTTP,每个请求都用 POST
API Key你的 hbk_ Key

支持 chat completions、responses 和 models。只发送最后一条用户消息,应用自己的系统提示词和设置不会发送。

支持 messages 和 models,使用不带 /v1 的 URL。只发送最后一条用户消息,应用自己的系统提示词和设置不会发送。

把 Bot 当作 MCP 服务器:返回 JSON-RPC 响应,无需保持会话,也没有事件流。

2从脚本调用

纯 HTTP

  • POST /bots/chief/messages

    用脚本、cron 任务或另一个 AI 给它派一个任务。

  • GET /bots/chief/stream

    跟踪已完成的回复和智能体事件。Bot 的会话流会边写边显示回复文字。

  • POST /bots/chief/delegates/{sid}/stop

    停止一个智能体,Bot 继续运行。

3谁能进入

给每个可信的人或应用一个带名称的 Key。可以暂停它,设置过期时间或 IPv4 限制,也可以单独撤销。

所有持有 Key 的人共用同一个对话。只分享给你信任的人和 AI。

可以把 Bot 限定在一个领域:它的智能体只能看到该领域的电脑。

具体说明

Bot 基础 URL
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{realm}/{bot}OpenAI 用 <base>/v1,Anthropic 用基础 URL,MCP 用 <base>/mcp。{realm} 为 global 或 24 位十六进制 id。GET /bots/{id} 在 urls 下列出它们。共享 Bot:https://<label>.hoody.bot/v1/chat/completions,带 Bearer Key。
发送消息
curl -X POST "<agent>/api/v1/agent/bots/chief/messages" -H "Authorization: Bearer <token>" -d '{"text":"Ship it"}'文本最多 64 KiB;返回 202。
停止一个智能体
POST /api/v1/agent/bots/chief/delegates/{sid}/stop {"close":true}停止一个受委派的智能体,不会停止 Bot。
hoody / guardrails

用日常语言写,设置就这些

用你自己的话写下 Bot 绝不能做的事。保存,完成。

  • 无需语法
  • 每个智能体都会收到
  • 有风险的工作在开始前会先检查

chief · 护栏示例

不要推送到 main,开一个 PR 并等我确认 不要动账单、DNS 和支付 生产数据库只读 任务花费超过 $20 时,停下来问我 拿不准就问我,不要猜

具体说明

替换护栏
PUT /api/v1/agent/bots/chief/guardrails {"guardrails":"Never push to main."}一个文本字段;Bot 会在下一条消息之前收到每一行,并带有 [guardrails updated] 标记。
严格程度
"guardrail_check": "strict"strict(默认)、lenient 或 off。docs / api / agent / bots ↗

具体说明

随处发送
POST /api/v1/agent/bots/chief/messages {"text":"Is staging up?"}返回 202;Bot 忙碌时返回 queued。加上 Idempotency-Key 即可安全重试。
续接数据流
GET /api/v1/agent/bots/chief/stream?since=154Server-Sent Events;每个行帧的 id 就是它的 seq,所以 Last-Event-ID 会自动续接。
语音入口
…/bots/{id}/voice · …/bots/{id}/realtime每个 Bot 同一时间只有一个实时语音连接;takeover=true 会替换它。docs / api / agent / bots ↗
更多:日志
示例:四台设备,一个 Bot,一条日志

四台设备同时打开同一个 Bot:手机、笔记本、终端和 AI 应用。手机和笔记本在同一时刻(22:31)发送消息,消息依次记为 #152、#153,Bot 的回复记为 #154。每台设备看到的顺序相同。较早的轮次折叠成一段简短摘要,涵盖 #1 至 #120 行;最新的轮次,#121 至 #154,逐字保留。完整日志保留每一行。

每台设备,同一个对话。手机、笔记本、终端和 AI 应用同时打开同一个 Bot,每台设备看到的顺序相同。持有 Key 的人也共用这个对话,所以只分享给你信任的人。

每条消息都会得到下一个编号。同一时刻发送的两条消息,依次记为 #152、#153。Bot 忙碌时发送的消息,会等到它的下一轮。

空间不会用完。模型的上下文窗口填满时,较早的轮次会折叠成简短摘要,最新的轮次逐字保留,Bot 继续工作。日志保留每一行;执行遗忘后,这些行会移到归档。

每行包含什么
每行包含 seq、at、role(user、bot、event 或 system)和 text,也可以包含 session_id。日志按 seq 分页;流式传输会在每行写入时立即发送该行。
切换模型
新模型从 Bot 的下一个会话开始:重置会把日志移到归档,并开启新会话。归档在你清除之前一直可读。
智能体保留的记忆
智能体还会保存和搜索自己的记忆(按关键词、语义和条目之间的链接),不会锁定在某一个 AI 应用里。docs / api / agent / memory ↗

具体说明

读取日志
GET /api/v1/agent/bots/chief/log按顺序返回各行,按 seq 分页。
实时跟随
GET /api/v1/agent/bots/chief/stream先是一个 state 帧,然后是各行;指向已移入归档的游标会返回 lagged。
遗忘
POST /api/v1/agent/bots/chief/forget之后用 GET …/archive 读取;用 POST …/purge 删除。
更多:Hook

接入 Hook:你的脚本最先看到调用,最后看到响应

Hook 会先把匹配的 HTTP 调用交给你的某个 Exec 脚本,再发往 Bot 或你电脑上的大多数其他服务。匹配路径上的 WebSocket 升级请求会直接拒绝,所以匹配范围要排除 Bot 语音入口这类路径。进入时,脚本可以观察、检查、修改、回复或拦截调用。返回时,脚本可以读取响应,并在调用方收到之前修改它。无需打补丁。

从调用方到 Bot 或你电脑上大多数其他服务的往返回路。调用沿上方进入,响应沿下方返回。同一个 Exec 脚本横跨两条路径,所以进入时能看到每个调用,返回时能看到每个响应。每个 Hook 都有时间限制,默认 500 ms。

入调用进入时

  • 观察记录谁调用了什么,然后放行。查看脚本隐藏脚本

    规则:POST /api/v1/agent/bots/* → /bot-audit

    module.exports = async function (req, res, metadata) {
      if (!metadata.hook) {
        res.writeHead(404);
        return res.end();
      }
      const ip = req.headers['x-real-ip'];
      console.log(metadata.hook.auditId,
        metadata.hook.origPath, ip);
      await metadata.hook.forward(req, res);
    };

    脚本能看到真实的客户端 IP。没有经过 Hook 直接调用时,metadata.hook 为空,所以会返回 404。forward() 会把调用原样交给 Bot。

  • 检查只放行已登录的用户。限流也放在同一处。查看脚本隐藏脚本

    规则:any method except OPTIONS /api/v1/agent/bots/* → /identity-gate

    module.exports = async function (req, res, metadata) {
      if (!metadata.hook) {
        res.writeHead(404);
        return res.end();
      }
      const user = verifyClaim(
        req.headers['x-hoody-claim']);
      if (!user) {
        res.writeHead(401);
        return res.end();
      }
      await metadata.hook.forward(req, res,
        { headers: {
          'x-hoody-claim': null,
          'x-hoody-user': user.username,
        } });
    };

    verifyClaim 会检查用 ED25519 签名的 Hoody 登录声明;完整脚本见文档。没有声明的人会收到 401,不会到达 Bot。这条规则也会拒绝 WebSocket 语音路径,需缩小匹配范围,把它们排除在外。

  • 修改在调用到达前改写方法、路径、请求头或请求体。
  • 拦截拒绝未通过病毒扫描的上传,或超出你设定限额的调用。
  • 回复自己回复,例如“马上回来”,Bot 不会看到这次调用。查看脚本隐藏脚本

    规则:POST /api/v1/agent/bots/* → /bot-gate

    module.exports = async function (req, res, metadata) {
      if (!metadata.hook) {
        res.writeHead(404);
        return res.end();
      }
      if (process.env.MAINTENANCE) {
        res.writeHead(503);
        return res.end('Back soon');
      }
      await metadata.hook.forward(req, res,
        { headers: { cookie: null } });
    };

    脚本发出的回复不会到达 Bot。forward() 还可以修改方法、路径、请求头或请求体;把请求头设为 null 即删除它。

出响应返回时

  • 读取响应在调用方之前看到状态、响应头和响应体。
  • 改写原样发出响应,或发出你自己的响应。查看脚本隐藏脚本

    规则:any method except OPTIONS /api/v1/agent/bots/* → /bot-answer

    module.exports = async function (req, res, metadata) {
      if (!metadata.hook) {
        res.writeHead(404);
        return res.end();
      }
      const up = await metadata.hook.fetchUpstream(req);
      if (up.status === 401) {
        res.writeHead(401);
        return res.end('Please sign in again');
      }
      res.setHeader('x-hoody-hook-audit', metadata.hook.auditId);
      await metadata.hook.pipeResponse(up, res,
        { method: req.method });
    };

    fetchUpstream() 获取 Bot 的响应但不发出,所以脚本先读取它;pipeResponse() 再把它发出。流式响应在 Hook 的时间限制处结束,最长 30,000 ms。

  • 清理响应头去掉响应中的私有头,加上 CSP。

每个 Hook 都有时间限制,默认 500 ms。脚本出错或超时,调用就在这里停止。docs / proxy / hooks ↗

具体说明

添加 Hook
POST /api/v1/computers/{id}/proxy/hooks/agent · If-Match: file:v<N> {"match":{"method":["POST"],"path":"/api/v1/agent/bots/*"},"script":{"path":"/bot-audit"},"timeout":500}服务器会为 Hook 分配 id。规则按顺序执行,第一条匹配的生效。
读取版本
GET /api/v1/computers/{id}/proxy/hooks/agent每次修改 Hook 都需要带上 If-Match: file:v<N> 和当前版本。
脚本
POST /api/v1/exec/scripts/write {"path":"bot-audit.js","content":"module.exports = async function (req, res, metadata) { … }"}这里的脚本内容只是个框架:把 { … } 换成你的审计代码。script.path 是你自己 hoody-exec 里某个脚本的名字。把它写到你的 exec 链接上;/bot-audit 提供 bot-audit.js。docs / api / exec / script-management ↗

一行命令,免费开始

免费开始,不需要银行卡:内置 Hoody AI,你已经在用的 AI 也能用。

无需代码
代码
你的 AI@https://hoody.com Connect to Hoody

适用于 ChatGPT、Claude 或任何能读取网页的 AI。复制后粘贴进去。

你的 AI
@https://hoody.com Connect to Hoody
docs / foundation / agent-skill-bundle
浏览器
https://hub.hoody.com
docs / kit / agent
终端
ssh hoody.com任何带有 SSH 客户端的电脑都可以,在交互式终端中使用,无需安装。
docs / kit / agent
技能
npx skills add https://hoody.com/SKILLS/SKILL.mdnpx skills add HoodyNetwork/hoody-sdk第二条会把所有文档页面保存到磁盘,供离线使用。
docs / foundation / agent-skill-bundle
CLI
npm install -g hoody-sdkcurl -fsSL https://install.hoody.com | sh第二条适用于 Linux 和 macOS。不安装也可以:npx hoody-sdk <command>
docs / foundation / cli
SDK
npm install hoody-sdkTypeScript。支持 Node.js 20.19 及以上版本、Bun 和 Deno。
docs / getting-started / quickstart
HTTP API
curl -H "Authorization: Bearer <token>" https://api.hoody.com/api/v1/computers/
docs / api / authentication
浏览器 SDK
<script src="https://cdn.jsdelivr.net/npm/hoody-sdk/dist/hoody-sdk.browser.min.js"></script>提供 window.HoodySDK。生产环境中固定版本,并给页面短期、限定范围的令牌。
docs / getting-started / quickstart

始于 2021年

从隐私到智能体基础设施

hoody / kit

你的电脑自带什么

每个服务都有自己的链接。可以打开它、分享它,或交给你的 AI。拿到链接的人都可以打开,直到你锁定。Kit 链接的格式是 https://{p}-{c}-<kit>-1.{node}.computers.hoody.com:{p} 是你的项目,{c} 是某一台电脑,{node} 是它的服务器。

电脑

Bots

API