@artflo-ai/artflo-openclaw-plugin 0.0.6 → 0.0.8

package/dist/logs/ws-traffic-traces/2026-03-28T02-36-29-132Z+08-lifecycle-heartbeat_ping-d1cf7166-6c6f-6172-bda0-1014a3ae1e0a.json

@@ -0,0 +1,9 @@
+{
+  "createdAt": "2026-03-27T18:36:29.133Z",
+  "direction": "lifecycle",
+  "event": "heartbeat:ping",
+  "canvasId": "d1cf7166-6c6f-6172-bda0-1014a3ae1e0a",
+  "payload": {
+    "canvasId": "d1cf7166-6c6f-6172-bda0-1014a3ae1e0a"
+  }
+}

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

@@ -457,7 +457,15 @@ export function registerArtfloTools(api, context) {
     api.registerTool({
         name: ARTFLO_TOOL_NAMES.listModels,
         label: 'Artflo Canvas List Models',
-        description: 'List all available AI models with their names, subscription requirements, default status, and credit costs. Video model credits are per-second. Use this to help users understand what models are available before planning a workflow.',
+        description: 'List all available AI models. When presenting results to the user, you MUST show ALL of these fields in a table: ' +
+            '1) Model name (use model_name, NEVER expose model_key to user) ' +
+            '2) Credits (base price; if resolutionPricing exists, show per-resolution prices) ' +
+            '3) Supported resolutions ' +
+            '4) Supported ratios ' +
+            '5) Subscription required (if only certain resolutions require subscription via multi_subscribe, specify which ones) ' +
+            '6) Default model marker ' +
+            '7) Supported durations (video models only). ' +
+            'Do NOT omit any of these fields. Video model credits are per-second.',
         parameters: Type.Object({
             canvasId: Type.String({ minLength: 1 }),
             category: Type.Optional(Type.String({
@@ -508,7 +516,7 @@ export function registerArtfloTools(api, context) {
                                 return [
                                     label,
                                     {
-                                        credits: isVideo ? `${price} credits/sec` : `${price} credits`,
+                                        credits: `${price} credits`,
                                         ...(needsSub ? { requiresSubscription: true } : {}),
                                     },
                                 ];
@@ -520,9 +528,7 @@ export function registerArtfloTools(api, context) {
                             isDefault: m.is_default,
                             requiresSubscription: m.subscribe_available,
                             available: modelAvailable,
-                            credits: isVideo
-                                ? `${m.price} credits/sec`
-                                : `${m.price} credits`,
+                            maxCredits: `${m.price} credits`,
                         };
                         if (m.support_resolution?.length) {
                             item.supportedResolutions = m.support_resolution;
@@ -590,6 +596,13 @@ export function registerArtfloTools(api, context) {
         parameters: Type.Object({}),
         async execute(_id, params) {
             return runWithToolTrace(ARTFLO_TOOL_NAMES.getUserStatus, params, async () => {
+                if (!context.config.apiKey) {
+                    return jsonResult({
+                        ok: false,
+                        label: ARTFLO_TOOL_NAMES.getUserStatus,
+                        error: 'API Key not configured. Use artflo_set_api_key to set it first.',
+                    });
+                }
                 const status = await fetchUserStatus(context.config);
                 return jsonResult({
                     ok: true,

package/package.json

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

package/skills/artflo-canvas/SKILL.md

@@ -24,17 +24,17 @@ metadata:
 
 ## API Key 配置检查（首要步骤）
 
-在执行任何操作之前，先调用 `artflo_canvas_connection_status` 或 `artflo_canvas_connect` 检查连接。如果返回结果中 `hasApiKey: false`，说明用户还没有配置 API Key。此时你必须：
+**如果 before_prompt_build 注入的上下文显示 `apiKey=未配置`，则：**
 
-1. 停止所有后续操作，不要尝试创建画布或执行工作流。
-2. 引导用户提供 API Key，用以下话术：
+1. **禁止调用除 `artflo_set_api_key` 以外的任何 Artflo 工具。** 没有 API Key，所有接口都会返回 401。
+2. 引导用户提供 API Key：
 
 > 你还没有配置 Artflo API Key，需要先设置才能使用画布功能。
 >
 > 请登录 [artflo.ai](https://artflo.ai)，在设置页面获取 API Key，然后直接发给我，我帮你配置好。
 
 3. 当用户发来 API Key 后，调用 `artflo_set_api_key` 工具保存到配置中。
-4. 保存成功后，gateway 会自动重新加载配置，稍等片刻即可正常使用所有画布功能。
+4. 保存成功后，gateway 会自动重新加载配置。**告诉用户配置已保存，需要等待约 10 秒让 gateway 重载完成，然后开始新会话（/new）再继续操作。** 不要在当前会话中立即调用其他 Artflo 工具，因为 gateway 重载期间旧的 config（没有 API Key）仍在内存中。
 
 ## 操作策略
 
@@ -50,6 +50,16 @@ metadata:
 - **禁止编造 API URL**：不要自行拼接或猜测 Artflo API 路径。所有 API 交互必须通过插件提供的 tool 完成（如 `artflo_canvas_get_last`、`artflo_canvas_create`、`artflo_upload_file` 等）。不要使用 `fetch` 或 `curl` 直接调用 Artflo API。
 - **model_key 保密**：`model_key`（如 `Praline_2`、`ToffeeV1-Lite`）是内部标识，仅供构建 plan 使用。向用户展示模型时只使用 `model_name`（显示名称），绝不向用户暴露 `model_key`。
 - **资源保存路径**：画布生成完成后需要下载保存的资源（图片、视频等），必须保存到 `/artflo/outbound` 目录。不要使用 `/tmp` 或其他临时目录。
+- **环境设置保密**：不要主动向用户提及或暴露环境切换功能（release/test）。只有当用户明确提到要切换环境、设置 test 环境时，才使用 `artflo_set_api_key` 的 `env` 参数。
+- **品牌名称规范**：产品名称是 **Artflo**（A 大写，其余小写）。不要写成 ArtFlo、ARTFLO、artFlo 或其他变体。所有面向用户的文字中必须使用正确的大小写。
+- **模型列表展示规范**：当用户查看模型列表时，必须展示以下字段，不要省略：
+  - 模型名（model_name，不是 model_key）
+  - 积分消耗（基础价格；如有按分辨率差异化价格则展示各分辨率价格）
+  - 支持的分辨率
+  - 支持的比例
+  - 是否需要订阅（如果只有部分分辨率需要订阅，要明确标注哪些分辨率需要订阅）
+  - 是否默认模型
+  - 支持的时长（仅视频模型）
 - 当插件布局引擎可用时，不要手工编造节点坐标。
 
 ## 默认编辑规则