ロブスター

Lobster は、明示的な承認チェックポイントと再開トークンを備えた複数ステップのツールパイプラインを、決定論的な単一のツール呼び出しとして実行します。これは切り離されたバックグラウンド処理の一段上に位置します。多数の切り離されたタスクにまたがるフローをオーケストレーションするには、Task Flow（openclaw tasks flow）を参照してください。タスクのアクティビティ台帳については、バックグラウンドタスクを参照してください。

理由

Lobster を使用しない場合、複数ステップのジョブには多数の往復ツール呼び出しが必要となり、モデルが各ステップをオーケストレーションします。Lobster は、そのオーケストレーションを型付きランタイムに移します。

• 多数の呼び出しを1回に集約：単一の Lobster ツール呼び出しが、パイプライン全体の構造化された結果を返します。
• 承認を内蔵：副作用（送信、投稿、削除）が発生する前にワークフローを停止し、明示的な承認を待ちます。
• 再開可能：停止したワークフローはトークンを返します。承認して再開する際に、以前のステップを再実行する必要はありません。

Lobster は汎用スクリプト言語ではなく、小規模で制約された DSL です。承認と再開は永続性のある組み込みプリミティブです。パイプラインはデータであるため、ログ記録、差分確認、再実行、レビューが容易です。小さな文法によって「創造的」なコードパスが制限されるため、現実的な検証が可能です。また、タイムアウト、出力上限、サンドボックスチェック、許可リストは各スクリプトではなくランタイムによって適用されます。それでも各ステップから任意の CLI やスクリプトを呼び出せます。より表現力の高いオーサリング言語が必要な場合は、別のツールから .lobster ファイルを生成してください。

Lobster を使用しない場合、定期的なメールのトリアージは次のようになります。

ユーザー：「メールを確認して返信の下書きを作成して」→ openclaw が gmail.list を呼び出す→ LLM が要約する→ ユーザー：「#2 と #5 への返信を下書きして」→ LLM が下書きする→ ユーザー：「#2 を送信して」→ openclaw が gmail.send を呼び出す（毎日繰り返され、何をトリアージしたかの記憶は残らない）

Lobster を使用すると、同じジョブが承認のために停止し、その後再開できる単一の呼び出しになります。

{ "action": "run", "pipeline": "email.triage --limit 20", "timeoutMs": 30000 }

{  "ok": true,  "status": "needs_approval",  "output": [{ "summary": "5 need replies, 2 need action" }],  "requiresApproval": {    "type": "approval_request",    "prompt": "Send 2 draft replies?",    "items": [],    "resumeToken": "..."  }}

仕組み

OpenClaw は、組み込みランナーとして同梱されている @clawdbot/lobster パッケージを使用し、Lobster ワークフローをプロセス内で実行します。外部の lobster サブプロセスは起動されず、ツール呼び出しから JSON エンベロープが直接返されます。パイプラインが承認のために停止した場合、後で続行できるように、エンベロープには再開トークン（または短い承認 ID）が含まれます。

有効化

Lobster は任意の Plugin ツールであり、デフォルトでは有効になっていません。同梱されているため、個別のインストール手順は不要です。ツールを許可するだけで使用できます。

{  "tools": {    "alsoAllow": ["lobster"]  }}

またはエージェントごとに設定します。

{  "agents": {    "list": [      {        "id": "main",        "tools": {          "alsoAllow": ["lobster"]        }      }    ]  }}

サンドボックス化されたツールコンテキストでは、このツールは完全に無効になります。

開発用または外部パイプライン用（組み込み Gateway ランナー外）のスタンドアロン Lobster CLI が必要な場合は、Lobster リポジトリからインストールし、lobster を PATH に追加してください。

パターン：小さな CLI + JSON パイプ + 承認

JSON を扱う小さなコマンドを作成し、それらを単一の Lobster 呼び出しに連結します。 （以下はコマンド名の例です。独自のものに置き換えてください。）

inbox list --jsoninbox categorize --jsoninbox apply --json

{  "action": "run",  "pipeline": "exec --json --shell 'inbox list --json' | exec --stdin json --shell 'inbox categorize --json' | exec --stdin json --shell 'inbox apply --json' | approve --preview-from-stdin --limit 5 --prompt 'Apply changes?'",  "timeoutMs": 30000}

パイプラインが承認を要求した場合は、トークンを使用して再開します。

{  "action": "resume",  "token": "<resumeToken>",  "approve": true}

例：入力項目をツール呼び出しにマッピングします。

gog.gmail.search --query 'newer_than:1d' \  | openclaw.invoke --tool message --action send --each --item-key message --args-json '{"provider":"telegram","to":"..."}'

JSON のみの LLM ステップ（llm-task）

ワークフロー内で構造化された LLM ステップを使用するには、任意の llm-task Plugin ツールを有効化し、Lobster から呼び出します。

{  "plugins": {    "entries": {      "llm-task": { "enabled": true }    }  },  "agents": {    "list": [      {        "id": "main",        "tools": { "alsoAllow": ["llm-task"] }      }    ]  }}

重要な制限：組み込み Lobster と openclaw.invoke の違い

同梱されている Lobster Plugin は、Gateway 内でワークフローをプロセス内実行します。この組み込みモードでは、ネストされた OpenClaw CLI ツール呼び出しに対して、openclaw.invoke が Gateway URL や認証コンテキストを自動的に継承することはありません。

そのため、次のパターンは、現在の組み込みランナーでは信頼できません。

openclaw.invoke --tool llm-task --action json --args-json '{ ... }'

以下の例は、openclaw.invoke に正しい Gateway と認証のコンテキストがすでに設定された環境で、スタンドアロン Lobster CLI を実行する場合にのみ使用してください。

