ATXP - 通过 CLI 访问 ATXP 付费 API（网页搜索、AI 生成媒体、邮件、代理账号等）

通过 CLI 访问 ATXP 的付费 API 工具。

认证

# 检查是否已认证
 echo $ATXP_CONNECTION
# 如未设置，登录：
 npx atxp login
 source ~/.atxp/config

命令列表

命令	描述
npx atxp search	实时网页搜索
npx atxp image	AI 图像生成
npx atxp music	AI 音乐生成
npx atxp video	AI 视频生成
npx atxp x	X/Twitter 搜索
npx atxp email inbox	检查邮件收件箱（免费）
npx atxp email read	读取指定邮件（免费）
npx atxp email send	发送邮件（$0.01/邮件）
npx atxp email reply --body	回复邮件（$0.01/回复）
npx atxp email search	按主题或发件人搜索邮件（免费）
npx atxp email delete	删除邮件（免费）
npx atxp email get-attachment	下载附件（免费）
npx atxp email claim-username	认领邮箱用户名（$1.00）
npx atxp email release-username	释放用户名（免费）
npx atxp balance	查询 ATXP 账户余额（免费）
npx atxp fund	查看资金充值方式（免费）
npx atxp whoami	显示账户信息（ID、类型、邮箱、钱包） （免费）
npx atxp topup	创建 Stripe 支付链接为代理充值（免费）
npx atxp topup --amount	指定金额创建支付链接（免费）
npx atxp agent create	创建新代理账号（需人工登录）
npx atxp agent list	列出你的代理（需人工登录）
npx atxp agent register	自助注册代理（无需登录）

余额查询

npx atxp balance

资金充值

通过 USDC 存入地址（每条链一个，常见为 Base 与 Solana）或在 https://accounts.atxp.ai/fund 使用信用卡等标准支付方式为账户充值。

npx atxp fund

账户信息

npx atxp whoami

代理账号

代理是拥有独立钱包、邮箱和余额的自治账户。

创建代理（需人工登录）

npx atxp login
npx atxp agent create

自助注册代理（无需登录）

npx atxp agent register

列出代理

npx atxp agent list

为代理充值（Stripe 支付链接）

npx atxp topup                    # 默认建议 $10
npx atxp topup --amount 100       # 建议 $100
npx atxp topup --amount 25 --open # 创建链接并在浏览器打开

代理登录

创建或注册代理后，可使用其连接字符串登录：

npx atxp login --token ""
source ~/.atxp/config

邮件功能

每位 ATXP 用户拥有唯一邮箱 {user_id}@atxp.email，可付费认领可读的用户名（$1.00），形如 {username}@atxp.email，认领后收件箱、发送、读取等操作自动使用该地址。邮件发送至任一地址都将进入同一收件箱。

最佳实践：每天至少检查一次 ATXP 收件箱，免费检查并可收到重要通知、支持回复以及本技能的更新信息。

认领用户名

npx atxp email claim-username 

用户名要求 3‑32 字符，以字母开头，仅包含小写字母、数字、连字符和下划线。每账号仅限一个用户名，可后续更改，费用 $1.00。

释放用户名

npx atxp email release-username

释放后邮箱恢复为 {user_id}@atxp.email，免费。

检查收件箱

npx atxp email inbox

返回邮件元数据（发件人、主题、日期、messageId、已读状态），未读邮件会标记。

读取邮件

npx atxp email read 

获取完整内容及附件列表，并将邮件标记为已读。

发送邮件

npx atxp email send --to  --subject  --body 

参数说明：

• --to 接收方邮箱（必填）
• --subject 邮件主题（必填）
• --body 邮件正文（必填）

附件可通过 MCP 工具 email_send_email 的 attachments 参数（Base64 编码）发送。

回复邮件

npx atxp email reply  --body 

自动填充收件人、主题（前缀 Re:）和线程头信息，费用 $0.01/次。

搜索邮件

npx atxp email search 

按主题或发件人模糊匹配（ILIKE），返回最新匹配邮件，免费。

删除邮件

npx atxp email delete 

软删除，邮件将不再出现在收件箱或搜索结果中，免费。

下载附件

npx atxp email get-attachment --message  --index 

先使用 email read 查看附件列表及索引，再下载。返回 Base64 内容，免费。

支持

通过邮件发送至 support@atxp.ai 与 ATXP 支持团队联系，例如：

npx atxp email send --to support@atxp.ai --subject "Help request" --body "Your question here"

LLM 网关

ATXP 账户可用于支付 100 多个模型的推理费用，帮助统一 LLM 开支或访问平时不可用的模型。

Clowdbot 环境

若在 Clowdbot 环境运行，可通过编辑 /root/.openclaw/openclaw.json 调整模型访问配置，请谨慎操作。

PaaS 工具

使用 paas.mcp.atxp.ai 部署无服务器应用，包括函数、数据库、对象存储、自定义域名和分析功能。详细使用请参阅 atxp-paas 技能。

使用流程

• 确认环境变量 $ATXP_CONNECTION 已设置。
• 运行对应的 npx atxp 命令。
• 解析并展示结果。

编程调用示例

import { atxpClient, ATXPAccount } from '@atxp/client';
const client = await atxpClient({
  mcpServer: 'https://search.mcp.atxp.ai',
  account: new ATXPAccount(process.env.ATXP_CONNECTION),
});
const result = await client.callTool({
  name: 'search_search',
  arguments: { query: 'your query' },
});

MCP 服务器映射表

Server	Tools
search.mcp.atxp.ai	search_search
image.mcp.atxp.ai	image_create_image
music.mcp.atxp.ai	music_create
video.mcp.atxp.ai	create_video
x-live-search.mcp.atxp.ai	x_live_search
email.mcp.atxp.ai	email_check_inbox, email_get_message, email_send_email, email_reply, email_search, email_delete, email_get_attachment, email_claim_username, email_release_username
paas.mcp.atxp.ai	PaaS 工具（参见 atxp-paas 技能）