From 498692dd0c5ef12e9700c3717fb2eafd0fbfedb4 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Mon, 4 May 2026 05:56:39 +0000 Subject: [PATCH] chore(i18n): refresh zh-CN translations --- docs/zh-CN/cli/sessions.md | 46 ++++++++++++++++++++++++++------------ 1 file changed, 32 insertions(+), 14 deletions(-) diff --git a/docs/zh-CN/cli/sessions.md b/docs/zh-CN/cli/sessions.md index 8eb322a3a..cff250fda 100644 --- a/docs/zh-CN/cli/sessions.md +++ b/docs/zh-CN/cli/sessions.md @@ -1,13 +1,13 @@ --- read_when: - - 你想列出已存储的会话并查看最近活动 + - 你想列出已存储的会话并查看近期活动 summary: '`openclaw sessions` 的 CLI 参考（列出已存储的会话 + 用法）' title: 会话 x-i18n: - generated_at: "2026-05-02T12:44:54Z" + generated_at: "2026-05-04T05:56:13Z" model: gpt-5.5 provider: openai - source_hash: 5c9ec3ca55f7c5b6217b481e9da62f5416df73e69405a0dc15e77d2afeac723f + source_hash: 8dc90344f40c53513bd6db3696bc709279155f26e7c3b6ea27e81a07a2f9f15e source_path: cli/sessions.md workflow: 16 --- @@ -16,7 +16,17 @@ x-i18n: 列出已存储的对话会话。 -会话列表不是渠道/提供商的活性检查。它们显示来自会话存储的持久化对话行。安静的 Discord、Slack、Telegram 或其他渠道可以成功重新连接，而不会创建新的会话行，直到处理消息为止。当你需要实时渠道连接性时，请使用 `openclaw channels status --probe`、`openclaw status --deep` 或 `openclaw health --verbose`。 +会话列表不是渠道/提供商存活检查。它们显示会话存储中持久化的 +对话行。安静的 Discord、Slack、Telegram 或 +其他渠道可以成功重新连接，但在处理消息之前不会创建新的会话行。 +当你需要实时 +渠道连接状态时，请使用 `openclaw channels status --probe`、 +`openclaw status --deep` 或 `openclaw health --verbose`。 + +Gateway 网关 `sessions.list` 响应默认有边界限制，因此大型长期存在的 +存储无法独占 Gateway 网关事件循环。当需要不同的结果窗口时，RPC 客户端应传入显式的正数 +`limit`；当调用方需要显示 +还有更多行存在时，响应会包含 `totalCount`、`limitApplied` 和 `hasMore`。 ```bash openclaw sessions @@ -29,7 +39,7 @@ openclaw sessions --json 范围选择： -- 默认：已配置的默认智能体存储 +- 默认：配置的默认智能体存储 - `--verbose`：详细日志 - `--agent `：一个已配置的智能体存储 - `--all-agents`：聚合所有已配置的智能体存储 @@ -42,9 +52,15 @@ openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:12 openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --output bug-123 --json ``` -这是所有者批准执行请求后 `/export-trajectory` 斜杠命令使用的命令路径。输出目录始终解析到所选工作区下的 `.openclaw/trajectory-exports/` 内。 +这是所有者批准执行请求后，`/export-trajectory` 斜杠命令使用的命令路径。 +输出目录始终解析到所选工作区下的 +`.openclaw/trajectory-exports/` 内。 -`openclaw sessions --all-agents` 会读取已配置的智能体存储。Gateway 网关和 ACP 会话发现范围更广：它们还会包含在默认 `agents/` 根目录或模板化 `session.store` 根目录下找到的仅磁盘存储。这些发现的存储必须解析为智能体根目录内的常规 `sessions.json` 文件；符号链接和根目录外路径会被跳过。 +`openclaw sessions --all-agents` 会读取已配置的智能体存储。Gateway 网关和 ACP +会话发现范围更广：它们还会包含在默认 +`agents/` 根目录或模板化 `session.store` 根目录下找到的仅磁盘存储。这些 +发现的存储必须解析为智能体根目录内的常规 `sessions.json` 文件； +符号链接和根目录外路径会被跳过。 JSON 示例： @@ -82,19 +98,21 @@ openclaw sessions cleanup --json `openclaw sessions cleanup` 使用配置中的 `session.maintenance` 设置： -- 范围说明：`openclaw sessions cleanup` 维护会话存储、转录记录和轨迹附属文件。它不会清理 cron 运行日志（`cron/runs/.jsonl`），这些日志由 [Cron 配置](/zh-CN/automation/cron-jobs#configuration)中的 `cron.runLog.maxBytes` 和 `cron.runLog.keepLines` 管理，并在 [Cron 维护](/zh-CN/automation/cron-jobs#maintenance)中说明。 +- 范围说明：`openclaw sessions cleanup` 会维护会话存储、转录记录和轨迹旁路文件。它不会修剪 cron 运行日志（`cron/runs/.jsonl`），这些日志由 [Cron 配置](/zh-CN/automation/cron-jobs#configuration) 中的 `cron.runLog.maxBytes` 和 `cron.runLog.keepLines` 管理，并在 [Cron 维护](/zh-CN/automation/cron-jobs#maintenance) 中说明。 -- `--dry-run`：预览会裁剪/限制多少条目，而不写入。 - - 在文本模式下，dry-run 会打印按会话列出的操作表（`Action`、`Key`、`Age`、`Model`、`Flags`），因此你可以看到哪些会保留、哪些会移除。 +- `--dry-run`：预览会修剪/封顶多少条目，而不写入。 + - 在文本模式下，试运行会打印每个会话的操作表（`Action`、`Key`、`Age`、`Model`、`Flags`），这样你可以看到哪些会保留、哪些会移除。 - `--enforce`：即使 `session.maintenance.mode` 为 `warn`，也应用维护。 -- `--fix-missing`：移除转录记录文件缺失的条目，即使它们通常还不会因年龄/数量而淘汰。 -- `--active-key `：保护特定活跃键免受磁盘预算驱逐。持久的外部对话指针（例如群组会话和线程范围的聊天会话）也会在年龄/数量/磁盘预算维护中保留。 +- `--fix-missing`：移除转录记录文件缺失的条目，即使它们通常还不会因年龄/数量而被淘汰。 +- `--active-key `：保护指定的活跃键不被磁盘预算驱逐。持久的外部对话指针，例如群组会话和线程范围聊天会话，也会在年龄/数量/磁盘预算维护中保留。 - `--agent `：为一个已配置的智能体存储运行清理。 - `--all-agents`：为所有已配置的智能体存储运行清理。 -- `--store `：针对特定的 `sessions.json` 文件运行。 +- `--store `：针对特定 `sessions.json` 文件运行。 - `--json`：打印 JSON 摘要。使用 `--all-agents` 时，输出会包含每个存储的一份摘要。 -当 Gateway 网关可访问时，已配置智能体存储的非 dry-run 清理会通过 Gateway 网关发送，因此它与运行时流量共享同一个会话存储写入器。使用 `--store ` 对存储文件执行显式离线修复。 +当 Gateway 网关可达时，已配置智能体存储的非试运行清理会 +通过 Gateway 网关发送，因此它与运行时 +流量共享相同的会话存储写入器。使用 `--store ` 对存储文件进行显式离线修复。 `openclaw sessions cleanup --all-agents --dry-run --json`：