CLI 与 Skills
npx 安装
使用 Xenodia CLI 完成钱包认证、Skill 安装、模型发现、余额查询、聊天与明确充值。
当你需要 agent-friendly setup flow，而不是只看 raw HTTP integration 时，使用 CLI。
npx xenodia@latest init当前 CLI 支持：
- 本地密钥或托管钱包签名。
- 在检测到的 Agent 目录安装 Xenodia Skills。
- 模型列表、余额查询和直接聊天。
- 获取一小时 access token 与长期 API key。
- 明确发起 x402-compatible 充值。
钱包设置
init 显示可用设置路径并安装 Skills。只有确实需要新身份时才使用 init --local 创建本地 Agent 钱包；它不会把钱包绑定到主账户，也不会创建 API key。
| Wallet path | Environment |
|---|---|
| Existing local key | Local development 或 controlled server runtime。 |
| Managed wallet credentials | 使用 CLI 支持的托管签名器的 Agent 或 server runtime。 |
Local-key development 推荐使用 scoped env file，不要提交 private key：
XENODIA_API_KEY=...
EVM_PRIVATE_KEY=...
# 或明确指向受保护的已有密钥文件：
XENODIA_KEY_FILE=/absolute/path/to/agent.keyCDP-backed setup：
CDP_API_KEY_ID=...
CDP_API_KEY_SECRET=...
CDP_WALLET_SECRET=...
# 可选：CDP_WALLET_NAME=...Local mode：
npx xenodia@latest init --localCommon commands
| Command | Purpose |
|---|---|
npx xenodia@latest init | 显示钱包设置说明，并安装检测到的 Skill 集成。 |
npx xenodia@latest init --local | 仅在需要新身份时创建本地 Agent 钱包。 |
npx xenodia@latest models | 列出可用 model IDs 和 public capabilities。 |
npx xenodia@latest chat gpt-6-astra "Hello" | 使用当前模型 ID 发送文本请求。 |
npx xenodia@latest balance | 查询已绑定 Agent 账户的 Credits 余额。 |
npx xenodia@latest get-token | 输出一小时 access token；请私密接收。 |
npx xenodia@latest get-api-key | 获取或创建已绑定 Agent 账户的长期 API key；请私密接收。 |
npx xenodia@latest topup --amount 5 | 使用当前钱包明确发起 5 USDC compatible 充值。 |
除普通 init 外，其他命令会签署钱包登录挑战。钱包必须已经绑定到 Xenodia 账户。虽然原始 GET /v1/models 是公开接口，CLI 的 models 命令仍会先认证。
When to use it
本地开发、agent runtime setup、operator workflow 使用 npx xenodia。
构建 backend service、product integration 或 custom SDK 时，优先使用 raw HTTP docs。
Package source
npm package 包含设置命令和轻量 Skills。当前 API reference 和模型专属行为以 https://docs.xenodia.xyz 为准。