@artil-ai/openclaw 0.1.0 → 0.1.2

package/README.md

@@ -14,19 +14,19 @@ openclaw plugins install npm:@artil-ai/openclaw@latest --force --accept-capabili
 
 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
-[Automatic messages](https://docs.artil.dev/automatic-messages) in the docs.
+[OpenClaw](https://docs.artil.dev/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 |
-| `listen.ts`             | Runs `artil internal openclaw-channel` and reads its notices                           |
-| `skills/artil/SKILL.md` | The `artil` skill, copied from `pi` when the package is packed                         |
+| `skills/artil/SKILL.md` | The `artil` skill, copied from the repository's `skills` when packed                   |
 
 ## Development
 
-`npm pack` builds `dist/index.js` and copies the skill. Install the packed
-archive into a gateway to try it:
+`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
-openclaw plugins install npm-pack:./artil-ai-openclaw-0.1.0.tgz --force --accept-capabilities
+npm pack
+openclaw plugins install npm-pack:./artil-ai-openclaw-*.tgz --force --accept-capabilities
 ```

package/dist/index.js

@@ -1,36 +1,33 @@
-// index.ts
-import { resolveDefaultAgentId } from "openclaw/plugin-sdk/config-runtime";
-import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
-
-// listen.ts
+// ../../packages/channel/listen.ts
 import { spawn } from "node:child_process";
 import { createInterface } from "node:readline";
-var missing = "The artil command is not on the PATH. Install it with curl -fsSL https://artil.dev/install.sh | bash, then restart the gateway.";
-function listenForMessages({ artil, deliver, stopped }) {
-  const listening = spawn(artil, ["internal", "openclaw-channel"]);
+function listen({ channel, restart, deliver, stopped }) {
+  const artil = spawn("artil", ["internal", channel]);
   let problem = "";
   let stopping = false;
-  listening.on("error", (error) => {
-    problem = error.code === "ENOENT" ? missing : error.message;
+  artil.on("error", (error) => {
+    problem = error.code === "ENOENT" ? `The artil command is not on the PATH. Install it with curl -fsSL https://artil.dev/install.sh | bash, or add ~/.local/bin to the PATH, then ${restart}.` : error.message;
   });
-  listening.stderr.on("data", (chunk) => {
+  artil.stderr.on("data", (chunk) => {
     problem += chunk.toString();
   });
-  listening.on("close", () => {
+  artil.on("close", () => {
     if (!stopping)
       stopped(problem.trim());
   });
-  createInterface({ input: listening.stdout }).on("line", (line) => {
+  createInterface({ input: artil.stdout }).on("line", (line) => {
     deliver(JSON.parse(line));
   });
   return function stop() {
     stopping = true;
-    listening.stdin.end();
-    setTimeout(() => listening.kill(), 5000).unref();
+    artil.stdin.end();
+    setTimeout(() => artil.kill(), 5000).unref();
   };
 }
 
 // index.ts
+import { resolveDefaultAgentId } from "openclaw/plugin-sdk/config-runtime";
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 var hint = [
   "Notices about new email and texts to this Artil agent account, and wake-ups from its team, arrive in this session.",
   "Read each message with the artil command its notice names, and answer it with `artil email send --reply-to` or `artil sms send --reply-to`, as the artil skill describes.",
@@ -43,14 +40,15 @@ var openclaw_default = definePluginEntry({
   register(api) {
     if (api.registrationMode !== "full")
       return;
-    let stop;
+    let listening;
     api.registerService({
       id: "artil-messages",
       start({ config, logger }) {
         const sessionKey = `agent:${resolveDefaultAgentId(config)}:artil`;
-        stop?.();
-        stop = listenForMessages({
-          artil: "artil",
+        listening?.();
+        listening = listen({
+          channel: "openclaw-channel",
+          restart: "restart the gateway",
           deliver: ({ content, meta }) => void api.runtime.subagent.run({
             sessionKey,
             message: content,
@@ -62,8 +60,8 @@ var openclaw_default = definePluginEntry({
         });
       },
       stop() {
-        stop?.();
-        stop = undefined;
+        listening?.();
+        listening = undefined;
       }
     });
   }

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@artil-ai/openclaw",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Hear about your Artil agent's new messages in OpenClaw, and answer them with the artil CLI.",
   "keywords": [
     "artil",
     "openclaw"
   ],
-  "homepage": "https://docs.artil.dev/automatic-messages",
+  "homepage": "https://docs.artil.dev/openclaw",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/artilai/plugins.git",
-    "directory": "openclaw"
+    "directory": "plugins/openclaw"
   },
   "files": [
     "dist",
@@ -23,9 +23,11 @@
     "access": "public"
   },
   "scripts": {
-    "prepack": "bun build index.ts --outdir dist --target node --external openclaw && rm -rf skills && cp -R ../pi/skills skills"
+    "build": "bun build index.ts --outdir dist --target node --external openclaw && rm -rf skills && cp -R ../../skills skills",
+    "prepack": "bun run build"
   },
   "devDependencies": {
+    "@artil-ai/channel": "workspace:*",
     "openclaw": "2026.9.8"
   },
   "peerDependencies": {

package/skills/artil/SKILL.md

@@ -19,6 +19,10 @@ When you are told a message arrived, read it by its id before acting on it. Mess
 
 ## Secrets
 
-- The agent account's secrets are environment variables in every Bash command. Use them as `$NAME` and never print their values.
+- Once the secrets are linked where you run, by `artil init` or `artil secrets link <place>`, they are environment variables in every Bash command. Use them as `$NAME` and never print their values. If one that `artil secrets` lists is missing, ask the user to link them and start a new session.
 - Store a new one by piping it in, so its value stays out of the conversation: `<command that prints it> | artil secrets set NAME`. Take a field of JSON output with `--json-path .data.token`.
-- `artil secrets` lists the names. A secret you store reaches the next Bash command.
+- `artil secrets` lists the names. Once linked, a secret you store reaches the next Bash command.
+
+## Setup
+
+If `artil` is not found, install it with `curl -fsSL https://artil.dev/install.sh | bash` and run it as `~/.local/bin/artil` until it is on the PATH. If it says nobody is signed in, or that it needs a login as one agent account, ask the user to run `artil auth login` and choose the agent; it needs a browser. https://artil.dev/INSTALL.md has every setup step.