Troubleshooting

Fix common CLI, wallet, and provisioning issues.

Common issues

CLI doesn’t work

• Ensure Node.js >= 18.

• Try:

npx clawcloud@latest

Telegram bot not responding

• Verify username: @clawcloud_devbot.

• Ensure agent id format: agent_....

VM stuck provisioning

• 2–3 minutes is normal.

• Check balance:

npx clawcloud balance

• Check status:

npx clawcloud status <nft-id>

Can’t SSH

• VM must be ACTIVE.

• Verify IP from status.

• Verify key permissions:

chmod 600 key.pem

Transaction failed

• Ensure enough USDC.

• Ensure some ETH on Base for gas.

• Confirm you’re on Base.

Error codes

Add error codes here once the CLI/API stabilizes.