docs(lobster): clarify embedded openclaw.invoke limitation · openclaw/openclaw@8a66694
2026-05-07
·
via Recent Commits to openclaw:main
| Original file line number | Diff line number | Diff line change |
|---|
@@ -85,6 +85,23 @@ Returns `details.json` containing the parsed JSON (and validates against
|
85 | 85 | |
86 | 86 | ## Example: Lobster workflow step |
87 | 87 | |
| 88 | +### Important limitation |
| 89 | + |
| 90 | +The example below assumes the **standalone Lobster CLI** is running in an environment where `openclaw.invoke` already has the correct gateway URL/auth context. |
| 91 | + |
| 92 | +For the bundled **embedded** Lobster runner inside OpenClaw, this nested CLI pattern is **not currently reliable**: |
| 93 | + |
| 94 | +```lobster |
| 95 | +openclaw.invoke --tool llm-task --action json --args-json '{ ... }' |
| 96 | +``` |
| 97 | + |
| 98 | +Until embedded Lobster has a supported bridge for this flow, prefer either: |
| 99 | + |
| 100 | +- direct `llm-task` tool calls outside Lobster, or |
| 101 | +- Lobster steps that do not rely on nested `openclaw.invoke` calls. |
| 102 | + |
| 103 | +Standalone Lobster CLI example: |
| 104 | + |
88 | 105 | ```lobster |
89 | 106 | openclaw.invoke --tool llm-task --action json --args-json '{ |
90 | 107 | "prompt": "Given the input email, return intent and draft.", |
|
| Original file line number | Diff line number | Diff line change |
|---|
@@ -100,7 +100,19 @@ Enable the tool:
|
100 | 100 | } |
101 | 101 | ``` |
102 | 102 | |
103 | | -Use it in a pipeline: |
| 103 | +### Important limitation: embedded Lobster vs `openclaw.invoke` |
| 104 | + |
| 105 | +The bundled Lobster plugin runs workflows **in-process** inside the gateway. In that embedded mode, `openclaw.invoke` does **not** automatically inherit a gateway URL/auth context for nested OpenClaw CLI tool calls. |
| 106 | + |
| 107 | +That means this pattern is **not currently reliable in the embedded runner**: |
| 108 | + |
| 109 | +```lobster |
| 110 | +openclaw.invoke --tool llm-task --action json --args-json '{ ... }' |
| 111 | +``` |
| 112 | + |
| 113 | +Use the example below only when running the **standalone Lobster CLI** in an environment where `openclaw.invoke` is already configured with the correct gateway/auth context. |
| 114 | + |
| 115 | +Use it in a standalone Lobster CLI pipeline: |
104 | 116 | |
105 | 117 | ```lobster |
106 | 118 | openclaw.invoke --tool llm-task --action json --args-json '{ |
@@ -119,6 +131,11 @@ openclaw.invoke --tool llm-task --action json --args-json '{
|
119 | 131 | }' |
120 | 132 | ``` |
121 | 133 | |
| 134 | +If you are using the embedded Lobster plugin today, prefer either: |
| 135 | + |
| 136 | +- a direct `llm-task` tool call outside Lobster, or |
| 137 | +- non-`openclaw.invoke` steps inside the Lobster pipeline until a supported embedded bridge is added. |
| 138 | + |
122 | 139 | See [LLM Task](/tools/llm-task) for details and configuration options. |
123 | 140 | |
124 | 141 | ## Workflow files (.lobster) |
|
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。