mirror of
https://github.com/farcasclaudiu/openclaw.git
synced 2026-06-29 13:02:10 +03:00
Docs: update zh-CN translations and pipeline
What: - update zh-CN glossary, TM, and translator prompt - regenerate zh-CN docs and apply targeted fixes - add zh-CN AGENTS pipeline guidance Why: - address terminology/spacing feedback from #6995 Tests: - pnpm build && pnpm check && pnpm test
This commit is contained in:
Josh Palmer
+59
-58
@@ -1,12 +1,12 @@
|
||||
---
|
||||
description: Typed workflow runtime for OpenClaw — composable pipelines with approval gates.
|
||||
read_when:
|
||||
- 你需要具有显式审批的确定性多步骤工作流
|
||||
- 你需要恢复工作流而无需重新运行之前的步骤
|
||||
summary: OpenClaw 的类型化工作流运行时，支持可恢复的审批门控。
|
||||
- 你想要具有显式审批的确定性多步骤工作流
|
||||
- 你需要恢复工作流而不重新运行早期步骤
|
||||
summary: OpenClaw 的类型化工作流运行时，支持可恢复的审批关卡。
|
||||
title: Lobster
|
||||
x-i18n:
|
||||
generated_at: "2026-02-01T21:43:19Z"
|
||||
generated_at: "2026-02-03T10:11:30Z"
|
||||
model: claude-opus-4-5
|
||||
provider: pi
|
||||
source_hash: ff84e65f4be162ad98f16ddf0882f23b3198f05b4d9e8dc03d07e9b2bf0fd5ad
|
||||
@@ -20,34 +20,34 @@ Lobster 是一个工作流外壳，让 OpenClaw 能够将多步骤工具序列
|
||||
|
||||
## 亮点
|
||||
|
||||
你的助手可以构建管理自身的工具。请求一个工作流，30 分钟后你就能得到一个 CLI 加上作为单次调用运行的流水线。Lobster 就是缺失的那块拼图：确定性流水线、显式审批和可恢复状态。
|
||||
你的助手可以构建管理自身的工具。请求一个工作流，30 分钟后你就有了一个 CLI 和作为单次调用运行的管道。Lobster 是缺失的那一块：确定性管道、显式审批和可恢复状态。
|
||||
|
||||
## 为什么需要 Lobster
|
||||
## 为什么
|
||||
|
||||
如今，复杂的工作流需要大量来回的工具调用。每次调用都消耗 token，而 LLM 必须编排每一个步骤。Lobster 将这种编排移入类型化运行时：
|
||||
如今，复杂的工作流需要多次来回的工具调用。每次调用都消耗 token，LLM 必须编排每一步。Lobster 将这种编排移入类型化运行时：
|
||||
|
||||
- **一次调用代替多次**：OpenClaw 运行一次 Lobster 工具调用即可获得结构化结果。
|
||||
- **内置审批**：副作用（发送邮件、发布评论）会暂停工作流，直到获得显式批准。
|
||||
- **可恢复**：暂停的工作流返回一个令牌；批准后可恢复执行，无需重新运行所有步骤。
|
||||
- **一次调用代替多次**：OpenClaw 运行一次 Lobster 工具调用并获得结构化结果。
|
||||
- **内置审批**：副作用（发送邮件、发布评论）会暂停工作流，直到明确批准。
|
||||
- **可恢复**：暂停的工作流返回一个令牌；批准并恢复而无需重新运行所有内容。
|
||||
|
||||
## 为什么用 DSL 而不是普通程序？
|
||||
|
||||
Lobster 刻意保持小巧。目标不是"一门新语言"，而是一个可预测的、AI 友好的流水线规范，内置一等公民级别的审批和恢复令牌。
|
||||
Lobster 故意很小。目标不是"一种新语言"，而是一个可预测的、AI 友好的管道规范，具有一流的审批和恢复令牌。
|
||||
|
||||
- **审批/恢复是内置的**：普通程序可以提示用户，但如果不自行发明运行时，它无法*暂停并通过持久令牌恢复*。
|
||||
- **确定性 + 可审计性**：流水线就是数据，因此易于记录、比较、重放和审查。
|
||||
- **为 AI 限定的表面积**：精简的语法 + JSON 管道减少了"创造性"代码路径，使验证更加可行。
|
||||
- **安全策略内置**：超时、输出上限、沙箱检查和允许列表由运行时强制执行，而非每个脚本自行处理。
|
||||
- **依然可编程**：每个步骤可以调用任何 CLI 或脚本。如果你想用 JS/TS，可以从代码生成 `.lobster` 文件。
|
||||
- **内置批准/恢复**：普通程序可以提示人类，但它无法*暂停和恢复*并带有持久令牌，除非你自己发明那个运行时。
|
||||
- **确定性 + 可审计性**：管道是数据，所以它们易于记录、比较、重放和审查。
|
||||
- **AI 的受限表面**：微小的语法 + JSON 管道减少了"创造性"代码路径，使验证变得现实可行。
|
||||
- **内置安全策略**：超时、输出上限、沙箱检查和白名单由运行时强制执行，而不是每个脚本。
|
||||
- **仍然可编程**：每个步骤都可以调用任何 CLI 或脚本。如果你想要 JS/TS，可以从代码生成 `.lobster` 文件。
|
||||
|
||||
## 工作原理
|
||||
|
||||
OpenClaw 以**工具模式**启动本地 `lobster` CLI，并从 stdout 解析 JSON 信封。
|
||||
如果流水线因需要审批而暂停，工具会返回一个 `resumeToken`，以便你稍后继续。
|
||||
如果管道暂停等待审批，工具会返回一个 `resumeToken`，以便你稍后继续。
|
||||
|
||||
## 模式：小型 CLI + JSON 管道 + 审批
|
||||
|
||||
构建输出 JSON 的小型命令，然后将它们串联成单个 Lobster 调用。（以下为示例命令名称——替换为你自己的。）
|
||||
构建输出 JSON 的小命令，然后将它们链接成单个 Lobster 调用。（下面是示例命令名称——替换成你自己的。）
|
||||
|
||||
```bash
|
||||
inbox list --json
|
||||
@@ -63,7 +63,7 @@ inbox apply --json
|
||||
}
|
||||
```
|
||||
|
||||
如果流水线请求审批，使用令牌恢复：
|
||||
如果管道请求审批，使用令牌恢复：
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -73,9 +73,9 @@ inbox apply --json
|
||||
}
|
||||
```
|
||||
|
||||
AI 触发工作流；Lobster 执行步骤。审批门控保持副作用的显式性和可审计性。
|
||||
AI 触发工作流；Lobster 执行步骤。审批关卡使副作用显式且可审计。
|
||||
|
||||
示例：将输入项映射为工具调用：
|
||||
示例：将输入项映射到工具调用：
|
||||
|
||||
```bash
|
||||
gog.gmail.search --query 'newer_than:1d' \
|
||||
@@ -85,9 +85,10 @@ gog.gmail.search --query 'newer_than:1d' \
|
||||
## 纯 JSON 的 LLM 步骤（llm-task）
|
||||
|
||||
对于需要**结构化 LLM 步骤**的工作流，启用可选的
|
||||
`llm-task` 插件工具并从 Lobster 中调用它。这样既能保持工作流的确定性，又能利用模型进行分类/摘要/起草。
|
||||
`llm-task` 插件工具并从 Lobster 调用它。这保持了工作流的
|
||||
确定性，同时仍然允许你使用模型进行分类/摘要/起草。
|
||||
|
||||
启用该工具：
|
||||
启用工具：
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -107,7 +108,7 @@ gog.gmail.search --query 'newer_than:1d' \
|
||||
}
|
||||
```
|
||||
|
||||
在流水线中使用：
|
||||
在管道中使用它：
|
||||
|
||||
```lobster
|
||||
openclaw.invoke --tool llm-task --action json --args-json '{
|
||||
@@ -125,7 +126,7 @@ openclaw.invoke --tool llm-task --action json --args-json '{
|
||||
}'
|
||||
```
|
||||
|
||||
详情和配置选项请参阅 [LLM Task](/tools/llm-task)。
|
||||
参见 [LLM Task](/tools/llm-task) 了解详情和配置选项。
|
||||
|
||||
## 工作流文件（.lobster）
|
||||
|
||||
@@ -152,21 +153,21 @@ steps:
|
||||
condition: $approve.approved
|
||||
```
|
||||
|
||||
说明：
|
||||
注意事项：
|
||||
|
||||
- `stdin: $step.stdout` 和 `stdin: $step.json` 传递前一步骤的输出。
|
||||
- `condition`（或 `when`）可以基于 `$step.approved` 来控制步骤执行。
|
||||
- `condition`（或 `when`）可以根据 `$step.approved` 控制步骤。
|
||||
|
||||
## 安装 Lobster
|
||||
|
||||
在运行 OpenClaw Gateway网关的**同一主机**上安装 Lobster CLI（参见 [Lobster 仓库](https://github.com/openclaw/lobster)），并确保 `lobster` 在 `PATH` 中。
|
||||
如果你想使用自定义二进制文件位置，请在工具调用中传入**绝对路径** `lobsterPath`。
|
||||
在运行 OpenClaw Gateway 网关的**同一主机**上安装 Lobster CLI（参见 [Lobster 仓库](https://github.com/openclaw/lobster)），并确保 `lobster` 在 `PATH` 中。
|
||||
如果你想使用自定义二进制位置，在工具调用中传递**绝对**路径 `lobsterPath`。
|
||||
|
||||
## 启用工具
|
||||
|
||||
Lobster 是一个**可选**插件工具（默认未启用）。
|
||||
Lobster 是一个**可选**的插件工具（默认未启用）。
|
||||
|
||||
推荐方式（增量添加，安全）：
|
||||
推荐（附加，安全）：
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -176,7 +177,7 @@ Lobster 是一个**可选**插件工具（默认未启用）。
|
||||
}
|
||||
```
|
||||
|
||||
或按智能体配置：
|
||||
或每个智能体：
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -193,11 +194,11 @@ Lobster 是一个**可选**插件工具（默认未启用）。
|
||||
}
|
||||
```
|
||||
|
||||
避免使用 `tools.allow: ["lobster"]`，除非你打算以严格允许列表模式运行。
|
||||
避免使用 `tools.allow: ["lobster"]`，除非你打算在限制性白名单模式下运行。
|
||||
|
||||
注意：允许列表对可选插件是选择性加入的。如果你的允许列表只包含
|
||||
注意：白名单对于可选插件是自愿加入的。如果你的白名单只包含
|
||||
插件工具（如 `lobster`），OpenClaw 会保持核心工具启用。要限制核心
|
||||
工具，请在允许列表中同时包含你需要的核心工具或工具组。
|
||||
工具，也要在白名单中包含你想要的核心工具或组。
|
||||
|
||||
## 示例：邮件分类
|
||||
|
||||
@@ -206,12 +207,12 @@ Lobster 是一个**可选**插件工具（默认未启用）。
|
||||
```
|
||||
用户："检查我的邮件并起草回复"
|
||||
→ openclaw 调用 gmail.list
|
||||
→ LLM 进行摘要
|
||||
→ LLM 总结
|
||||
→ 用户："给 #2 和 #5 起草回复"
|
||||
→ LLM 起草
|
||||
→ 用户："发送 #2"
|
||||
→ openclaw 调用 gmail.send
|
||||
（每天重复，不记得之前分类了什么）
|
||||
（每天重复，不记得已分类的内容）
|
||||
```
|
||||
|
||||
使用 Lobster：
|
||||
@@ -224,7 +225,7 @@ Lobster 是一个**可选**插件工具（默认未启用）。
|
||||
}
|
||||
```
|
||||
|
||||
返回 JSON 信封（已截断）：
|
||||
返回一个 JSON 信封（已截断）：
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -256,7 +257,7 @@ Lobster 是一个**可选**插件工具（默认未启用）。
|
||||
|
||||
### `run`
|
||||
|
||||
以工具模式运行流水线。
|
||||
以工具模式运行管道。
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -280,7 +281,7 @@ Lobster 是一个**可选**插件工具（默认未启用）。
|
||||
|
||||
### `resume`
|
||||
|
||||
审批后继续暂停的工作流。
|
||||
在审批后继续暂停的工作流。
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -293,47 +294,47 @@ Lobster 是一个**可选**插件工具（默认未启用）。
|
||||
### 可选输入
|
||||
|
||||
- `lobsterPath`：Lobster 二进制文件的绝对路径（省略则使用 `PATH`）。
|
||||
- `cwd`：流水线的工作目录（默认为当前进程工作目录）。
|
||||
- `timeoutMs`：如果子进程超过此时长则终止（默认：20000）。
|
||||
- `cwd`：管道的工作目录（默认为当前进程工作目录）。
|
||||
- `timeoutMs`：如果子进程超过此持续时间则终止（默认：20000）。
|
||||
- `maxStdoutBytes`：如果 stdout 超过此大小则终止子进程（默认：512000）。
|
||||
- `argsJson`：传递给 `lobster run --args-json` 的 JSON 字符串（仅限工作流文件）。
|
||||
|
||||
## 输出信封
|
||||
|
||||
Lobster 返回一个 JSON 信封，包含以下三种状态之一：
|
||||
Lobster 返回一个具有三种状态之一的 JSON 信封：
|
||||
|
||||
- `ok` → 成功完成
|
||||
- `needs_approval` → 已暂停；需要 `requiresApproval.resumeToken` 来恢复
|
||||
- `cancelled` → 被显式拒绝或取消
|
||||
- `needs_approval` → 已暂停；需要 `requiresApproval.resumeToken` 才能恢复
|
||||
- `cancelled` → 明确拒绝或取消
|
||||
|
||||
该工具在 `content`（格式化 JSON）和 `details`（原始对象）中都会展示信封内容。
|
||||
工具在 `content`（格式化 JSON）和 `details`（原始对象）中都显示信封。
|
||||
|
||||
## 审批
|
||||
|
||||
如果存在 `requiresApproval`，检查提示并决定：
|
||||
|
||||
- `approve: true` → 恢复并继续执行副作用
|
||||
- `approve: true` → 恢复并继续副作用
|
||||
- `approve: false` → 取消并终结工作流
|
||||
|
||||
使用 `approve --preview-from-stdin --limit N` 将 JSON 预览附加到审批请求中，无需自定义 jq/heredoc 粘合代码。恢复令牌现在更加紧凑：Lobster 将工作流恢复状态存储在其状态目录下，并返回一个小型令牌密钥。
|
||||
使用 `approve --preview-from-stdin --limit N` 将 JSON 预览附加到审批请求，无需自定义 jq/heredoc 粘合代码。恢复令牌现在很紧凑：Lobster 在其状态目录下存储工作流恢复状态，并返回一个小令牌键。
|
||||
|
||||
## OpenProse
|
||||
|
||||
OpenProse 与 Lobster 配合良好：使用 `/prose` 编排多智能体准备工作，然后运行 Lobster 流水线进行确定性审批。如果 Prose 程序需要 Lobster，可通过 `tools.subagents.tools` 为子智能体允许 `lobster` 工具。参见 [OpenProse](/prose)。
|
||||
OpenProse 与 Lobster 配合良好：使用 `/prose` 编排多智能体准备，然后运行 Lobster 管道进行确定性审批。如果 Prose 程序需要 Lobster，通过 `tools.subagents.tools` 为子智能体允许 `lobster` 工具。参见 [OpenProse](/prose)。
|
||||
|
||||
## 安全性
|
||||
## 安全
|
||||
|
||||
- **仅限本地子进程** — 插件本身不发起网络调用。
|
||||
- **无密钥** — Lobster 不管理 OAuth；它调用处理 OAuth 的 OpenClaw 工具。
|
||||
- **沙箱感知** — 当工具上下文处于沙箱中时自动禁用。
|
||||
- **加固** — 如果指定了 `lobsterPath` 则必须为绝对路径；超时和输出上限强制执行。
|
||||
- **仅限本地子进程** — 插件本身不进行网络调用。
|
||||
- **无密钥** — Lobster 不管理 OAuth；它调用管理 OAuth 的 OpenClaw 工具。
|
||||
- **沙箱感知** — 当工具上下文处于沙箱隔离状态时禁用。
|
||||
- **加固** — 如果指定，`lobsterPath` 必须是绝对路径；强制执行超时和输出上限。
|
||||
|
||||
## 故障排除
|
||||
|
||||
- **`lobster subprocess timed out`** → 增加 `timeoutMs`，或拆分长流水线。
|
||||
- **`lobster subprocess timed out`** → 增加 `timeoutMs`，或拆分长管道。
|
||||
- **`lobster output exceeded maxStdoutBytes`** → 提高 `maxStdoutBytes` 或减少输出大小。
|
||||
- **`lobster returned invalid JSON`** → 确保流水线以工具模式运行且仅输出 JSON。
|
||||
- **`lobster failed (code …)`** → 在终端中运行相同的流水线以检查 stderr。
|
||||
- **`lobster returned invalid JSON`** → 确保管道以工具模式运行并只打印 JSON。
|
||||
- **`lobster failed (code …)`** → 在终端中运行相同的管道以检查 stderr。
|
||||
|
||||
## 了解更多
|
||||
|
||||
@@ -342,7 +343,7 @@ OpenProse 与 Lobster 配合良好：使用 `/prose` 编排多智能体准备工
|
||||
|
||||
## 案例研究：社区工作流
|
||||
|
||||
一个公开示例：一个"第二大脑" CLI + Lobster 流水线，管理三个 Markdown 库（个人、伴侣、共享）。CLI 输出 JSON 格式的统计数据、收件箱列表和过期扫描；Lobster 将这些命令串联成工作流，如 `weekly-review`、`inbox-triage`、`memory-consolidation` 和 `shared-task-sync`，每个都带有审批门控。AI 在可用时处理判断（分类），不可用时回退到确定性规则。
|
||||
一个公开示例：一个"第二大脑" CLI + Lobster 管道，管理三个 Markdown 库（个人、伴侣、共享）。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
|
||||
|
||||
Reference in New Issue
Block a user