@artil-ai/openclaw 0.1.13 → 0.2.0

package/README.md

@@ -1,36 +1,10 @@
-# @artil-ai/openclaw
+# Artil for OpenClaw
 
-The Artil plugin for [OpenClaw](https://openclaw.ai). The gateway hears about
-each new message to the agent account, including ones its team sends to its
-Message URL, from where it left off, and starts a turn in the agent's `artil`
-session for each one. The
-agent answers with the `artil` CLI, as the `artil` skill teaches; nothing it
-writes in that session is sent anywhere.
-
-## Usage
+Install the plugin, which brings the Artil CLI, then sign in as your agent:
 
 ```sh
-openclaw plugins install clawhub:@artil-ai/openclaw --accept-capabilities
+openclaw plugins install npm:@artil-ai/openclaw
+openclaw artil auth login
 ```
 
-`artil plugin install openclaw` installs the same plugin from npm instead, with
-`openclaw plugins install npm:@artil-ai/openclaw@latest --force --accept-capabilities`.
-
-The gateway runs `artil internal openclaw-channel`, so `artil` must be on its
-PATH, which includes `~/.local/bin`, and signed in as the agent. See
-[OpenClaw](https://docs.artil.ai/openclaw) in the docs.
-
-| Entry point             | What it does                                                                           |
-| ----------------------- | -------------------------------------------------------------------------------------- |
-| `index.ts`              | Starts a turn in the `agent:<id>:artil` session for each notice, delivering no replies |
-| `skills/artil/SKILL.md` | The `artil` skill, copied from the repository's `skills` when packed                   |
-
-## Development
-
-`bun run build` bundles `dist/index.js` and copies the skill, and `npm pack`
-runs it. Install the packed archive into a gateway to try it:
-
-```sh
-npm pack
-openclaw plugins install npm-pack:./artil-ai-openclaw-*.tgz --force --accept-capabilities
-```
+Read more in the [Artil docs](https://docs.artil.ai/openclaw).

package/dist/index.js

@@ -1,3 +1,6 @@
+// index.ts
+import { spawn as spawn2 } from "node:child_process";
+
 // ../../packages/channel/listen.ts
 import { spawn } from "node:child_process";
 import { createInterface } from "node:readline";
@@ -25,6 +28,23 @@ function listen({ channel, restart, deliver, stopped }) {
   };
 }
 
+// ../../packages/channel/bundled-artil.ts
+import { createRequire } from "node:module";
+import { delimiter, dirname } from "node:path";
+function bundledArtil(pluginUrl) {
+  try {
+    return dirname(createRequire(pluginUrl).resolve("artil-ai/package.json"));
+  } catch {
+    return;
+  }
+}
+function addBundledArtil(pluginUrl) {
+  const artil = bundledArtil(pluginUrl);
+  const path = process.env.PATH?.split(delimiter) ?? [];
+  if (artil && !path.includes(artil))
+    process.env.PATH = [...path, artil].join(delimiter);
+}
+
 // index.ts
 import { resolveDefaultAgentId } from "openclaw/plugin-sdk/agent-scope-runtime";
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
@@ -34,36 +54,76 @@ var hint = [
   "Answer only through artil, never with OpenClaw's own Telegram or other channels, which are other accounts.",
   "Nobody outside reads what you write in this session."
 ].join(" ");
+var retryAfter = 30000;
+var artilCommand = {
+  name: "artil",
+  description: "Run the artil command the Artil plugin brings, like: openclaw artil auth login",
+  hasSubcommands: false
+};
+function runArtil(args) {
+  const { promise, resolve } = Promise.withResolvers();
+  addBundledArtil(import.meta.url);
+  const artil = spawn2("artil", args, { stdio: "inherit" });
+  artil.on("error", (error) => {
+    console.error(error.message);
+    process.exitCode = 1;
+    resolve();
+  });
+  artil.on("close", (code) => {
+    process.exitCode = code ?? 1;
+    resolve();
+  });
+  return promise;
+}
 var openclaw_default = definePluginEntry({
   id: "artil",
   name: "Artil",
   description: "Email, SMS and Telegram for OpenClaw. Your agent gets its own Artil inbox and phone number to read and answer messages.",
   register(api) {
+    if (["cli-metadata", "discovery", "full"].includes(api.registrationMode)) {
+      api.registerCli(({ program }) => {
+        program.command(artilCommand.name).description(artilCommand.description).argument("[args...]").allowUnknownOption().helpOption(false).action(runArtil);
+      }, { descriptors: [artilCommand] });
+    }
     if (api.registrationMode !== "full")
       return;
     let listening;
+    let retrying;
+    function stopListening() {
+      clearTimeout(retrying);
+      listening?.();
+      listening = undefined;
+    }
+    addBundledArtil(import.meta.url);
     api.registerService({
       id: "artil-messages",
       start({ config, logger }) {
         const sessionKey = `agent:${resolveDefaultAgentId(config)}:artil`;
-        listening?.();
-        listening = listen({
-          channel: "openclaw-channel",
-          restart: "restart the gateway",
-          deliver: ({ content, meta }) => void api.runtime.subagent.run({
-            sessionKey,
-            message: content,
-            extraSystemPrompt: hint,
-            deliver: false,
-            ...meta && { idempotencyKey: meta.message_id }
-          }).catch((error) => logger.error(`Could not hand OpenClaw a notice: ${error}`)),
-          stopped: (problem) => logger.error(`OpenClaw no longer hears about new messages. ${problem}`)
-        });
+        let reported = "";
+        function hear() {
+          listening = listen({
+            channel: "openclaw-channel",
+            restart: "restart the gateway",
+            deliver: ({ content, meta }) => void api.runtime.subagent.run({
+              sessionKey,
+              message: content,
+              extraSystemPrompt: hint,
+              deliver: false,
+              ...meta && { idempotencyKey: meta.message_id }
+            }).catch((error) => logger.error(`Could not hand OpenClaw a notice: ${error}`)),
+            stopped: (problem) => {
+              if (problem !== reported) {
+                logger.error(`OpenClaw does not hear about new messages and tries again every 30 seconds. ${problem}`);
+              }
+              reported = problem;
+              retrying = setTimeout(hear, retryAfter);
+            }
+          });
+        }
+        stopListening();
+        hear();
       },
-      stop() {
-        listening?.();
-        listening = undefined;
-      }
+      stop: stopListening
     });
   }
 });

package/openclaw.plugin.json

@@ -5,5 +5,12 @@
   "categories": ["channels"],
   "activation": { "onStartup": true },
   "skills": ["./skills"],
-  "configSchema": { "type": "object", "additionalProperties": false, "properties": {} }
+  "configSchema": { "type": "object", "additionalProperties": false, "properties": {} },
+  "cliCommands": [
+    {
+      "name": "artil",
+      "description": "Run the artil command the Artil plugin brings, like: openclaw artil auth login",
+      "hasSubcommands": false
+    }
+  ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artil-ai/openclaw",
-  "version": "0.1.13",
+  "version": "0.2.0",
   "description": "Email, SMS and Telegram for OpenClaw. Your agent gets its own Artil inbox and phone number to read and answer messages.",
   "keywords": [
     "ai-agents",
@@ -35,6 +35,9 @@
     "build": "bun build index.ts --outdir dist --target node --external openclaw && rm -rf skills && cp -R ../../skills skills",
     "prepack": "bun run build"
   },
+  "dependencies": {
+    "artil-ai": "0.23.1"
+  },
   "devDependencies": {
     "@artil-ai/channel": "workspace:*",
     "openclaw": "2026.9.8"