Quickstart

If you are operating an agent system, the fastest way to get started is not to wire every setting first. Start by running npx xenodia@latest init in the agent environment so Xenodia can confirm the wallet setup and decide whether to reuse an existing wallet or create one for the agent.

npx xenodia@latest init

You do not have to install npx first

There are two practical ways to connect Xenodia. You can simply provide the SKILL instructions to your Agent and let it follow that skill-based path; this is valid and does not require the npx package up front. If you do run npx xenodia@latest init in the agent environment, the overall setup usually becomes smoother because Xenodia can handle wallet confirmation, initialization, and related runtime setup for you.

In short: Skill-only is supported, npx makes the experience smoother, but npx is not a mandatory prerequisite.

Prerequisites

Before you begin, ensure you meet the following baseline requirements:
1. An Agent Platform: This could be an open-source project like OpenClaw, or a proprietary system orchestrated by your developers.
2. A Xenodia Account with Available Funds: Skip the hassle of registering and binding credit cards across dozens of platforms. Open an account once, and grab your "master key" (API Key).

💡 PRO TIP: You do not need to force every payment through the owner. An agent can hold its own wallet and pay independently through x402, or follow the owner-controlled billing mode you configure.

Two Operating Modes, choose the one that fits your needs

Option 1: Agent Autopilot (For Deep AI Exploration Scenarios)

This is the purest AI Agent working mode, where you entrust capabilities and decisions straight over to the AI:

• Agent perspective: Run npx xenodia@latest init. Let the environment confirm the wallet capability and simultaneously provision Xenodia skills. From there, your agent can instantly answer basic natural queries like "Show me available models" without further boilerplate.
• Owner perspective: Bind that agent wallet in the console, define billing behavior and channel boundaries, and let the agent route work automatically and securely.

Option 2: Human Owner Controlled Setup (For Commercial Compliance & Budget Control)

If you feel that the AI "autopilot" is too unpredictable and you want to precisely dictate every cent and permission, this option is designed for you:

• Set the boundaries yourself: As the owner, you still begin with npx xenodia@latest init to establish wallet context, then issue a static API Key from the console or CLI and inject it into your agent runtime.
• Strict whitelisting: In the [Channel Rules] backend, you can explicitly limit it to use only certain whitelisted large models, and manually subscribe it to specific exclusive Skills.
• Absolute safety guarantees: Monitored and governed by you, the Agent cannot step out of the compute and skill bounds you designated. Costs and permissions remain entirely within your control.

Summary / Tip:
For new operators, the fastest path is still npx xenodia@latest init. Establish wallet identity first, then bind, issue the key, and define billing policy.