openclaw-http-test 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rui
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# openclaw-http
+
+OpenClaw plugin that manages an Express HTTP server lifecycle and exposes tools to agents.
+
+## Install
+
+```bash
+npm install openclaw-http
+```
+
+## Features
+
+- Manages an Express HTTP server as an OpenClaw service (auto start/stop with Gateway)
+- Registers agent tools (e.g., `get_weather_demo`)
+- Exposes Gateway RPC method `express-backend.status`
+
+## Usage
+
+Load as an OpenClaw plugin. The Gateway will call `start()` on boot and `stop()` on shutdown.
+
+### Files
+
+| File | Description |
+|------|-------------|
+| `index.mjs` | Plugin entry point, registers service and tools |
+| `server.cjs` | Express HTTP server (port 8999) |
+| `openclaw.plugin.json` | Plugin metadata |
+
+### Registered Tools
+
+- **`get_weather_demo`** - Demo tool that returns mock weather data for a given city
+
+### Quick Test
+
+```bash
+# After Gateway starts the service
+curl http://127.0.0.1:8999/api/runtimes
+```
+
+## License
+
+MIT

package/index.mjs

@@ -0,0 +1,90 @@
+/*
+ * @Author: wr_st 584490439@qq.com
+ * @Date: 2026-03-21 20:59:03
+ * @LastEditors: wr_st 584490439@qq.com
+ * @LastEditTime: 2026-03-23 16:37:10
+ * @FilePath: /openclaw-http/index.mjs
+ * @Description: 这是默认设置,请设置`customMade`, 打开koroFileHeader查看配置 进行设置: https://github.com/OBKoro1/koro1FileHeader/wiki/%E9%85%8D%E7%BD%AE
+ */
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+let child = null;
+
+export default function (api) {
+	api.registerService({
+		id: 'my-backend-service',
+		start: async (ctx) => {
+			if (child) return;
+
+			const serverPath = join(__dirname, 'server.cjs');
+			child = spawn('node', [serverPath], {
+				stdio: ['ignore', 'pipe', 'pipe'],
+			});
+
+			child.stdout.on('data', (data) => {
+				ctx.logger.info(data.toString().trimEnd());
+			});
+			child.stderr.on('data', (data) => {
+				ctx.logger.error(data.toString().trimEnd());
+			});
+			child.on('close', (code) => {
+				ctx.logger.info(`[my-backend-service] server.js exited with code ${code}`);
+				child = null;
+			});
+		},
+		stop: async (ctx) => {
+			if (!child) return;
+
+			const proc = child;
+			child = null;
+
+			proc.kill('SIGTERM');
+			await new Promise((resolve) => proc.on('close', resolve));
+			ctx.logger.info('[my-backend-service] server.js stopped');
+		},
+	});
+
+	// Optional: a small status RPC to confirm the service is up.
+	api.registerGatewayMethod('express-backend.status', async () => ({
+		status: 'ok',
+		pid: process.pid,
+	}));
+	api.registerTool({
+		name: 'get_weather',
+		description: '获取某个城市的演示天气数据',
+		parameters: {
+			type: 'object',
+			additionalProperties: false,
+			properties: {
+				city: {
+					type: 'string',
+					description: '城市名，比如 Shanghai',
+				},
+			},
+			required: ['city'],
+		},
+		async execute(_id, params) {
+			const city = params.city?.trim() || 'Unknown';
+
+			const result = {
+				city,
+				weather: 'sunny',
+				tempC: 26,
+				source: 'demo',
+			};
+
+			return {
+				content: [
+					{
+						type: 'text',
+						text: JSON.stringify(result, null, 2),
+					},
+				],
+			};
+		},
+	});
+}

package/openclaw.plugin.json

@@ -0,0 +1,11 @@
+{
+  "id": "openclaw-http-test",
+  "name": "OpenClaw HTTP Test",
+  "description": "Expose a local ChromeAgent/Relay Tool API to OpenClaw as agent tools.",
+  "version": "0.1.0",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "openclaw-http-test",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "index.mjs",
+  "description": "OpenClaw plugin - Manage an Express HTTP server lifecycle and expose tools to agents",
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "http",
+    "express",
+    "agent-tools"
+  ],
+  "license": "MIT",
+  "author": "rui <584490439@qq.com>",
+  "files": [
+    "index.mjs",
+    "server.cjs",
+    "openclaw.plugin.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "node ./dev/standalone.js"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.mjs"
+    ]
+  },
+  "dependencies": {
+    "express": "^4.18.2"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/server.cjs

@@ -0,0 +1,39 @@
+/*
+ * @Author: wr_st 584490439@qq.com
+ * @Date: 2026-03-21 21:08:15
+ * @LastEditors: wr_st 584490439@qq.com
+ * @LastEditTime: 2026-03-23 16:40:10
+ * @FilePath: /openclaw-http/server.cjs
+ * @Description: 这是默认设置,请设置`customMade`, 打开koroFileHeader查看配置 进行设置: https://github.com/OBKoro1/koro1FileHeader/wiki/%E9%85%8D%E7%BD%AE
+ */
+/*
+ * Local demo HTTP server for the openclaw-http plugin.
+ */
+const express = require('express');
+const { createServer } = require('http');
+
+const app = express();
+const server = createServer(app);
+const PORT = 8899;
+
+app.use((req, res, next) => {
+	res.header('Access-Control-Allow-Origin', '*');
+	res.header('Access-Control-Allow-Methods', 'GET,POST,PUT,PATCH,DELETE,OPTIONS');
+	res.header('Access-Control-Allow-Headers', 'Content-Type, Authorization');
+
+	if (req.method === 'OPTIONS') {
+		return res.sendStatus(204);
+	}
+
+	next();
+});
+
+app.use(express.json());
+
+app.get('/api/runtimes', (_req, res) => {
+	res.json({ success: true, runtimes: 'ok' });
+});
+
+server.listen(PORT, () => {
+	console.log(`[Relay] Server running on http://localhost:${PORT}`);
+});