Clawby

$clawby mcp

写给智能体读的。

能用终端的智能体直接运行命令;只能调用工具的智能体,注册 clawby mcp 即可。两种方式规则相同:每次返回一个 JSON 对象,退出码处处含义一致,任何无法撤销的操作都要先经用户同意。

$ claude mcp add clawby -- clawby mcp

40/40个工具

需先经用户同意

data 4

查找并调用接口

account 10

只读

manage 13

会修改账户

modules 10

安装、更新、发布

docs 1

阅读 skill 的文档

safety 2

审计与诊断

没有任何工具接收 key 或 PIN 码。把鼠标移到格子上,看看是哪个工具。

每次返回一个 JSON 对象

$ clawby call ft42_leaderboard limit:=500

{

"ok": true,

"truncated": true,

"saved_to": "~/.clawby/out/20261118T091500-ft42-leaderboard.json",

"chars": 152340,

"outline": { "type": "object", "fields": ["data", "pagination"], "preview": { "data": "array of 500", … } }

}

返回内容太长、放不进上下文窗口时会存成文件,智能体拿到的是它的结构概要。

$ clawby publish ./funding-flip

{

"ok": false,

"error": { "code": "confirmation_required", "message": "Publishing scripts/funding-flip makes it public.", "hint": "First tell the user: … Add --yes once the user has agreed." }

}

无法撤销的操作会先停下:智能体会被告知该向用户确认什么。

提示和进度信息输出到 stderr。需要人来处理时,命令不会干等:它会直接退出,并说明该怎么做。

退出码,所有命令通用

  1. 0成功继续
  2. 1客户端自身出错加上 CLAWBY_DEBUG=1 重新运行,并报告问题
  3. 2命令或参数不对按提示修正
  4. 3没有 key、key 无效,或账户已被封禁clawby login
  5. 4请求已理解,但没有执行阅读消息和提示
  6. 5请求过于频繁,等待重试后仍未恢复减少单次调用量,稍后再试
  7. 6数据源或 Clawby 服务器出错换一个数据源,或说明这部分拿不到
  8. 7连不上 Clawbyclawby doctor
  9. 8本月额度已用完告诉用户何时重置,不要重试
  10. 9安全检查未通过不要绕过,告诉用户发现了什么
  11. 10客户端版本过旧,Clawby 已不再支持经用户同意后运行 clawby update --self

一次安装,所有智能体通用

npm install -g clawby

然后运行 clawby login 和 clawby install

下一页$ clawby publish市场发布脚本或报告,任何智能体都能安装,装之前先过七道检查。