Description

Infrastructure for AI Agents. Phone, email, Social accounts, compute, domains, and voice calling for AI agents. Pay with USDC on Solana or Base via x402.

README (SKILL.md)

AgentOS — Infrastructure for AI Agents\r

Name: Infrastructure for agents
Author: 0xartex

\r Everything an agent needs: phone, email, compute, domains, voice calling, wallets, and 3500+ skills. Pay with USDC on Solana or Base via x402.\r \r CLI: npm i -g @agntos/agentos (or npx @agntos/agentos)\r API: https://agntos.dev\r Source: https://github.com/0xArtex/AgentOS\r \r

CLI (recommended)\r

\r Use the CLI for cleaner context and simpler commands:\r \r

# Phone\r
agentos phone search --country US          # Search numbers (free)\r
agentos phone buy --country US             # Buy a number ($3)\r
agentos phone sms --id ID --to +1... --body "hi"   # Send SMS ($0.05)\r
agentos phone call --id ID --to +1... --tts "hello" # Voice call ($0.10)\r
\r
# Email (E2E encrypted)\r
agentos email create --name agent --wallet SOL_PUBKEY  # Create inbox ($2)\r
agentos email read --id INBOX_ID                       # Read messages ($0.02)\r
agentos email send --id ID --to [email protected] --subject "Hi" --body "..."  # Send ($0.08)\r
agentos email threads --id INBOX_ID                    # List threads ($0.02)\r
\r
# Compute\r
agentos compute plans                            # List VPS plans (free)\r
agentos compute deploy --name my-vps --type cx23 # Deploy VPS (from $8/mo)\r
agentos compute list                             # List servers\r
agentos compute delete --id SERVER_ID            # Delete server\r
\r
# Domains\r
agentos domain check --name example.dev   # Check availability (free)\r
agentos domain pricing --name example     # Get pricing (free)\r
agentos domain buy --name example.dev     # Register domain\r
\r
# Wallet\r
agentos wallet keygen                     # Generate keypair (free)\r
agentos wallet create --agent 0xADDR      # Create smart wallet (free)\r
agentos wallet status 0xWALLET            # Check status (free)\r
\r
# Info\r
agentos pricing    # All service prices\r
agentos health     # API status\r
```\r
\r
## API Quick Reference\r
\r
All endpoints also available as direct HTTP calls. CLI is recommended — less tokens, cleaner output.\r
\r
| Service | Endpoint | Cost (USDC) |\r
|---------|----------|-------------|\r
| **Phone** | | |\r
| Search numbers | `GET /phone/numbers/search?country=US` | Free |\r
| Provision number | `POST /phone/numbers` | 3.00 |\r
| Send SMS | `POST /phone/numbers/:id/send` | 0.05 |\r
| Read messages | `GET /phone/numbers/:id/messages` | 0.02 |\r
| **Voice Calls** | | |\r
| Place call | `POST /phone/numbers/:id/call` | 0.10 |\r
| Speak (TTS) | `POST /phone/calls/:callControlId/speak` | 0.08 |\r
| Play audio | `POST /phone/calls/:callControlId/play` | 0.08 |\r
| Send DTMF | `POST /phone/calls/:callControlId/dtmf` | 0.02 |\r
| Gather input | `POST /phone/calls/:callControlId/gather` | 0.08 |\r
| Record call | `POST /phone/calls/:callControlId/record` | 0.10 |\r
| Hangup | `POST /phone/calls/:callControlId/hangup` | 0.02 |\r
| Answer inbound | `POST /phone/calls/:callControlId/answer` | 0.02 |\r
| Transfer call | `POST /phone/calls/:callControlId/transfer` | 0.10 |\r
| List calls | `GET /phone/numbers/:id/calls` | 0.02 |\r
| Call details | `GET /phone/calls/:id` | 0.02 |\r
| **Email** | | |\r
| Provision inbox | `POST /email/inboxes` | 2.00 |\r
| Read inbox | `GET /email/inboxes/:id/messages` | 0.02 |\r
| Send email | `POST /email/inboxes/:id/send` | 0.08 |\r
| List threads | `GET /email/inboxes/:id/threads` | 0.02 |\r
| Thread messages | `GET /email/threads/:threadId/messages` | 0.02 |\r
| Download attachment | `GET /email/attachments/:id` | 0.02 |\r
| Register webhook | `POST /email/webhooks` | 0.02 |\r
| **Compute** | | |\r
| List plans | `GET /compute/plans` | Free |\r
| Upload SSH key | `POST /compute/ssh-keys` | 0.10 |\r
| Create server | `POST /compute/servers` | 8.00-40.00 |\r
| List servers | `GET /compute/servers` | 0.02 |\r
| Server status | `GET /compute/servers/:id` | 0.02 |\r
| Server action | `POST /compute/servers/:id/actions` | 0.10 |\r
| Resize server | `POST /compute/servers/:id/resize` | 0.10 |\r
| Delete server | `DELETE /compute/servers/:id` | 0.10 |\r
| **Domains** | | |\r
| Check availability | `GET /domains/check?domain=example.com` | Free |\r
| TLD pricing | `GET /domains/pricing?domain=example` | Free |\r
| Register domain | `POST /domains/register` | dynamic (25% markup) |\r
| DNS records | `GET /domains/:domain/dns` | Free |\r
| Update DNS | `POST /domains/:domain/dns` | Free |\r
| Pricing | `GET /pricing` | Free |\r
| **Wallet** | | |\r
| Create wallet | `POST /wallet` | Free |\r
| Wallet status | `GET /wallet/:address` | Free |\r
| Generate keypair | `POST /wallet/keygen` | Free |\r
| Transfer (ERC20) | Via smart contract | Gas only |\r
| **Skills** | | |\r
| Browse catalog | `GET /compute/skills/catalog` | Free |\r
| Security scan | `GET /compute/skills/:slug/security` | Free |\r
\r
All paid endpoints use **x402** — make the request, get a 402, pay with USDC, done.\r
\r
## Authentication\r
\r
**Your wallet is your identity.** No API keys. No signup.\r
\r
Call any endpoint → pay with USDC via x402 → your wallet owns the resource.\r
\r
Same wallet to access it later. That's it.\r
\r
**Networks:** Solana mainnet + Base (EVM)\r
\r
---\r
\r
\r
## API Details\r
\r
The CLI wraps all API endpoints. If you prefer raw HTTP, use the quick reference table above. All endpoints accept JSON and return JSON.\r
\r
For voice calls, email threads, attachments, webhooks, and other advanced features — run `agentos --help` or see the full API docs at `agntos.dev/docs`.\r
\r
### Payment Flow\r
1. Call any paid endpoint → get `402 Payment Required`\r
2. Response includes USDC amount + treasury address (Solana + Base)\r
3. Pay via x402 protocol\r
4. Your wallet address becomes the resource owner\r
\r
### E2E Email Encryption\r
Emails are encrypted with your wallet's public key (NaCl box). We cannot read them.\r
\r
To decrypt, use the helper script in this skill folder:\r
```bash\r
node decrypt-email.mjs "w:..." ~/.config/solana/id.json\r
node decrypt-email.mjs --json '{"subject":"w:...","body":"w:..."}' ~/.config/solana/id.json\r
```\r
\r
## Webhooks\r
\r
Set up webhooks to receive events:\r
- **SMS inbound:** Messages to your number arrive via Telnyx webhook → stored, readable via API\r
- **Voice events:** `call.initiated`, `call.answered`, `call.hangup`, `call.recording.saved`, `call.gather.ended`\r
- **Email inbound:** Emails to `*@agntos.dev` processed via Cloudflare worker → stored encrypted\r

Usage Guidance

This skill appears to do what it says, but exercise caution before installing or running anything that reads your Solana private key. Actions to consider: - Inspect decrypt-email.mjs yourself (you have it) before running it. It reads your keypair JSON and derives a decrypting secret — if you run it, the script will access plaintext private key bytes on disk. - Prefer passing an explicit keypair path rather than relying on the default. Use an ephemeral keypair if possible (create a dedicated key for AgentOS inboxes) rather than your main wallet. - Verify the @agntos/agentos npm package and its GitHub source (postinstall scripts, maintainer identity) before npm i -g or npx. Global npm installs can execute arbitrary code. - Do not paste or upload your private key to external services. Only run local decryptors that you have audited, and avoid running scripts that automatically upload or transmit key material. - If you are uncomfortable exposing a raw keyfile, consider using a hardware wallet or a derived ephemeral keypair solely for email decryption and payments. If you'd like, I can: (a) walk through decrypt-email.mjs line-by-line and explain exactly what it does, (b) suggest a safer ephemeral-key workflow, or (c) draft a checklist to vet the @agntos/agentos npm package before installation.

Capability Analysis

Type: OpenClaw Skill Name: agents-infra Version: 1.0.1 The skill provides infrastructure for AI agents (phone, email, VPS) and uses a cryptocurrency wallet for identity and payments. The 'decrypt-email.mjs' script directly accesses the user's Solana private key file (~/.config/solana/id.json) to derive an X25519 secret for E2E decryption. While the provided code performs decryption locally and lacks explicit exfiltration logic, the pattern of requiring an AI agent to handle raw private keys for automated financial transactions and data decryption is a high-risk security practice. The skill's functionality relies heavily on an external CLI (@agntos/agentos) and API (agntos.dev), which are not provided for review but would have full access to the user's wallet and decrypted communications.

Capability Assessment

ℹ Purpose & Capability

The skill advertises phone, email, compute, domains, wallets and a CLI/API. The included decrypt-email.mjs reads a Solana keypair and decrypts NaCl boxes — this matches the SKILL.md claim that inboxes are E2E encrypted to your wallet. No unrelated credentials or services are requested.

⚠ Instruction Scope

SKILL.md instructs running the CLI and the local decrypt-email.mjs helper which reads your Solana private key file (~/.config/solana/id.json by default) to derive an X25519 secret and decrypt messages. Reading the user's private key is necessary for decryption but is highly sensitive; users should be aware the script accesses local private key material and will prompt you to install tweetnacl if missing.

ℹ Install Mechanism

There is no formal install spec in the skill bundle. The README suggests installing @agntos/agentos via npm (or using npx). Installing an npm package runs arbitrary code (postinstall scripts) from the package owner — this is expected for a CLI but requires trust in the package source. The included decrypt-email.mjs has no hidden downloads; it tries to import tweetnacl and exits with an install hint if missing.

⚠ Credentials

The skill does not declare environment variables but the helper script implicitly reads HOME and the Solana keypair file path (~/.config/solana/id.json) from disk. Access to the Solana private key is proportionate to decrypting E2E emails, but is extremely sensitive — the skill asks to read your private key without formal declared env/permission metadata.

✓ Persistence & Privilege

The skill is instruction-only with no install spec that would persist code beyond the included files. always is false and it does not request permanent platform privileges or modify other skills/config. Autonomous invocation is allowed by default but not an added privilege here.

Version History

v1.0.1

- Added decrypt-email.mjs script for decrypting encrypted AgentOS emails with your wallet key. - Updated docs with new CLI commands for phone, email, compute, domain, and wallet management. - API pricing and endpoints revised for better transparency and updated service costs. - Added support and documentation for email threads, attachments, and webhooks. - All email is now end-to-end encrypted; documented how to decrypt using the new script. - Authentication clarified: no API keys needed—pay with your wallet to own resources on Solana or Base.

v1.0.0

Initial release of agents-infra: AI agent infrastructure with phone, email, compute, domains, and voice calling, paid with USDC over Solana or Base. - Provides endpoints to register AI agents, provision phone numbers, send SMS, make voice calls, and manage calls (TTS, audio, DTMF, record, transfer). - Supports email inbox provisioning, sending/receiving email. - Offers compute server management (create, resize, delete) with on-chain payments. - Includes domain registration and DNS management. - All paid endpoints use the x402 protocol for USDC payments—no user registration required. - Supports authentication either via agent token or x402 payment header.

Metadata

Slug agents-infra

Version 1.0.1

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 2

Frequently Asked Questions

What is Infrastructure for agents?

Infrastructure for AI Agents. Phone, email, Social accounts, compute, domains, and voice calling for AI agents. Pay with USDC on Solana or Base via x402. It is an AI Agent Skill for Claude Code / OpenClaw, with 348 downloads so far.

How do I install Infrastructure for agents?

Run "/install agents-infra" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Infrastructure for agents free?

Yes, Infrastructure for agents is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Infrastructure for agents support?

Infrastructure for agents is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Infrastructure for agents?

It is built and maintained by 0xArtex (@0xartex); the current version is v1.0.1.

More Skills

Infrastructure for agents