README.md

OpenClaw: General Purpose Agentic Template

This is a serverless-ready template for OpenClaw, an autonomous agent capable of planning, coding, and executing tasks in a sandboxed or remote environment.

Key Features

• Autonomous Reasoning: Uses Groq's high-speed models (like gpt-oss-120b) for planning.
• Dynamic Skill Installation: The agent can use npm install or pip install via shell to acquire new capabilities on the fly.
• Code Execution: Designed to generate and run scripts locally.
• Tool-Calling: Includes a generalized execute_shell tool for interaction with the hosting environment.

Deployment

1. Vercel: Connect this repo, set GROQ_API_KEY, and deploy.
2. Security Note: This agent is designed to run in a sandboxed environment. It executes shell commands with the permissions of the user starting the process. Ensure it is hosted in an isolated container or VM if used for high-risk tasks.

API Endpoints

POST /api/agent

The main autonomous entry point.

Payload:

{
  "message": "Research vulnerable ports on 192.168.1.1 and generate a PDF report.",
  "history": []
}

Example Tasks

• "Install the 'yt-dlp' library and download a video."
• "Write a python script to scrape this website, summarize it, and save it as a text file."
• "Generate a FFmpeg script to create a video from these images."