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