Tools
Render
Render CLI plugin for OpenClaw
Configuration Example
{
"id": "srv_123456",
"name": "my-web-app",
"type": "web_service",
"env": "node",
"repo": "username/repository",
"branch": "main",
"plan": "starter",
"status": "live",
"url": "https://my-web-app.onrender.com"
}
README
# Render CLI
A comprehensive TypeScript CLI tool for managing Render.com services via their REST API.
## Features
### Service Management
✅ **List Services** - View all services with optional filtering by type and pagination
✅ **Service Details** - Get comprehensive information about specific services
✅ **Create Services** - Deploy new web services, static sites, background workers, and cron jobs
✅ **Update Services** - Modify service configuration including name, branch, and plan
✅ **Delete Services** - Permanently remove services
✅ **Suspend/Resume** - Temporarily stop services without deletion
### Deployment Control
✅ **List Deployments** - View deployment history with pagination
✅ **Trigger Deployments** - Manually initiate new deployments
✅ **Deployment Details** - Get detailed status and information for specific deployments
### Environment Variables
✅ **List Variables** - View all environment variables for a service
✅ **Add/Update Variables** - Set individual environment variables
✅ **Remove Variables** - Delete specific environment variables
✅ **Bulk Import** - Import multiple variables from .env files
### Custom Domains
✅ **List Domains** - View all custom domains for a service
✅ **Add Domains** - Configure custom domains for your services
✅ **Remove Domains** - Delete custom domain configurations
✅ **Verify Domains** - Verify domain ownership and DNS configuration
### PostgreSQL Databases
✅ **List Databases** - View all PostgreSQL instances
✅ **Database Details** - Get connection info and configuration details
✅ **Create Databases** - Provision new PostgreSQL databases
✅ **Delete Databases** - Remove database instances
### Logging & Monitoring
✅ **Service Logs** - Retrieve service logs with optional tail functionality
### Scaling & Performance
✅ **Manual Scaling** - Set specific instance counts for services
✅ **Autoscaling** - Configure automatic scaling with min/max bounds
### Account & Infrastructure
✅ **Owner Information** - Get current account and user details
✅ **Available Regions** - List all deployment regions
✅ **Service Plans** - Reference guide for available plans and pricing
## Supported Service Types
- **Web Services** - Full-stack applications with HTTP endpoints
- **Static Sites** - Frontend applications served from CDN
- **Private Services** - Internal services without public endpoints
- **Background Workers** - Long-running background processes
- **Cron Jobs** - Scheduled tasks and periodic jobs
## Supported Environments
- **Docker** - Container-based deployments
- **Node.js** - JavaScript/TypeScript applications
- **Python** - Python applications with automatic environment detection
- **Go** - Go applications with native compilation
- **Rust** - Rust applications with cargo support
## Service Plans
### Web Services & Workers
- **Free** - 750 hours/month, shared resources
- **Starter** - $7/month, 0.5 CPU, 512MB RAM
- **Standard** - $25/month, 1 CPU, 2GB RAM
- **Pro** - $85/month, 2 CPU, 4GB RAM
### PostgreSQL Databases
- **Free** - 1GB storage, shared resources
- **Starter** - $7/month, 10GB storage
- **Standard** - $20/month, 100GB storage
- **Pro** - $90/month, 500GB storage
## Deployment Regions
- **Oregon** (US West)
- **Frankfurt** (Europe)
- **Ohio** (US East)
- **Singapore** (Asia Pacific)
## Output Format
All commands output structured JSON to stdout, making integration with other tools seamless:
```json
{
"id": "srv_123456",
"name": "my-web-app",
"type": "web_service",
"env": "node",
"repo": "username/repository",
"branch": "main",
"plan": "starter",
"status": "live",
"url": "https://my-web-app.onrender.com"
}
```
## CLI Design Principles
- **JSON Output** - All responses in machine-readable JSON format
- **Error Handling** - Proper exit codes and stderr for errors
- **Consistent Interface** - Predictable command structure and arguments
- **Comprehensive Coverage** - Support for all major Render API endpoints
- **Secure Authentication** - Environment variable based API key management
## Use Cases
- **Automated Deployments** - Integrate with CI/CD pipelines
- **Infrastructure as Code** - Script service provisioning and configuration
- **Monitoring & Alerting** - Check service status and deployment progress
- **Multi-Environment Management** - Manage development, staging, and production services
- **Bulk Operations** - Efficiently manage multiple services and configurations
## Dependencies
- **axios** - HTTP client for API requests
- **dotenv** - Environment variable management
- **tsx** - TypeScript execution runtime
- **TypeScript** - Type-safe JavaScript development
## Compatibility
- **Node.js** 18.0.0 or higher
- **TypeScript** 5.3.3 or higher
- **Linux, macOS, Windows** - Cross-platform compatibility
tools
Comments
Sign in to leave a comment