ebb-ai

ebb-ai — Carbon-aware scheduling

This skill connects OpenClaw to a local @ebb-ai/mcp server that schedules AI tasks to run during the cleanest available electricity-grid window inside a user-supplied deadline.

When to invoke

Use this skill when the user wants to:

1. Defer a non-urgent AI task to run later for environmental or cost reasons. Examples:
   • "Summarize these 50 articles by tomorrow morning, run it overnight."
   • "Don't do it now — wait for when the grid is clean."
   • "Schedule the GitHub digest for 3 AM."
2. Inspect grid carbon intensity before deciding whether to run a task. Examples:
   • "Is now a good time to run an expensive batch?"
   • "When will the California grid be cleanest in the next 12 hours?"
3. Audit the carbon cost of recent agent activity. Examples:
   • "How much CO₂ did my agents use today?"
   • "Show me the carbon receipt for that last summary."

Do not invoke this skill for:

• Tasks the user wants done immediately.
• Tasks where the user has no preference about timing.
• General climate / energy questions unrelated to AI compute.

Prerequisites

The @ebb-ai/mcp server must be registered as an MCP server in OpenClaw. See scripts/install.sh for a one-shot installer that does this. Manual install:

1. Build the server:

   cd /path/to/ebb-ai && pnpm install && pnpm build
   

2. Add to ~/.openclaw/mcp.json:

   {
     "mcpServers": {
       "ebb-ai": {
         "command": "node",
         "args": ["/abs/path/to/ebb-ai/packages/mcp-server/dist/server.js"],
         "env": {
           "EBB_ELECTRICITY_MAPS_API_KEY": "optional",
           "EBB_DEFAULT_REGION": "US-CAL-CISO"
         }
       }
     }
   }
   

3. Restart OpenClaw.

Tools available

Once the MCP server is connected, three tools become callable:

get_grid_forecast(region, hours?)

Returns hourly carbon intensity for the next 1-72 hours. Use this to answer "when is the cleanest window?" questions.