openclaw with trigger

Author: isshaddad

docs/guides/ai-agents/openclaw-trigger.mdx

@@ -0,0 +1,107 @@
+---
+title: "OpenClaw (ClawdBot) with Trigger.dev"
+sidebarTitle: "OpenClaw"
+icon: "sparkles"
+description: "Run OpenClaw autonomous AI agent workflows as durable, observable tasks using Trigger.dev."
+---
+
+[OpenClaw](https://docs.clawd.bot/) (formerly ClawdBot) is an open-source autonomous AI agent that connects to messaging platforms (WhatsApp, Slack, Discord, etc.), runs shell commands, and can use Claude, GPT, or local models. Combined with Trigger.dev, you get durable execution, retries, and full observability when running OpenClaw workflows from your backend or on a schedule.
+
+## Why use Trigger.dev with OpenClaw?
+
+- **Durable runs** – Agent workflows run as tasks; if something fails, Trigger.dev retries and you keep a full run history.
+- **Trigger from anywhere** – Invoke OpenClaw skills or chat from HTTP, webhooks, cron, or other tasks.
+- **Observability** – Logs, metadata, and run status in the Trigger.dev dashboard.
+
+## Setup
+
+<Note>
+  This guide assumes you have an existing [Trigger.dev](https://trigger.dev) project. Follow our [quickstart](/quick-start) if you don't yet.
+</Note>
+
+<Steps>
+
+<Step title="Run OpenClaw">
+
+OpenClaw typically runs as a local or self-hosted service. Install and run it following the [OpenClaw docs](https://docs.clawd.bot/install). Ensure the API is reachable (e.g. `https://your-openclaw.local:3000` or your deployed URL).
+
+</Step>
+
+<Step title="Create a task that calls the OpenClaw API">
+
+Use Trigger.dev tasks to call OpenClaw's HTTP API (e.g. execute a skill or send a chat). This gives you retries, logging, and triggers from schedules or webhooks:
+
+```ts trigger/openclaw-agent.ts
+import { task } from "@trigger.dev/sdk";
+
+const OPENCLAW_BASE_URL = process.env.OPENCLAW_BASE_URL!; // e.g. https://your-openclaw.local:3000
+const OPENCLAW_API_KEY = process.env.OPENCLAW_API_KEY!;
+
+export const runOpenClawSkill = task({
+  id: "run-openclaw-skill",
+  run: async (payload: { skill: string; params?: Record<string, unknown> }) => {
+    const res = await fetch(`${OPENCLAW_BASE_URL}/api/v1/skills/${payload.skill}/execute`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${OPENCLAW_API_KEY}`,
+      },
+      body: JSON.stringify(payload.params ?? {}),
+    });
+
+    if (!res.ok) {
+      throw new Error(`OpenClaw skill failed: ${res.status} ${await res.text()}`);
+    }
+
+    return res.json();
+  },
+});
+```
+
+</Step>
+
+<Step title="Add environment variables">
+
+In the [Trigger.dev dashboard](https://cloud.trigger.dev) (or your `.env` for local dev), set:
+
+- `OPENCLAW_BASE_URL` – Your OpenClaw instance URL (e.g. `https://your-openclaw.local:3000`).
+- `OPENCLAW_API_KEY` – Your OpenClaw API key (see [OpenClaw authentication](https://docs.clawd.bot/gateway/authentication)).
+
+</Step>
+
+<Step title="Trigger the task">
+
+From your app, on a schedule, or from a webhook:
+
+```ts
+import { runOpenClawSkill } from "@/trigger/openclaw-agent";
+
+await runOpenClawSkill.trigger({ skill: "my-skill", params: { input: "hello" } });
+```
+
+</Step>
+
+</Steps>
+
+## OpenClaw API overview
+
+OpenClaw exposes REST endpoints you can call from Trigger.dev tasks:
+
+| Endpoint | Description |
+| -------- | ----------- |
+| `POST /api/v1/skills/{skill}/execute` | Execute a skill |
+| `POST /api/v1/assistant/chat` | Send a message to the assistant |
+| `GET /api/v1/skills` | List available skills |
+| `GET /api/v1/status` | Check status |
+
+See the [OpenClaw API docs](https://getclawdbot.org/docs/api) (or [OpenClaw gateway docs](https://docs.clawd.bot/gateway/openresponses-http-api)) for request/response formats and authentication.
+
+## Building skills with the SDK
+
+To build custom skills that OpenClaw can run, use the `@clawdbot/sdk` (or OpenClaw skills SDK). You can run skill logic inside a Trigger task as well—for example, call external APIs or write to your DB from a task that implements the same behavior as a skill.
+
+## Learn more
+
+- [OpenClaw docs](https://docs.clawd.bot/) – Installation, Node.js, and gateway APIs
+- [Trigger.dev Realtime](/realtime/overview) – Stream task progress to your frontend
+- [Scheduled tasks](/tasks/scheduled) – Run OpenClaw workflows on a cron schedule