openclaw-node-harness 2.0.0

package/skills/tavily-search/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: tavily
+description: "AI-optimized web search via Tavily API. Use when the user needs to search the web, research a topic, find current news, or extract content from a URL."
+triggers:
+  - "search the web for"
+  - "look up online"
+  - "find recent news about"
+  - "research this topic"
+  - "what's the latest on"
+negative_triggers:
+  - "search this codebase"
+  - "find this file"
+  - "grep for"
+  - "summarize this URL"
+homepage: https://tavily.com
+metadata: {"clawdbot":{"emoji":"🔍","requires":{"bins":["node"],"env":["TAVILY_API_KEY"]},"primaryEnv":"TAVILY_API_KEY"}}
+---
+
+# Tavily Search
+
+AI-optimized web search using Tavily API. Designed for AI agents - returns clean, relevant content.
+
+## Search
+
+```bash
+node {baseDir}/scripts/search.mjs "query"
+node {baseDir}/scripts/search.mjs "query" -n 10
+node {baseDir}/scripts/search.mjs "query" --deep
+node {baseDir}/scripts/search.mjs "query" --topic news
+```
+
+## Options
+
+- `-n <count>`: Number of results (default: 5, max: 20)
+- `--deep`: Use advanced search for deeper research (slower, more comprehensive)
+- `--topic <topic>`: Search topic - `general` (default) or `news`
+- `--days <n>`: For news topic, limit to last n days
+
+## Extract content from URL
+
+```bash
+node {baseDir}/scripts/extract.mjs "https://example.com/article"
+```
+
+Notes:
+- Needs `TAVILY_API_KEY` from https://tavily.com
+- Tavily is optimized for AI - returns clean, relevant snippets
+- Use `--deep` for complex research questions
+- Use `--topic news` for current events

package/skills/tavily-search/scripts/extract.mjs

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+
+function usage() {
+  console.error(`Usage: extract.mjs "url1" ["url2" ...]`);
+  process.exit(2);
+}
+
+const args = process.argv.slice(2);
+if (args.length === 0 || args[0] === "-h" || args[0] === "--help") usage();
+
+const urls = args.filter(a => !a.startsWith("-"));
+
+if (urls.length === 0) {
+  console.error("No URLs provided");
+  usage();
+}
+
+const apiKey = (process.env.TAVILY_API_KEY ?? "").trim();
+if (!apiKey) {
+  console.error("Missing TAVILY_API_KEY");
+  process.exit(1);
+}
+
+const resp = await fetch("https://api.tavily.com/extract", {
+  method: "POST",
+  headers: {
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    api_key: apiKey,
+    urls: urls,
+  }),
+});
+
+if (!resp.ok) {
+  const text = await resp.text().catch(() => "");
+  throw new Error(`Tavily Extract failed (${resp.status}): ${text}`);
+}
+
+const data = await resp.json();
+
+const results = data.results ?? [];
+const failed = data.failed_results ?? [];
+
+for (const r of results) {
+  const url = String(r?.url ?? "").trim();
+  const content = String(r?.raw_content ?? "").trim();
+  
+  console.log(`# ${url}\n`);
+  console.log(content || "(no content extracted)");
+  console.log("\n---\n");
+}
+
+if (failed.length > 0) {
+  console.log("## Failed URLs\n");
+  for (const f of failed) {
+    console.log(`- ${f.url}: ${f.error}`);
+  }
+}

