@artflo-ai/artflo-openclaw-plugin 0.0.3 → 0.0.5

package/README.md

@@ -72,6 +72,7 @@ are auto-detected or fetched from the Artflo API at startup.
 - `artflo_canvas_wait_for_completion` — Wait for node completion
 - `artflo_canvas_execute_plan` — Execute a structured workflow plan
 - `artflo_canvas_create` — Create a new canvas
+- `artflo_canvas_get_last` — Get last used canvas id
 - `artflo_canvas_list_models` — List available models with pricing
 - `artflo_upload_file` — Upload files to Artflo storage
 - `artflo_set_api_key` — Save API Key to config (used in chat onboarding)

package/dist/index.js

@@ -36,7 +36,7 @@ const plugin = {
             console.log(`[artflo] API Key not configured. Skipping initialization.`);
             const sessions = createSessionRegistryService(config);
             api.registerService(sessions.service);
-            registerArtfloTools(api, { config, sessions: sessions.registry });
+            registerArtfloTools(api, { config, workspaceDir: api.rootDir, sessions: sessions.registry });
             return;
         }
         // ── 自动获取 appKey / vipAppId / vipGroup ─────────────────────────
@@ -66,8 +66,23 @@ const plugin = {
         api.registerService(sessions.service);
         registerArtfloTools(api, {
             config,
+            workspaceDir: api.rootDir,
             sessions: sessions.registry,
         });
+        // ── 每次 prompt 构建时注入 Artflo 配置状态 ──────────────────────
+        api.on('before_prompt_build', () => {
+            const masked = config.apiKey
+                ? `****${config.apiKey.slice(-4)}`
+                : '未配置';
+            return {
+                appendSystemContext: [
+                    `[Artflo Plugin] env=${config.env}, apiKey=${masked}`,
+                    config.apiKey
+                        ? 'API Key 已配置，可直接使用画布功能。'
+                        : 'API Key 未配置，请引导用户通过 artflo_set_api_key 设置。',
+                ].join(' | '),
+            };
+        });
     },
 };
 export default plugin;

package/dist/src/constants.js

