feat: add openclaw_deploy tool for server-side deploy scripts (v1.1.2)

Closes #8

- New tool: openclaw_deploy { service, action: deploy|rollback|status }
- Runs deploy-{service}.sh or rollback-{service}.sh on OpenClaw server via SSH
- Status action tails ~/deploy/logs/{service}.log (last 30 lines)
- New config: OPENCLAW_DEPLOY_SCRIPT_DIR (default: ~/deploy)
- 2 unit tests added (53 total)

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>

Author: homeofe

.env.example

@@ -33,6 +33,12 @@ OPENCLAW_GATEWAY_URL=http://localhost:18789
 # -------------------------
 # OPENCLAW_DEFAULT_AGENT=ops
 
+# -------------------------
+# OpenClaw deploy scripts (optional)
+# Directory on the OpenClaw server containing deploy-{service}.sh scripts.
+# -------------------------
+# OPENCLAW_DEPLOY_SCRIPT_DIR=~/deploy
+
 # -------------------------
 # Gemini CLI (optional)
 # Requires: npm install -g @google/gemini-cli && gemini auth login

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elvatis_com/elvatis-mcp",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "MCP server for OpenClaw — expose smart home, memory, cron, and more to Claude Desktop, Cursor, Windsurf, and any MCP client",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

src/config.ts

@@ -49,6 +49,9 @@ export interface Config {
   localLlmEndpoint?: string;
   /** Default model identifier for the local LLM (as shown in LM Studio / Ollama) */
   localLlmModel?: string;
+  // --- OpenClaw deploy ---
+  /** Directory of deploy scripts on the OpenClaw server (default: ~/deploy) */
+  deployScriptDir?: string;
   // --- Remote Linux server (general SSH, independent of OpenClaw) ---
   /** Host for remote_shell, remote_docker, remote_service tools */
   remoteHost?: string;
@@ -90,6 +93,8 @@ export function loadConfig(): Config {
     // Local LLM (LM Studio default port: 1234, Ollama: 11434, llama.cpp: 8080)
     localLlmEndpoint: optional('LOCAL_LLM_ENDPOINT'),
     localLlmModel: optional('LOCAL_LLM_MODEL'),
+    // OpenClaw deploy (optional)
+    deployScriptDir: optional('OPENCLAW_DEPLOY_SCRIPT_DIR'),
     // Remote Linux server (optional, for remote_shell/docker/service tools)
     remoteHost: optional('REMOTE_HOST'),
     remotePort: parseInt(process.env['REMOTE_PORT'] ?? '22', 10),

src/index.ts

@@ -128,6 +128,10 @@ import {
   remoteDockerSchema, handleRemoteDocker,
 } from './tools/remote-docker.js';
 
+import {
+  openclawDeploySchema, handleOpenclawDeploy,
+} from './tools/openclaw-deploy.js';
+
 import {
   remoteServiceSchema, handleRemoteService,
 } from './tools/remote-service.js';
@@ -371,6 +375,12 @@ async function main() {
     async (args) => ({ content: [{ type: 'text', text: toText(await handleRemoteShell(args as any, config)) }] })
   );
 
+  registerTool(server, 'openclaw_deploy',
+    'Trigger deploy or rollback scripts on the OpenClaw server, or check the last deploy log. Scripts must exist at OPENCLAW_DEPLOY_SCRIPT_DIR (default: ~/deploy).',
+    openclawDeploySchema.shape,
+    async (args) => ({ content: [{ type: 'text', text: toText(await handleOpenclawDeploy(args as any, config)) }] })
+  );
+
   registerTool(server, 'remote_docker',
     'Manage Docker containers on the remote Linux server via SSH. Actions: list, logs, start, stop, restart, stats, exec. No Docker API or open port needed.',
     remoteDockerSchema.shape,

src/tools/openclaw-deploy.ts

@@ -0,0 +1,54 @@
+/**
+ * openclaw_deploy: trigger deployment scripts on the OpenClaw server via SSH.
+ *
+ * Scripts live in OPENCLAW_DEPLOY_SCRIPT_DIR (default: ~/deploy) and follow
+ * the naming convention: deploy-{service}.sh, rollback-{service}.sh
+ * Status reads the last 30 lines of ~/deploy/logs/{service}.log if it exists.
+ */
+
+import { z } from 'zod';
+import { Config } from '../config.js';
+import { sshExec, SshConfig } from '../ssh.js';
+
+// --- Schema ---
+
+export const openclawDeploySchema = z.object({
+  service: z.string().describe('Service name to deploy, e.g. "api", "worker", "frontend"'),
+  action: z.enum(['deploy', 'rollback', 'status'])
+    .describe('deploy: run deploy script, rollback: run rollback script, status: show last deploy log'),
+});
+
+// --- Handler ---
+
+export async function handleOpenclawDeploy(
+  args: z.infer<typeof openclawDeploySchema>,
+  config: Config,
+): Promise<{ success: boolean; output?: string; error?: string; service: string; action: string }> {
+  const cfg: SshConfig = {
+    host: config.sshHost,
+    port: config.sshPort,
+    username: config.sshUser,
+    keyPath: config.sshKeyPath,
+  };
+
+  const scriptDir = config.deployScriptDir ?? '~/deploy';
+  const { service, action } = args;
+
+  const cmds: Record<string, string> = {
+    deploy:   `bash ${scriptDir}/deploy-${service}.sh 2>&1`,
+    rollback: `bash ${scriptDir}/rollback-${service}.sh 2>&1`,
+    status:   `if [ -f ${scriptDir}/logs/${service}.log ]; then tail -30 ${scriptDir}/logs/${service}.log; else echo "No log found at ${scriptDir}/logs/${service}.log"; fi`,
+  };
+
+  try {
+    const output = await sshExec(cfg, cmds[action]!, 120_000);
+    return { success: true, output: output.trimEnd(), service, action };
+  } catch (err) {
+    return {
+      success: false,
+      error: err instanceof Error ? err.message : String(err),
+      service,
+      action,
+    };
+  }
+}

tests/unit.test.ts

@@ -19,6 +19,7 @@ import {
 import { toRemoteSshCfg } from '../src/tools/remote-shell.js';
 import { handleRemoteDocker } from '../src/tools/remote-docker.js';
 import { handleRemoteService } from '../src/tools/remote-service.js';
+import { handleOpenclawDeploy } from '../src/tools/openclaw-deploy.js';
 import type { Config } from '../src/config.js';
 
 // Minimal config stub for heuristic-only tests (no SSH/HTTP needed)
@@ -491,3 +492,28 @@ describe('remote_service', () => {
     assert.equal(result.action, 'stop');
   });
 });
+
+// ============================================================================
+// openclaw_deploy — argument validation (no SSH needed)
+// ============================================================================
+
+describe('openclaw_deploy', () => {
+  it('reflects service and action in the response on SSH failure', async () => {
+    const result = await handleOpenclawDeploy(
+      { service: 'api', action: 'status' },
+      { ...stubConfig, sshHost: '0.0.0.1' },
+    );
+    assert.equal(result.service, 'api');
+    assert.equal(result.action, 'status');
+    assert.equal(result.success, false);
+  });
+
+  it('uses default deploy script dir when OPENCLAW_DEPLOY_SCRIPT_DIR is not set', async () => {
+    const result = await handleOpenclawDeploy(
+      { service: 'worker', action: 'status' },
+      { ...stubConfig, sshHost: '0.0.0.1', deployScriptDir: undefined },
+    );
+    assert.equal(result.success, false);
+    assert.equal(result.service, 'worker');
+  });
+});