package/skills/tavily-search/scripts/search.mjs

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+
+function usage() {
+  console.error(`Usage: search.mjs "query" [-n 5] [--deep] [--topic general|news] [--days 7]`);
+  process.exit(2);
+}
+
+const args = process.argv.slice(2);
+if (args.length === 0 || args[0] === "-h" || args[0] === "--help") usage();
+
+const query = args[0];
+let n = 5;
+let searchDepth = "basic";
+let topic = "general";
+let days = null;
+
+for (let i = 1; i < args.length; i++) {
+  const a = args[i];
+  if (a === "-n") {
+    n = Number.parseInt(args[i + 1] ?? "5", 10);
+    i++;
+    continue;
+  }
+  if (a === "--deep") {
+    searchDepth = "advanced";
+    continue;
+  }
+  if (a === "--topic") {
+    topic = args[i + 1] ?? "general";
+    i++;
+    continue;
+  }
+  if (a === "--days") {
+    days = Number.parseInt(args[i + 1] ?? "7", 10);
+    i++;
+    continue;
+  }
+  console.error(`Unknown arg: ${a}`);
+  usage();
+}
+
+const apiKey = (process.env.TAVILY_API_KEY ?? "").trim();
+if (!apiKey) {
+  console.error("Missing TAVILY_API_KEY");
+  process.exit(1);
+}
+
+const body = {
+  api_key: apiKey,
+  query: query,
+  search_depth: searchDepth,
+  topic: topic,
+  max_results: Math.max(1, Math.min(n, 20)),
+  include_answer: true,
+  include_raw_content: false,
+};
+
+if (topic === "news" && days) {
+  body.days = days;
+}
+
+const resp = await fetch("https://api.tavily.com/search", {
+  method: "POST",
+  headers: {
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify(body),
+});
+
+if (!resp.ok) {
+  const text = await resp.text().catch(() => "");
+  throw new Error(`Tavily Search failed (${resp.status}): ${text}`);
+}
+
+const data = await resp.json();
+
+// Print AI-generated answer if available
+if (data.answer) {
+  console.log("## Answer\n");
+  console.log(data.answer);
+  console.log("\n---\n");
+}
+
+// Print results
+const results = (data.results ?? []).slice(0, n);
+console.log("## Sources\n");
+
+for (const r of results) {
+  const title = String(r?.title ?? "").trim();
+  const url = String(r?.url ?? "").trim();
+  const content = String(r?.content ?? "").trim();
+  const score = r?.score ? ` (relevance: ${(r.score * 100).toFixed(0)}%)` : "";
+  
+  if (!title || !url) continue;
+  console.log(`- **${title}**${score}`);
+  console.log(`  ${url}`);
+  if (content) {
+    console.log(`  ${content.slice(0, 300)}${content.length > 300 ? "..." : ""}`);
+  }
+  console.log();
+}

package/skills/twitter/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: twitter
+description: "Posts tweets, deletes tweets, reads public tweets, and looks up users on X/Twitter via the v2 API. Use when the user wants to tweet, read a tweet, check a Twitter profile, or manage X posts."
+triggers:
+  - "post a tweet"
+  - "tweet this"
+  - "check this twitter user"
+  - "read this tweet"
+  - "delete my tweet"
+negative_triggers:
+  - "search twitter"
+  - "like a tweet"
+  - "retweet this"
+  - "follow this account"
+metadata:
+  openclaw:
+    version: "1.0.0"
+    author: "Daedalus"
+    license: "MIT"
+    tags: ["twitter", "x", "social", "posting"]
+    category: "social"
+  clawdbot:
+    emoji: "🐦"
+    requires:
+      bins: ["curl", "openssl", "jq"]
+    primaryEnv: "TWITTER_API_KEY"
+---
+
+# Twitter / X
+
+Post tweets and look up users via the X API v2 Free tier.
+
+## Capabilities
+
+- **Post** tweets (17/day, 500/month) — requires API keys
+- **Delete** own tweets — requires API keys
+- **Look up** users (100 reads/month) — requires API keys
+- **Read** any public tweet by ID or URL — no auth needed (syndication)
+- **Timeline** read recent tweets from any public user — no auth needed (syndication)
+- **Cannot** search, like, retweet, or follow on free tier
+
+## Environment Variables
+
+```bash
+export TWITTER_API_KEY="..."
+export TWITTER_API_SECRET="..."
+export TWITTER_ACCESS_TOKEN="..."
+export TWITTER_ACCESS_TOKEN_SECRET="..."
+```
+
+Get these from developer.x.com → Dashboard → App → Keys and Tokens.
+
+## Workflow
+
+1. Verify credentials are set: `scripts/twitter.sh whoami`
+2. Execute the requested action via the appropriate subcommand.
+3. Return the JSON response to the user with relevant fields extracted.
+4. On rate limit errors (429), report the reset time — do not retry.
+
+## Scripts
+
+Auth required (set env vars):
+- `scripts/twitter.sh whoami` — Verify credentials, show authenticated user info.
+- `scripts/twitter.sh post "<text>"` — Post a tweet. Returns tweet ID on success.
+- `scripts/twitter.sh delete <tweet_id>` — Delete a tweet by ID.
+- `scripts/twitter.sh lookup <username>` — Look up a user by handle (no @).
+
+No auth needed (public syndication):
+- `scripts/twitter.sh read <tweet_id_or_url>` — Read any public tweet. Accepts tweet ID or full URL.
+- `scripts/twitter.sh timeline <username> [count]` — Read last N tweets from a user (default 5).
+
+## References
+
+- Use `references/validation-cases.md` for expected behaviors and edge cases.

package/skills/twitter/_meta.json

@@ -0,0 +1,9 @@
+{
+  "owner": "daedalus",
+  "slug": "twitter",
+  "displayName": "Twitter",
+  "latest": {
+    "version": "1.0.0",
+    "publishedAt": 1771305600000
+  }
+}

package/skills/twitter/references/validation-cases.md

@@ -0,0 +1,53 @@
+# Twitter Skill — Validation Cases
+
+## 1. Env check (no creds)
+
+**Trigger:** Run any command without env vars set
+**Expected:** Error listing missing variables + link to developer.x.com
+**Pass criteria:** Non-zero exit, clear message
+
+## 2. whoami
+
+**Trigger:** `twitter.sh whoami`
+**Expected:** JSON with id, name, username, followers, following, tweets
+**Pass criteria:** Valid JSON, non-empty username field
+
+## 3. Post tweet
+
+**Trigger:** `twitter.sh post "Hello from Daedalus"`
+**Expected:** JSON with id and text, plus URL to stderr
+**Pass criteria:** id is numeric string, text matches input
+
+## 4. Post too long
+
+**Trigger:** `twitter.sh post "<281+ chars>"`
+**Expected:** Error about character limit
+**Pass criteria:** Non-zero exit, no API call made
+
+## 5. Delete tweet
+
+**Trigger:** `twitter.sh delete <valid_id>`
+**Expected:** Confirmation message
+**Pass criteria:** "Deleted tweet" in output
+
+## 6. Lookup user
+
+**Trigger:** `twitter.sh lookup elonmusk`
+**Expected:** JSON with user info (name, bio, followers, etc.)
+**Pass criteria:** Valid JSON, username matches input
+
+## 7. Lookup with @ prefix
+
+**Trigger:** `twitter.sh lookup @elonmusk`
+**Expected:** Same as above (@ stripped automatically)
+
+## 8. Rate limit handling
+
+**Trigger:** Exceed 17 posts/day
+**Expected:** HTTP 429 error with reset time
+**Pass criteria:** Error surfaced clearly, no retry loop
+
+## 9. Help
+
+**Trigger:** `twitter.sh help` or `twitter.sh --help` or `twitter.sh`
+**Expected:** Usage information