# chatley-cli 中文文档

规范地址：https://npmcn.com/package/chatley-cli/

版本：0\.2\.1
npm 元数据更新时间：2026-11-03T07:22:41.029Z
中文译文更新时间：2026-11-03T07:36:39.922Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/chatley-cli
原文对照：https://npmcn.com/package/chatley-cli/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：47.1 kB，9 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.17
- 运行依赖：3 个
- 首次发布：2026-10-28T17:46:49.513Z
- 最新版本发布：2026-11-03T07:22:40.884Z
- 已发布版本数：3（近 12 个月 3 个）

## 中文简介

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

## 安装

```sh
npm install chatley-cli
```

也可以使用：`pnpm add chatley-cli`、`yarn add chatley-cli`、`bun add chatley-cli`

## README

# chatley-cli

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

```bash
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

```json
{ "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_BASE` | API基础，默认 `https://app.chatley.ai/api`． HTTPS。 |
| `CHATLEY_CONFIG_DIR` | 配置文件所在的位置(默认 `~/.config/chatley`， `%APPDATA%\chatley` 在Windows上);该文件是唯一的所有者 |

协议参考: [https://www.chatley.ai/skill.md](https://www.chatley.ai/skill.md)

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

## 常见问题

### 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 和提交记录判断。