openclaw.invoke --tool llm-task --action json --args-json '{  "prompt": "Given the input email, return intent and draft.",  "thinking": "low",  "input": { "subject": "Hello", "body": "Can you help?" },  "schema": {    "type": "object",    "properties": {      "intent": { "type": "string" },      "draft": { "type": "string" }    },    "required": ["intent", "draft"],    "additionalProperties": false  }}'

現在、組み込み Lobster Plugin を使用している場合は、次のいずれかを推奨します。

• Lobster 外で llm-task ツールを直接呼び出す
• サポート対象の組み込みブリッジが追加されるまで、Lobster パイプライン内では openclaw.invoke 以外のステップを使用する

詳細と設定オプションについては、LLM タスクを参照してください。

ワークフローファイル（.lobster）

Lobster は、name、args、steps、env、condition、approval フィールドを含む YAML/JSON ワークフローファイルを実行できます。ツール呼び出しの pipeline にファイルパスを設定します。

name: inbox-triageargs:  tag:    default: "family"steps:  - id: collect    command: inbox list --json  - id: categorize    command: inbox categorize --json    stdin: $collect.stdout  - id: approve    command: inbox apply --approve    stdin: $categorize.stdout    approval: required  - id: execute    command: inbox apply --execute    stdin: $categorize.stdout    condition: $approve.approved

注記：

• stdin: $step.stdout と stdin: $step.json は、前のステップの出力を渡します。
• condition（または when）を使用すると、$step.approved に基づいてステップの実行を制御できます。

ツールパラメーター

run

{  "action": "run",  "pipeline": "gog.gmail.search --query 'newer_than:1d' | email.triage",  "cwd": "workspace",  "timeoutMs": 30000,  "maxStdoutBytes": 512000}

引数を指定してワークフローファイルを実行します。

{  "action": "run",  "pipeline": "/path/to/inbox-triage.lobster",  "argsJson": "{\"tag\":\"family\"}"}

resume

{  "action": "resume",  "token": "<resumeToken>",  "approve": true}

resume は、token（requiresApproval に含まれる完全な再開トークン）または approvalId（同じオブジェクトに含まれる短い ID）のいずれかを受け付けます。停止した実行が返した方を使用してください。approve は必須です。

管理対象 Task Flow モード

run に flowControllerId と flowGoal を渡す（または resume に flowId と flowExpectedRevision を渡す）と、単純なエンベロープを返す代わりに、Plugin ランタイムの管理対象 Task Flow API を通じて呼び出しが処理されます。OpenClaw は永続的なフローレコードを作成または再開し、Lobster エンベロープを適用し（承認待ちの場合は waiting、完了時は succeeded/failed）、{ ok, envelope, flow, mutation } を返します。このモードにはバインドされた Task Flow ランタイムが必要です。通常のアドホックなエージェント利用ではなく、Gateway の再起動後も永続的なフロー状態を必要とする Plugin またはコントローラーコード向けです。

出力エンベロープ

Lobster は、次の3つのステータスのいずれかを持つ JSON エンベロープを返します。

• ok - 正常に完了
• needs_approval - 一時停止中。requiresApproval に resumeToken と短い approvalId が含まれ、どちらでも実行を再開可能
• cancelled - 明示的に拒否またはキャンセル済み

ツールは、エンベロープを content（整形済み JSON）と details（未加工オブジェクト）の両方で公開します。

承認

requiresApproval が存在する場合は、プロンプトを確認して判断します。

• approve: true - 再開し、副作用を伴う処理を続行
• approve: false - キャンセルしてワークフローを終了

approve --preview-from-stdin --limit N を使用すると、独自の jq/heredoc 処理を作成せずに、承認リクエストへ JSON プレビューを添付できます。再開状態は、Lobster の状態ディレクトリ（デフォルトでは ~/.lobster/state、LOBSTER_STATE_DIR で上書き可能）に小さな JSON ファイルとして保存されます。トークン自体には、パイプラインの完全な状態ではなく、その状態へのポインターのみがエンコードされます。

OpenProse

OpenProse は Lobster と組み合わせて効果的に使用できます。/prose を使用して複数エージェントによる準備をオーケストレーションし、その後 Lobster パイプラインを実行して決定論的な承認を行います。Prose プログラムで Lobster が必要な場合は、tools.subagents.tools を使用してサブエージェントに lobster ツールを許可してください。OpenProseを参照してください。

安全性

• ローカルのプロセス内のみ - ワークフローは Gateway プロセス内で実行されます。Plugin 自体からネットワーク呼び出しは行いません。
• シークレットなし - Lobster は OAuth を管理せず、それを行う OpenClaw ツールを呼び出します。
• サンドボックス対応 - ツールコンテキストがサンドボックス化されている場合は無効になります。
• 堅牢化 - 組み込みランナーによってタイムアウトと出力上限が適用されます。

トラブルシューティング

詳細情報

• Plugins
• Plugin ツールの作成

ケーススタディ：コミュニティのワークフロー

公開されている例の一つは、3つの Markdown 保管庫（個人用、パートナー用、共有用）を管理する「第二の脳」CLI と Lobster パイプラインです。CLI は統計、受信トレイ一覧、古くなった項目のスキャン結果を JSON で出力します。Lobster はこれらのコマンドを連結し、weekly-review、inbox-triage、memory-consolidation、shared-task-sync などのワークフローを構成します。各ワークフローには承認ゲートがあります。AI が利用可能な場合は判断（分類）を行い、利用できない場合は決定論的なルールにフォールバックします。

• スレッド：https://x.com/plattenschieber/status/2014508656335770033
• リポジトリ：https://github.com/bloomedai/brain-cli

関連項目

• 自動化 - すべての自動化メカニズム
• ツール概要 - 利用可能なすべてのエージェントツール