ATXP - 访问 ATXP 付费 API 工具（网页搜索、AI 生成图片/音乐/视频、X/Twitter 搜索、邮件及代理账号管理）

通过 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 支付链接请求资金，付款人在结算页可自行调整金额（$1–$1,000）。

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、已读状态），未读邮件会标记。使用 email read 可获取完整内容并标记已读。

读取邮件

npx atxp email read 

获取指定邮件的完整正文及附件列表，自动标记为已读。messageId 可从 email inbox 输出中获取。

发送邮件

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

必填参数：--to（收件人），--subject（主题），--body（正文）。 如需附件，可使用 MCP 工具 email_send_email 并通过 attachments 参数（Base64 编码）发送。 示例：

npx atxp email send --to user@example.com --subject "Hello" --body "Hi there!"

回复邮件

npx atxp email reply  --body 

自动填充收件人、主题（带 Re: 前缀）以及 threading 头部。费用 $0.01/回复。

搜索邮件

npx atxp email search 

按主题或发件人（不区分大小写）搜索，返回最新匹配的邮件，免费。

删除邮件

npx atxp email delete 

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

下载附件

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

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

支持

随时通过发送邮件至 support@atxp.ai 使用 email send 命令联系 ATXP 支持：

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

LLM 网关

ATXP 账户可用于支付 100+ 模型的 LLM 推理费用。若需集中管理 LLM 开支或使用平台未提供的模型，请使用 ATXP LLM Gateway。

Clowdbot 环境

若运行在 Clowdbot 环境，可通过编辑 /root/.openclaw/openclaw.json 配置文件来修改模型访问权限，请谨慎操作。

PaaS 工具

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

使用步骤

• 确认已设置 $ATXP_CONNECTION
• 运行对应的命令
• 解析并展示结果

编程调用示例

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 技能）