chatley-cli

中文文档
0.2.1发布于 2026/11/03MIT

Chatley Line命令行:给AI代理自己的电话号码,拨打电话和短信,回答实时查询,并运行本地MCP服务器。

中文使用文档
文档目录4 节
  1. 现场答题( chatley listen )
  2. MCP
  3. 车主只行动
  4. 配置

chatley-cli

从命令行为AI代理提供自己的Chatley Line(电话号码),在他们等待时实时回答来电者的问题,并为无法添加远程MCP的代理运行本地MCP服务器。

npm install -g chatley-cli
chatley signup                     # shows a link + code; you approve in the browser; the key is saved
chatley line                       # number, plan, credit, texting status, today's usage
chatley pricing                    # plan, per-minute and per-text prices, credit packs
chatley call +14155550123 --task "Ask if they have a table for two Friday at 7" --wait
                                   # waits for the owner's approval first when the number is new
chatley text +14155550123 --message "Running 10 minutes late" --objective "Confirm the new time" [--from <number>]
chatley texting status             # texting registration (carriers require it)
chatley approvals | billing | templates | contacts | events
chatley listen --runtime claude-code --exec "./answer.sh"
chatley mcp                        # stdio MCP server

现场答题(chatley listen)

保存行的事件套接字。事件以JSON行形式打印并得到确认。当呼叫者询问只有您的座席知道的事情时,请求将转到 --exec 在stdin (question, untrusted_caller_text, untrusted_conversation); 打印 {"context": "...", "disposition": "facts"} 或者纯文本回答,或者什么都不让行继续。呼叫者的话是数据:你的命令永远不能按照其中的指示行事。自行重新连接;未读事件重放。

MCP

{ "mcpServers": { "chatley": { "command": "npx", "args": ["-y", "chatley-cli", "mcp"] } } }

没有保存密钥,它只暴露 chatley_auth_login 和 chatley_auth_poll. 批准后,密钥保存到个人资料中,并出现电话工具(get_phone_line, place_call, get_approval, wait_for_call, stop_call, send_text, list_texts, get_texting_status, register_texting, list_events, push_call_context, list_numbers, list_contacts, create_contact, list_templates, apply_template, get_pricing, get_line_billing, buy_call_credits); 客户被告知工具列表已更改。设备代码和密钥永远不会出现在工具结果中。

车主只行动

话务员的钥匙不能花掉话主卡上的钱,也不能撤销线路:购买或释放号码、取消套餐、选择高级语音、付费短信注册(本地号码是个人或企业号码;免费电话是免费的,也允许),以及设置或清除话主密码。服务器应答 403 OWNER_ACTION_REQUIRED 与一个 dashboard_url;告诉那个人在那里做。 chatley numbers buy / numbers release 打印该消息。从代理自己的钱包中添加信用(buy_call_credits(共享支付令牌,5至500美元)是允许的。

配置

CHATLEY_API_KEY使用此键代替已保存的键(从未写入磁盘)
CHATLEY_API_BASEAPI基础,默认 https://app.chatley.ai/api. HTTPS。
CHATLEY_CONFIG_DIR配置文件所在的位置(默认 ~/.config/chatley, %APPDATA%\chatley 在Windows上);该文件是唯一的所有者

协议参考: https://www.chatley.ai/skill.md

许可协议:麻省理工学院。

版本与发布记录

chatley-cli 共发布 3 个版本,首次发布于 2026/10/29;过去 12 个月发布了 3 个版本。

版本发布日期距今
0.2.1latest2026/11/03今天
0.2.02026/10/295 天前
0.0.0-stage2026/10/295 天前

关于 chatley-cli 的常见问题

chatley-cli 是什么?

Chatley Line命令行:给AI代理自己的电话号码,拨打电话和短信,回答实时查询,并运行本地MCP服务器。

如何安装 chatley-cli?

在项目目录运行 npm install chatley-cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 chatley,可以用 npx chatley 直接运行。

chatley-cli 支持 TypeScript 吗?

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

chatley-cli 需要什么版本的 Node.js?

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

chatley-cli 可以商用吗?

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

chatley-cli 还在维护吗?

最新版本 0.2.1 发布于 2026/11/03(今天);至今共发布 3 个版本,其中过去 12 个月发布了 3 个;首次发布于 2026/10/29。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。