Initial public release

.env.example

@@ -0,0 +1 @@
+OBSIDIAN_BIN=obsidian

.gitignore

@@ -0,0 +1,6 @@
+.env
+.env.*
+!.env.example
+node_modules/
+npm-debug.log*
+*.log

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Patrick
+
+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.

README.md

@@ -0,0 +1,17 @@
+# OpenClaw Obsidian Bridge
+
+Minimal OpenClaw plugin extension that exposes Obsidian status/open helpers through gateway methods and an authenticated HTTP route.
+
+## Methods
+
+- `obsidian.bridge.status`
+- `obsidian.bridge.open`
+- `POST /hooks/obsidian-bridge`
+
+## Local Check
+
+```bash
+npm test
+```
+
+The example assumes an `obsidian` helper binary is available. Adapt `index.mjs` for your own host path or wrapper.

SECURITY.md

@@ -0,0 +1,3 @@
+# Security
+
+Do not expose this bridge without OpenClaw plugin authentication. Vault paths and file names can be sensitive; avoid logging request bodies in public deployments.

index.mjs

@@ -0,0 +1,67 @@
+import { definePluginEntry } from 'openclaw/plugin-sdk/plugin-entry';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+
+const execFileAsync = promisify(execFile);
+
+async function run(command, args = []) {
+  const { stdout, stderr } = await execFileAsync(command, args, { encoding: 'utf8' });
+  return { stdout, stderr };
+}
+
+async function obsidianStatus() {
+  const { stdout } = await run(process.env.OBSIDIAN_BIN || 'obsidian', ['status']);
+  return JSON.parse(stdout);
+}
+
+async function obsidianOpen(vaultPath) {
+  const args = ['open'];
+  if (vaultPath) args.push(`path=${vaultPath}`);
+  const { stdout } = await run(process.env.OBSIDIAN_BIN || 'obsidian', args);
+  return stdout ? JSON.parse(stdout) : { launched: true };
+}
+
+export default definePluginEntry({
+  id: 'obsidian-bridge',
+  name: 'Obsidian Bridge',
+  description: 'Minimal OpenClaw-owned Obsidian bridge for Paperclip and local callers.',
+  register(api) {
+    api.registerGatewayMethod('obsidian.bridge.status', async ({ respond }) => {
+      try {
+        respond({ ok: true, status: await obsidianStatus() });
+      } catch (error) {
+        respond({ ok: false, error: String(error?.message || error) });
+      }
+    });
+    api.registerGatewayMethod('obsidian.bridge.open', async ({ params, respond }) => {
+      try {
+        respond({ ok: true, result: await obsidianOpen(params?.path || null) });
+      } catch (error) {
+        respond({ ok: false, error: String(error?.message || error) });
+      }
+    });
+    api.registerHttpRoute({
+      path: '/hooks/obsidian-bridge',
+      auth: 'plugin',
+      match: 'exact',
+      replaceExisting: true,
+      async handler(req, res) {
+        try {
+          const body = req.body && typeof req.body === 'object' ? req.body : {};
+          const action = body.action || 'status';
+          if (action === 'status') {
+            res.status(200).json({ ok: true, status: await obsidianStatus() });
+            return;
+          }
+          if (action === 'open') {
+            res.status(200).json({ ok: true, result: await obsidianOpen(body.path || null) });
+            return;
+          }
+          res.status(400).json({ ok: false, error: 'unsupported action' });
+        } catch (error) {
+          res.status(500).json({ ok: false, error: String(error?.message || error) });
+        }
+      }
+    });
+  }
+});

openclaw.plugin.json

@@ -0,0 +1,10 @@
+{
+  "id": "obsidian-bridge",
+  "name": "Obsidian Bridge",
+  "description": "Minimal OpenClaw-owned Obsidian bridge for Paperclip and local callers.",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package.json

@@ -0,0 +1,15 @@
+{
+  "name": "obsidian-bridge",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Minimal OpenClaw-owned Obsidian bridge for Paperclip and local callers.",
+  "private": false,
+  "scripts": {
+    "test": "node --check index.mjs"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.mjs"
+    ]
+  }
+}