@@ -29,6 +29,7 @@ export const ARTFLO_TOOL_NAMES = {
     waitForCompletion: 'artflo_canvas_wait_for_completion',
     executePlan: 'artflo_canvas_execute_plan',
     createCanvas: 'artflo_canvas_create',
+    getLastCanvas: 'artflo_canvas_get_last',
     listModels: 'artflo_canvas_list_models',
     uploadFile: 'artflo_upload_file',
     setApiKey: 'artflo_set_api_key',

package/dist/src/core/api/api-base.js

@@ -1,12 +1,2 @@
-/** HTTP API base URL (trailing slash stripped). */
-export function getApiBaseUrl(config) {
-    return config.apiBaseUrl.replace(/\/+$/, '');
-}
-/**
- * Derive the WebSocket URL from apiBaseUrl.
- *   https://webapi.artflo.ai → wss://webapi.artflo.ai/canvas/ws
- */
-export function getCanvasWsUrl(config) {
-    const hostname = new URL(config.apiBaseUrl).hostname;
-    return `wss://${hostname}/canvas/ws`;
-}
+// Re-export from api-paths for backward compatibility
+export { buildApiUrl, buildWsUrl, buildVipUrl, buildWebUrl } from './api-paths.js';

package/dist/src/core/api/api-paths.js

@@ -0,0 +1,31 @@
+/**
+ * All Artflo API paths in one place.
+ * Every HTTP/WS request in this plugin MUST use a path from here.
+ * Do NOT construct API URLs manually elsewhere.
+ */
+/** WebSocket */
+export const WS_CANVAS = '/canvas/ws';
+/** apiBaseUrl paths */
+export const API_CREATE_CANVAS = '/canvas';
+export const API_UPLOAD_FILE = '/storage/obs/starii';
+/** vipApiBaseUrl paths */
+export const API_VIP_INFO = '/h5/user/vip_info_by_group.json';
+/** webApiBaseUrl paths */
+export const API_CLIENT_PARAMS = '/api/subscribe-client-params';
+// ── Helper builders ─────────────────────────────────────────────────
+function strip(url) {
+    return url.replace(/\/+$/, '');
+}
+export function buildApiUrl(config, path) {
+    return `${strip(config.apiBaseUrl)}${path}`;
+}
+export function buildVipUrl(config, path) {
+    return `${strip(config.vipApiBaseUrl)}${path}`;
+}
+export function buildWebUrl(config, path) {
+    return `${strip(config.webApiBaseUrl)}${path}`;
+}
+export function buildWsUrl(config) {
+    const hostname = new URL(config.apiBaseUrl).hostname;
+    return `wss://${hostname}${WS_CANVAS}`;
+}

package/dist/src/core/api/upload-file.js

@@ -7,7 +7,7 @@
  */
 import { readFile } from 'node:fs/promises';
 import { basename } from 'node:path';
-import { getApiBaseUrl } from './api-base.js';
+import { buildApiUrl, API_UPLOAD_FILE } from '../api/api-paths.js';
 /**
  * Upload a local file or a remote URL to Artflo OBS.
  *
@@ -37,8 +37,7 @@ export async function uploadFile(config, source, filename) {
     }
     const formData = new FormData();
     formData.append('file', fileBlob, resolvedFilename);
-    const baseUrl = getApiBaseUrl(config);
-    const response = await fetch(`${baseUrl}/storage/obs/starii`, {
+    const response = await fetch(buildApiUrl(config, API_UPLOAD_FILE), {
         method: 'POST',
         headers: {
             'X-API-Key': config.apiKey,

package/dist/src/core/canvas/canvas-websocket-client.js

@@ -1,6 +1,6 @@
 import { EventEmitter } from 'node:events';
 import WebSocket from 'ws';
-import { getCanvasWsUrl } from '../api/api-base.js';
+import { buildWsUrl } from '../api/api-paths.js';
 import { writeWsTrace } from './ws-trace.js';
 import { WS_ERROR, isJoinErrorMessage, isJoinSuccessMessage, isPushErrorMessage, isPushSuccessMessage, isSyncPushMessage, } from './types.js';
 export class CanvasWebSocketClient extends EventEmitter {
@@ -33,7 +33,7 @@ export class CanvasWebSocketClient extends EventEmitter {
         queryParams.set('country_code', params.countryCode || this.config.countryCode);
         queryParams.set('api_key', params.apiKey || this.config.apiKey);
         queryParams.set('canvas_id', params.canvasId);
-        return `${getCanvasWsUrl(this.config)}?${queryParams.toString()}`;
+        return `${buildWsUrl(this.config)}?${queryParams.toString()}`;
     }
     async connect(params) {
         if (this.connected) {

package/dist/src/core/canvas/create-canvas.js

@@ -1,14 +1,9 @@
 /**
  * Create a new Artflo canvas via the REST API.
- *
- * Derives the HTTP API base URL from the configured WebSocket URL:
- *   wss://prewebapi.artflo.ai/canvas/ws → https://prewebapi.artflo.ai
- *   wss://webapi.artflo.ai/canvas/ws    → https://webapi.artflo.ai
  */
-import { getApiBaseUrl } from '../api/api-base.js';
+import { buildApiUrl, buildWebUrl, API_CREATE_CANVAS } from '../api/api-paths.js';
 export async function createCanvas(config, name = 'Untitled') {
-    const baseUrl = getApiBaseUrl(config);
-    const response = await fetch(`${baseUrl}/canvas`, {
+    const response = await fetch(buildApiUrl(config, API_CREATE_CANVAS), {
         method: 'POST',
         headers: {
             'Content-Type': 'application/json',
@@ -24,14 +19,9 @@ export async function createCanvas(config, name = 'Untitled') {
         throw new Error(`Create canvas failed: code=${body.code}`);
     }
     const canvasId = body.data.id;
-    // Derive project URL from API host: prewebapi → pre.artflo.ai, webapi → artflo.ai
-    const hostname = new URL(baseUrl).hostname;
-    const projectHost = hostname.startsWith('prewebapi')
-        ? 'pre.artflo.ai'
-        : 'artflo.ai';
     return {
         id: canvasId,
         name: body.data.name ?? name,
-        url: `https://${projectHost}/project/${canvasId}`,
+        url: `${buildWebUrl(config, '/project/' + canvasId)}`,
     };
 }

package/dist/src/core/config/fetch-client-params.js

@@ -2,8 +2,9 @@
  * Fetch appKey, vipAppId, vipGroup from the subscribe-client-params API.
  * GET {webApiBaseUrl}/api/subscribe-client-params
  */
+import { API_CLIENT_PARAMS } from '../api/api-paths.js';
 export async function fetchClientParams(webApiBaseUrl) {
-    const url = `${webApiBaseUrl.replace(/\/+$/, '')}/api/subscribe-client-params`;
+    const url = `${webApiBaseUrl.replace(/\/+$/, '')}${API_CLIENT_PARAMS}`;
     const response = await fetch(url);
     if (!response.ok) {
         throw new Error(`fetchClientParams failed: HTTP ${response.status}`);

package/dist/src/core/config/fetch-vip-info.js

@@ -1,8 +1,9 @@
 /**
  * Fetch user VIP / subscription status from the Artflo subscription API.
  */
+import { buildVipUrl, API_VIP_INFO } from '../api/api-paths.js';
 export async function fetchVipInfo(config) {
-    const url = new URL(`${config.vipApiBaseUrl}/h5/user/vip_info_by_group.json`);
+    const url = new URL(buildVipUrl(config, API_VIP_INFO));
     url.searchParams.set('app_id', config.vipAppId);
     url.searchParams.set('vip_group', config.vipGroup);
     const response = await fetch(url.toString(), {

package/dist/src/services/manifest-service.js

@@ -0,0 +1,37 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+const ARTFLO_DIR = '.artflo';
+const MANIFEST_FILE = 'manifest.json';
+function getManifestPath(workspaceDir) {
+    return path.join(workspaceDir, ARTFLO_DIR, MANIFEST_FILE);
+}
+async function ensureArtfloDir(workspaceDir) {
+    const artfloDir = path.join(workspaceDir, ARTFLO_DIR);
+    try {
+        await fs.mkdir(artfloDir, { recursive: true });
+    }
+    catch {
+        // ignore
+    }
+}
+export async function readManifest(workspaceDir) {
+    const manifestPath = getManifestPath(workspaceDir);
+    try {
+        const content = await fs.readFile(manifestPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+export async function writeManifest(workspaceDir, manifest) {
+    await ensureArtfloDir(workspaceDir);
+    const manifestPath = getManifestPath(workspaceDir);
+    await fs.writeFile(manifestPath, JSON.stringify(manifest, null, 2), 'utf-8');
+}
+export async function setProjectId(workspaceDir, id) {
+    await writeManifest(workspaceDir, { project: id });
+}
+export async function getProjectId(workspaceDir) {
+    return (await readManifest(workspaceDir)).project;
+}

package/dist/src/tools/register-tools.js

@@ -22,6 +22,7 @@ import { executePlan as runExecutePlan } from '../core/executor/execute-plan.js'
 import { ExecutionTraceWriter } from '../core/executor/execution-trace.js';
 import { parsePlanV2, validateAndFixPlan } from '../core/plan/validate-plan.js';
 import { writeToolTrace } from './tool-trace.js';
+import { getProjectId, setProjectId } from '../services/manifest-service.js';
 export function registerArtfloTools(api, context) {
     api.registerTool({
         name: ARTFLO_TOOL_NAMES.getNode,
@@ -417,6 +418,9 @@ export function registerArtfloTools(api, context) {
             return runWithToolTrace(ARTFLO_TOOL_NAMES.createCanvas, params, async () => {
                 const name = params.name || 'Untitled';
                 const result = await createCanvas(context.config, name);
+                if (context.workspaceDir) {
+                    await setProjectId(context.workspaceDir, result.id);
+                }
                 return jsonResult({
                     ok: true,
                     label: ARTFLO_TOOL_NAMES.createCanvas,
@@ -429,6 +433,27 @@ export function registerArtfloTools(api, context) {
             });
         },
     });
+    api.registerTool({
+        name: ARTFLO_TOOL_NAMES.getLastCanvas,
+        label: 'Artflo Canvas Get Last',
+        description: 'Get the last used canvas id. Use this when user requests last used canvas.',
+        parameters: Type.Object({}),
+        async execute(_id, params) {
+            return runWithToolTrace(ARTFLO_TOOL_NAMES.getLastCanvas, params, async () => {
+                let canvasId = '';
+                if (context.workspaceDir) {
+                    canvasId = (await getProjectId(context.workspaceDir)) ?? '';
+                }
+                return jsonResult({
+                    ok: true,
+                    label: ARTFLO_TOOL_NAMES.createCanvas,
+                    data: {
+                        canvasId: canvasId,
+                    },
+                });
+            });
+        },
+    });
     api.registerTool({
         name: ARTFLO_TOOL_NAMES.listModels,
         label: 'Artflo Canvas List Models',
@@ -559,17 +584,30 @@ export function registerArtfloTools(api, context) {
     });
     api.registerTool({
         name: ARTFLO_TOOL_NAMES.setApiKey,
-        label: 'Artflo Set API Key',
-        description: 'Save the user\'s Artflo API Key to the plugin config and restart the gateway. Call this when the user provides their API Key in chat. After success, the gateway will restart and all Artflo tools will be functional.',
+        label: 'Artflo Set Config',
+        description: 'Save Artflo plugin config (apiKey and/or env). Call this when the user provides their API Key or wants to switch environment. Both parameters are optional — only provided values will be updated.',
         parameters: Type.Object({
-            apiKey: Type.String({ minLength: 1, description: 'The Artflo API Key provided by the user.' }),
+            apiKey: Type.Optional(Type.String({ minLength: 1, description: 'Artflo API Key.' })),
+            env: Type.Optional(Type.String({ enum: ['release', 'test'], description: 'Environment: release or test.' })),
         }),
         async execute(_id, params) {
-            const { apiKey } = params;
+            const { apiKey, env } = params;
+            if (!apiKey && !env) {
+                return jsonResult({
+                    ok: false,
+                    label: ARTFLO_TOOL_NAMES.setApiKey,
+                    error: 'At least one of apiKey or env must be provided.',
+                });
+            }
             try {
                 const cfg = api.runtime.config.loadConfig();
                 const pluginEntry = cfg.plugins?.entries?.['artflo-openclaw-plugin'] ?? {};
                 const existingConfig = pluginEntry.config ?? {};
+                const updatedConfig = { ...existingConfig };
+                if (apiKey)
+                    updatedConfig.apiKey = apiKey;
+                if (env)
+                    updatedConfig.env = env;
                 const nextConfig = {
                     ...cfg,
                     plugins: {
@@ -579,10 +617,7 @@ export function registerArtfloTools(api, context) {
                             'artflo-openclaw-plugin': {
                                 ...pluginEntry,
                                 enabled: true,
-                                config: {
-                                    ...existingConfig,
-                                    apiKey,
-                                },
+                                config: updatedConfig,
                             },
                         },
                     },
@@ -592,8 +627,8 @@ export function registerArtfloTools(api, context) {
                     ok: true,
                     label: ARTFLO_TOOL_NAMES.setApiKey,
                     data: {
-                        message: 'API Key saved. Please restart gateway with: openclaw gateway restart',
-                        saved: true,
+                        message: 'Config saved. Gateway will auto-reload.',
+                        saved: { apiKey: apiKey ? true : false, env: env || null },
                     },
                 });
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artflo-ai/artflo-openclaw-plugin",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "type": "module",
   "description": "OpenClaw plugin that connects directly to Artflo canvas WebSocket runtime.",
   "keywords": [

package/skills/artflo-canvas/SKILL.md

@@ -34,8 +34,7 @@ metadata:
 > 请登录 [artflo.ai](https://artflo.ai)，在设置页面获取 API Key，然后直接发给我，我帮你配置好。
 
 3. 当用户发来 API Key 后，调用 `artflo_set_api_key` 工具保存到配置中。
-4. 保存成功后，提示用户运行 `openclaw gateway restart` 重启 gateway 使配置生效。
-5. 重启后即可正常使用所有画布功能。
+4. 保存成功后，gateway 会自动重新加载配置，稍等片刻即可正常使用所有画布功能。
 
 ## 操作策略
 
@@ -48,6 +47,8 @@ metadata:
 - 规划时不要臆造底层画布数字节点类型。应使用 plan 中的节点类型，例如 `input`、`refine`、`process`、`selector`、`batch`、`crop`。
 - 在假设画布运行时已就绪之前，先读取连接状态。
 - 将插件配置视为 WebSocket 凭证和连接默认值的唯一真实来源。
+- **禁止编造 API URL**：不要自行拼接或猜测 Artflo API 路径。所有 API 交互必须通过插件提供的 tool 完成（如 `artflo_canvas_get_last`、`artflo_canvas_create`、`artflo_upload_file` 等）。不要使用 `fetch` 或 `curl` 直接调用 Artflo API。
+- **资源保存路径**：画布生成完成后需要下载保存的资源（图片、视频等），必须保存到 `/artflo/outbound` 目录。不要使用 `/tmp` 或其他临时目录。
 - 当插件布局引擎可用时，不要手工编造节点坐标。
 
 ## 默认编辑规则
@@ -63,7 +64,7 @@ metadata:
 
 ## 推荐流程
 
-1. 检查是否有可用的 canvas id。如果没有，调用 `artflo_canvas_create` 创建新画布，并将返回的 URL 分享给用户。
+1. 检查是否有可用的 canvas id。如果没有，调用 `artflo_canvas_get_last` 获取上次使用的画布，没有的话调用 `artflo_canvas_create` 创建新画布，并将返回的 URL 分享给用户。
 2. 调用 `artflo_canvas_connection_status` 检查连接状态。
 3. 如果未连接，使用目标 canvas id 调用 `artflo_canvas_connect`。
 4. **调用 `artflo_canvas_get_config` 获取可用模型列表、订阅状态和 Prompt Refine 分类。** 或者调用 `artflo_canvas_list_models` 获取更详细的模型信息（含分辨率价格、订阅要求等），适合需要向用户展示模型选择时使用。

package/skills/artflo-canvas/references/planning-guide.md

@@ -7,8 +7,8 @@ Read `references/node-schema.json` first for node type constraints, then use thi
 
 Before executing any workflow, ensure you have a canvas:
 
-1. **No canvas id available**: Call `artflo_canvas_create` to create a new canvas. Use the returned `canvasId` for all subsequent operations. Share the `url` with the user so they can view the canvas.
-2. **Canvas id available**: Use the existing canvas. On the first task of each day, ask the user whether to create a new canvas or reuse the existing one. Show the link: `https://artflo.ai/project/{canvas_id}`.
+1. **No canvas id available**: First try `artflo_canvas_get_last` to retrieve the user's most recent canvas. If found, use its `canvasId` for subsequent operations. Only call `artflo_canvas_create` if `artflo_canvas_get_last` returns no canvas or fails. Share the canvas `url` with the user.
+2. **Canvas id available**: Use the existing canvas. On the first task of each day, ask the user whether to create a new canvas or reuse the existing one. The canvas URL is returned by `artflo_canvas_create` or `artflo_canvas_get_last`.
 3. **User requests new canvas**: Call `artflo_canvas_create` immediately.
 
 ## Core Principle