OpenSquilla CLI 完全指南:安装、命令体系与自动化实战

原创2026-10-08 18:50:181,743 阅读
文章标签:AI Agent人工智能大模型MCP ClientsMCP 服务即时通讯LLM 网关工具调用CLI前端桌面应用Agent 记忆

OpenSquilla CLI 完全指南:安装、命令体系与自动化实战

opensquilla 命令行工具是 OpenSquilla 最快捷的配置、运行、巡检与自动化入口:它既能驱动完整的 Gateway(网关)服务与 Web UI,也能以单次调用的方式执行 Agent 回合、输出机器可读的结果,还能管理技能(Skills)、会话(Sessions)、记忆(Memory)、定时任务(Cron)、渠道(Channels)与卸载。读完本文,你将掌握 OpenSquilla CLI 的安装方式、全部主命令的用途与用法、agent 单回合自动化的关键参数与稳定事件流协议,以及并行子进程的正确隔离姿势,可直接用于脚本编排、CI 集成与日常运维。

安装与基本用法

独立安装 Python/uv CLI

opensquilla CLI 是独立于 OpenSquilla Desktop 的 Python/uv 安装形态。Windows Desktop 安装器不会注册全局 opensquilla 命令,Desktop 用户应通过开始菜单或任务栏启动应用。要单独安装命令行界面,使用 uv tool install 指定 Python 3.12 与 release wheel:

uv tool install --python 3.12 "opensquilla[recommended] @ https://github.com/TokenRhythm/opensquilla/releases/download/v0.5.5/opensquilla-0.5.5-py3-none-any.whl"

运行:

opensquilla --help
opensquilla <command> --help

从源码结构看,CLI 是基于 Typer 构建的多级命令应用,入口位于 src/opensquilla/cli/main.py,顶部会先完成 Unicode 标准流配置、.env 加载与 profile 预激活(通过 --profile 全局选项或 OPENSQUILLA_PROFILE 环境变量),随后才分发到各子命令模块。因此所有子命令都自动支持全局的 --profile 参数,用于切换命名 profile 主目录。

主命令一览

命令 用途
opensquilla init 初始化工作区。
opensquilla doctor 诊断就绪状态并打印恢复步骤。
opensquilla uninstall 移除 OpenSquilla;默认保留数据(--purge-* 才删除)。
opensquilla onboard 运行或查看首次设置。
opensquilla configure 重新配置 provider、router、channels、search、image generation 或 memory embedding。
opensquilla gateway 运行和管理网关服务。
opensquilla chat 启动交互式终端聊天。
opensquilla agent 运行一次面向自动化的 Agent 回合。
opensquilla sessions 列出、查看、恢复、中止、删除或导出会话。
opensquilla skills 列出、搜索、查看、安装、更新、发布与检查技能。
opensquilla memory 检查与维护记忆。
opensquilla channels 配置与检查消息渠道。
opensquilla providers 配置与检查 LLM 提供商。
opensquilla search 配置与使用 Web 搜索。
opensquilla sandbox 检查或更改默认沙箱姿态。
opensquilla cron 管理定时运行的 OpenSquilla 任务。
opensquilla cost 检查用量与预估成本。
opensquilla diagnostics 启用或禁用运行时诊断日志。
opensquilla replay 从决策日志重放某个已记录的回合。
opensquilla migrate 从外部 Agent 运行时导入状态。
opensquilla models 检查可用模型。
opensquilla agents 管理持久化 Agent。
opensquilla mcp-server 运行 OpenSquilla MCP 服务器桥。
opensquilla dist 生成可复现的工作区状态清单。
opensquilla reset 归档 transcript 与摘要,然后重置会话。

除表格外,CLI 还包含若干隐藏但实用的能力:opensquilla version(支持 --check 检查 GitHub 上是否有更新的发布版本)、opensquilla bundle(打包近 N 天日志的支持包,默认 3 天,可用 --include-content 附带原始回合抓取内容)、opensquilla ensemble bench(LLM 集成基准)、opensquilla router calibrate(路由器校准)以及 recovery 系列离线恢复命令,它们分别实现在 bundle_cmd.py、ensemble_cmd.py、router_cmd.py 与 recovery_cmd.py。

三种运行面(Run Surfaces)

Web UI 与 Gateway

opensquilla gateway run
opensquilla gateway start --json
opensquilla gateway status
opensquilla gateway restart
opensquilla gateway stop

gateway run 以前台方式启动 ASGI 网关(底层为 uvicorn),start/status/restart/stop 则围绕一个生命周期管理器工作:它通过 pidfile 记录托管进程、轮询健康端点等待就绪、停止时先优雅排空再按超时兜底强杀(默认 graceful 排空后,--shutdown-timeout 默认 10 秒作为 SIGKILL 截止线),具体逻辑见 gateway_lifecycle.py。生命周期命令还支持:

  • --port/--bind/--listen:覆盖绑定端口与主机,--listen 优先于 --bind;默认端口来自配置(通常 18791),默认绑定 127.0.0.1。端口会经过 port_validation.py 校验。
  • --gateway:status 可检查远程网关 URL,restart/stop 也可配合 --config 定位目标。
  • --json:所有生命周期操作都支持机器可读输出。

终端聊天

opensquilla chat
opensquilla chat --model gpt-5.4-mini
opensquilla chat --session <session-key>
opensquilla chat --standalone --workspace /path/to/project

chat 还支持 --ui auto|tui|plain(默认 auto 自动选择渲染后端)、--timeout/-T(总超时秒数,0 表示不限)以及独立模式下的 --workspace-strict/--no-workspace-strict(把读侧文件工具限制在工作区内)。--standalone 会绕过 Gateway,直接以本地 Agent 运行聊天(见 chat_cmd.py 与 chat/standalone_runtime.py)。

发布安装使用稳定的 Python 原生终端后端。全屏 OpenTUI 宿主目前仅限开发环境使用,不作为 release 资产发布;可在源码检出目录中先固定 Bun 依赖再求值:

bun install --frozen-lockfile --cwd=src/opensquilla/cli/tui/opentui/package
OPENSQUILLA_TUI_DEV_SOURCE_HOST=1 uv run opensquilla chat --ui tui

如需显式选择“救援”渲染器,使用 --ui plain。终端聊天的用法见 docs/tui.md,后端架构、插件槽、Router HUD 与重放基准工作流见 docs/features/tui-frontend.md。

一次性自动化(One-Shot Agent)

opensquilla agent -m "Review the current directory"
opensquilla agent --json -m "Return a short machine-readable summary"
opensquilla agent --workspace /path/to/project --workspace-strict -m "Inspect this repo"
opensquilla agent --timeout 600 --max-iterations 30 -m "Run a bounded investigation"

自动化常用参数:

参数 用途
--workspace 设置工作区根目录。
--workspace-strict 把读侧文件工具限制在工作区内。
--workspace-lockdown 把写入约束在工作区或 scratch 目录内。
--scratch-dir 把临时脚本/日志/候选补丁放到已知目录。
--timeout 设置 Agent 总墙钟超时。
--max-iterations 限制模型/工具循环次数。
--max-provider-retries 限制瞬时性 provider 重试次数。
--length-capped-continuations 限制 provider 输出达到长度上限后的自动续写次数。
--thinking 覆盖推理等级。
--permissions 选择 restricted、bypass 或 full 权限姿态。
--transcript-path 为自动化写入 JSONL transcript。
--usage-path 写入用量 JSON。
--event-stream-stderr 在 stderr 上流式输出稳定的 v1 进度事件 JSONL。
--session-db-path 跨调用持久化会话回放。

实现位于 agent_cmd.py 的 run_agent_command:这些标志直接映射到 run_agent_once 的内部参数。补充几个源码中可确认的细节:

  • --timeout/-T 的单位是秒,0 表示不限;--max-iterations 最小值 0(0 表示不限)。
  • --thinking 的可选值为 off|minimal|low|medium|high|xhigh|adaptive,通过 _with_agent_thinking_config 注入运行配置。
  • --workspace-lockdown 可配合 --workspace-lockdown-deny-paths 附加“工作区相对写拒绝 glob”,实现更细粒度的写入遏制。
  • --permissions 未显式给出时,依次回退到 OPENSQUILLA_AGENT_PERMISSIONS 环境变量与配置中的 permissions.default_mode。
  • --file/-f 可重复传入本地文件作为附件(--file path1 --file path2)。
  • --unattended/--interactive 默认走 unattended(无实时审批面);--stateless(别名 --clean-room)使用干净房间式提示引导,不改变 unattended 语义;--stateless-keep-project-rules 可在干净房间引导下仅保留 AGENTS.md 项目规则。
  • --request-timeout-seconds 控制单次 LLM HTTP/流式请求超时;--iteration-timeout-seconds 与 --tool-timeout-seconds 是已废弃的兼容选项,会被忽略。
  • 单次运行默认不写入持久化记忆,--no-memory-capture 可显式声明;--session-db-path 默认 :memory:。

Agent 进度事件流(v1)

--event-stream-stderr 是可选开启的:它不改变最终 stdout 载荷或退出状态。每个受支持的事件会以一条紧凑 JSON 对象的形式刷新到 stderr,信封格式如下:

{"_event":true,"schema_version":1,"kind":"thinking"}

stderr 上同时可能存在普通诊断输出,因此子进程消费者必须持续排空(drain)stderr、逐行解析,并且只接受 _event 值为 true 的对象。stderr 一旦关闭或不可写,进度事件会被禁用,但不会导致本应成功的 Agent 运行失败。

v1 事件字段刻意比引擎内部的事件 dataclass 更少、更稳定:

kind 附加字段
router_decision tier, model, source
thinking 无
text_delta presentation
run_heartbeat phase, elapsed_ms, idle_ms
tool_use_start tool_use_id, tool_name, started_at
tool_result tool_use_id, tool_name, is_error
warning, error code, 脱敏且受限的 message
artifact id, name, mime, size
done 无;最终结果从 stdout 读取

事件流不暴露:推理文本、回答文本、工具参数、工具结果、内部路由概率、会话路径,以及未来引擎事件中新增的字段。不支持的内部事件会被跳过。消费者可以依赖上述稳定的顶层字段,同时必须忽略未来兼容的 v1 生产者可能新增的附加字段。

这些约束在源码中有直接对应:project_agent_event_v1 将引擎的 RouterDecisionEvent、ThinkingEvent、TextDeltaEvent、RunHeartbeatEvent、ToolUseStartEvent、ToolResultEvent、WarningEvent、ErrorEvent、ArtifactEvent、DoneEvent 投影为上述稳定载荷(见 agent_event_stream.py)。其中 warning/error 的 code 被截断到 200 字符、message 经脱敏函数处理且总长受限(_EVENT_MESSAGE_MAX_CHARS = 4096);StderrAgentEventSink 采用“第一次失败即自我禁用”的 best-effort 策略,并打印一行诊断提示。

并发 Agent 子进程的隔离

每个具备写能力的 Agent 都持有 profile 级写者租约。因此共享同一 OPENSQUILLA_STATE_DIR 的调用会互相冲突,而不是并发写入同一个 profile。需要并行运行 Agent 的编排者,必须为每个子进程同时提供独立的 profile 主目录与独立的 gateway 状态根:

OPENSQUILLA_STATE_DIR=/tmp/agent-a \
OPENSQUILLA_GATEWAY_STATE_DIR=/tmp/agent-a/state \
  opensquilla agent -m "task A" --json &

注意:单独的 OPENSQUILLA_STATE_DIR 不能覆盖来自以下来源的 state_dir:当前目录 opensquilla.toml、显式 gateway 配置、或复制过来的 profile。复制 config.toml 或 .env 时,必须删除或重写其中的 state_dir 与 OPENSQUILLA_GATEWAY_STATE_DIR。当输出文件需要隔离时,还要为每个子进程选择互不相同的 --session-db-path、workspace、scratch、transcript 与 usage 路径。在 Windows 上,应在每个子进程中分别传递这两个环境变量,而不是依赖 POSIX 的行内赋值语法。

配置命令

Provider 与 Router

opensquilla onboard
opensquilla onboard status
opensquilla configure provider --provider openrouter --api-key-env OPENROUTER_API_KEY
opensquilla configure router --router recommended
opensquilla providers list
opensquilla providers configure openrouter
opensquilla providers status
  • onboard 是完整的一站式引导:除 provider 外还覆盖 router、channels、search、image generation、memory embedding 与可选的旧版迁移(OpenClaw/Hermes)。可用 --minimal 只保留核心字段,--skip-channels、--skip-search、--skip-image-generation、--skip-migration 分别跳过对应环节,--if-needed 仅在必需设置不完整时运行向导,--probe 配合 --provider 时会对已保存 provider 做一次小额在线探测并(CI 友好地)失败时以非零码退出。onboard status 展示各环节的就绪情况。
  • configure 通过 SECTION 参数定位目标:provider、router、ensemble、channels、search、image(image-generation 别名)或 memory(memory-embedding 别名)。以 provider 为例,--provider 指定文本 provider id,--preset 可显式应用 router preset,--model/--api-key/--api-key-env/--base-url/--proxy 为共享键与端点参数;router 支持 --router recommended|openrouter-mix|disabled 与 --default-tier(默认文本层)。
  • configure 还支持 LLM ensemble(--enabled/--disabled、--selection-mode、--model-options、--min-successful-proposers)、search(--search-provider、--max-results、--use-env-proxy、--fallback-policy off|network、--diagnostics)、channels(--channel-type、--name、--token、可重复的 --field key=value)、image generation(--image-provider、--image-enabled、--primary 模型 id)与 memory embedding(--memory-provider、--onnx-dir 本地 ONNX 目录)。
  • providers list 列出可用 provider;providers configure <provider> 支持 --model、--api-key/-k、--base-url、--proxy;providers status [provider] 检查配置状态,--probe-models 会对活动 provider 做模型列表探测。
  • init 是兼容旧脚本的“初始化工作区”命令(deprecated,官方建议改用 onboard),其实现见 init_cmd.py:交互式选择 provider(tokenrhythm/openrouter/openai/anthropic/deepseek/custom),把 API key 写入 ~/.opensquilla/.env(如 OPENROUTER_API_KEY=),把 llm.provider、llm.model、state_dir 写入 config.toml。

搜索(Search)

opensquilla search list
opensquilla search configure duckduckgo
opensquilla search query "latest OpenSquilla release"
opensquilla configure search --search-provider duckduckgo
  • search configure <provider>:--api-key/-k、--api-key-env、--max-results(默认见 search_cmd.py 中 DEFAULT_SEARCH_MAX_RESULTS)、--proxy、--use-env-proxy/--no-use-env-proxy(让搜索复用 Gateway 环境中的 HTTP(S)_PROXY)、--fallback-policy(默认 off)、--diagnostics/--no-diagnostics(附带 provider 尝试/错误详情便于排障)。
  • search query <query>:可直接发起搜索,支持 --provider、--limit、--mode auto|news|technical|broad 研究模式、--max-results、--fetch-top-k、--max-chars-per-source、可重复的 --include-domain/--exclude-domain 与 --recency。
  • 另有 search status [provider] 与 search benchmark(离线 smoke 或 --live 在线基准)。

渠道(Channels)

opensquilla channels types
opensquilla channels describe telegram
opensquilla channels add telegram --name personal
opensquilla channels list
opensquilla channels status
opensquilla channels enable personal
opensquilla channels disable personal
opensquilla channels restart personal
opensquilla channels remove personal

channels add <type> --name <name> 还可携带 --token、--enabled/--disabled(默认启用)、--agent-id(默认 main)与可重复的 --field key=value;channels edit 支持 --enabled/--disabled、--token、--agent-id、--field。channels status <a href="https://link.gitcode.com/i/59d03922ca71117d8ce924bc6217c04a" target="_blank">name] 可定向查看某个渠道实例。在 [channels_cmd.py 中还提供了更深的运维命令:channels certify(对渠道做安全认证探测,可选 --send-test-message 与 --allow-side-effects)、channels pairings list/approve/revoke(管理设备配对:pairings approve --admin 可将配对者提升为渠道管理员),以及 channels logout。

原始配置读写

opensquilla config get llm.provider
opensquilla config set port 18791

config get 传空 key 时打印全部配置;config set 接受点号表示法的 key,并会把字符串值按目标字段类型解析后写入(--config 可覆盖配置路径),实现见 config_cmd.py。

更多细节见 docs/configuration.md、docs/providers-and-models.md、docs/search.md 与 docs/channels.md。

技能(Skills)管理

opensquilla skills list
opensquilla skills search pdf
opensquilla skills search pdf --json --include-diagnostics
opensquilla skills view pdf-toolkit
opensquilla skills install <install-reference> --source <clawhub|skillhub|github>
opensquilla skills install <install-reference> --source <clawhub|skillhub|github> \
  --force --risk-confirmation <token>
opensquilla skills update --install-id <install-id>
opensquilla skills update --all
opensquilla skills uninstall <skill-name>
opensquilla skills uninstall --install-id <install-id>
opensquilla skills doctor [<skill-name-or-install-id>] --json

skills search --json 为兼容旧客户端保留顶层数组;需要稳定的“结果 + 来源诊断”信封时,追加 --include-diagnostics。

源码层面(skills_cmd.py)可以确认的补充细节:

  • skills install 的 --source 支持 clawhub、skillhub、github。SkillHub 接受 registry 别名或 别名@版本;GitHub 接受 owner/repo、owner/repo@ref:path 或 GitHub URL。
  • 安装/更新若被安全扫描判定为危险,会返回 SCAN_CONFIRMATION_REQUIRED 诊断并附 confirmationToken,提示使用 --force --risk-confirmation <token> 重试(_risk_confirmation_token 会从诊断 details 中提取 token)。
  • skills update 支持按 --install-id 或 --name 更新单个技能、--all 更新全部;skills uninstall 支持按名称或 --install-id,存在本地文件漂移时需 --allow-drift 确认。
  • skills doctor [name-or-install-id] --json 做单技能体检;skills reload 可热加载运行中的技能目录;skills publish 把技能目录提交为目标仓库的 PR;skills tap add owner/repo 与 tap list/remove 管理技能 tap 源。

技能体系详见 docs/features/skills.md。

会话与历史

opensquilla sessions list
opensquilla sessions show <session-key>
opensquilla sessions resume <session-key>
opensquilla sessions abort <session-key>
opensquilla sessions export <session-key>
opensquilla sessions delete <session-key>

list 支持 --limit/-n(默认 50)、--agent、--status、--channel 与 --since(ISO 日期/时间或 epoch 秒/毫秒时间戳)过滤;export 支持 --output/-o 与 --format md|json(md 由 messages_to_markdown 生成);delete 支持 -y/--yes 跳过确认。这些命令通过 Gateway RPC(gateway_rpc.py 的 run_gateway_sync)与默认网关 URL 交互,详见 sessions_cmd.py。

会话模型细节见 docs/sessions.md。

记忆(Memory)

opensquilla memory status
opensquilla memory index
opensquilla memory list
opensquilla memory search "preference"
opensquilla memory show <path>
opensquilla memory dream
  • memory status --deep 包含更详细的检索健康检查;memory index --force 强制重建索引行并重扫来源。
  • memory search <query> 支持 --limit/-n(默认 10)、--agent 与 --source memory|sessions|all。
  • memory show <path> 可查看记忆源文件,--from-line/--lines 控制读取范围。
  • memory dream 是“记忆梦境”维护流程:--force 重置游标并处理全部文件,--status 只显示游标与待处理文件数,--reset-cursor 清除游标文件。

这些子命令的入口定义在 main.py。记忆机制详见 docs/features/memory.md。

持久化 Agent 与定时调度

opensquilla agents list
opensquilla agents add research --name Research --workspace /path/to/research
opensquilla agents delete research
opensquilla cron list
opensquilla cron add --every 1h --text "Summarize important updates" --name hourly-summary
opensquilla cron status <job-id>
opensquilla cron runs <job-id>
  • agents add <id> 支持 --model(默认模型)、--workspace、--name、--description 与 --config;agents delete <id> 支持 --force 跳过确认,实现在 agents_cmd.py。
  • cron add 是参数最丰富的子命令之一(cron_cmd.py):
    • 调度方式三选一:--expression/--cron(cron 表达式)、--every(固定间隔,如 30s、5m、1h,也接受纯数字秒)、--at(带时区的一次性 ISO-8601 时刻);--tz 指定 IANA 时区(缺省为 UTC),空串可清除回 UTC 匹配。
    • 任务形态:--job-kind auto|reminder|agent_turn|system_event(auto 对非 main 目标创建静态提醒、对 main 创建系统事件);--session-target isolated|main|current|session。
    • 触发细节:--wake now|next-heartbeat(main 会话任务)、--exact(严格准点,jitter=0)与 --jitter(显式抖动,可 30s/5m/1h 或秒数,优先级高于 --exact)。
    • 投递:--channel(如 slack、feishu;last 或省略则由后端依据会话最后路由推断)、--to(渠道特定接收人)、--account(多账号时的账号 id)、--announce、--no-deliver、--best-effort-deliver,以及 webhook 投递 --webhook-url + 令牌(--webhook-token 会出现在 shell 历史里,优先用 --webhook-token-env 或 --webhook-token-file)。
    • 失败告警路由:--failure-mode channel|webhook,配套 --failure-channel/--failure-to/--failure-account 或 --failure-webhook-url 与对应的 --failure-webhook-token(-env|-file)。
    • --timeout 限制运行时长;--text 为必填任务提示词;--name 设置显示名。
  • cron update <job-id> 可补丁式更新调度、文本、开关(--enabled/--disabled)、超时、时区、wake 模式与失败告警路由(主投递字段不可补丁,改投递需删除后重建);cron remove、cron run(立即手动触发)、cron runs --limit(默认 20)齐备。

相关文档:docs/agents.md 与 docs/scheduling.md。

成本、诊断与重放

opensquilla cost
opensquilla diagnostics status
opensquilla diagnostics on
opensquilla diagnostics off
opensquilla replay --session <session-key> --turn <turn-id>
  • cost 支持 --by-model 按模型聚合用量与预估成本,--json 输出机器可读结果(cost_cmd.py)。
  • diagnostics on 可追加 --raw 同时开启原始回合调用抓取(供后续 replay 使用);diagnostics off 关闭;status 查看当前状态。此外还有 smoke imports(导入冒烟,默认覆盖桌面打包运行时能力集)与 smoke router 两条诊断冒烟命令。
  • replay --session <key> --turn <id> 从决策日志重放指定回合(replay.py),用于理解某个回合为何表现如此。

需要理解回合行为时,优先使用 diagnostics 与 replay。配套文档:docs/usage-and-cost.md、docs/diagnostics-and-replay.md。

MCP 服务器桥

MCP 支持已包含在当前源码的基础安装中。SDK 2.x 的源码安装与发布安装选项见 docs/mcp-server.md 的 “Requirements” 一节。从支持 MCP 的客户端启动 stdio 桥之前,先启动 Gateway:

opensquilla mcp-server run
opensquilla mcp-server run --gateway ws://localhost:18792/ws

--gateway 可通过 OPENSQUILLA_GATEWAY_URL 环境变量提供;缺省时使用当前所选 profile 配置的网关,未配置则回退到 ws://localhost:18791/ws(mcp_server_cmd.py)。更多细节见 docs/mcp-server.md。

卸载与数据安全

opensquilla uninstall --dry-run        # 预览将被移除与保留的内容
opensquilla uninstall                  # 移除程序,保留数据
opensquilla uninstall --purge-state    # 同时删除运行时状态(会话、日志、缓存)
opensquilla uninstall --purge-config   # 同时删除配置与密钥
opensquilla uninstall --purge-all      # 删除全部 OpenSquilla 数据(需输入确认短语)
opensquilla uninstall --json           # 机器可读的计划/结果

数据默认保留,--purge-* 才是显式选择删除:

  • --purge-state:会话、调度器、记忆、日志、缓存。
  • --purge-config:config.toml、.env 等配置与密钥。
  • --purge-all:隐式包含 state+config,交互式界面必须输入确认短语;非交互界面需 --confirm-purge-all "delete everything"。源码中该短语由 uninstall.safety.PURGE_ALL_CONFIRM_PHRASE 定义,且任何非 TTY / --json 表面在未提供 --yes 时拒绝执行(uninstall_cmd.py)。
  • 卸载动作开始前会先排空并停止正在运行的 Gateway(_lifecycle_stop 通过 GatewayLifecycleManager 处理);删除范围严格限定在 OpenSquilla 主目录内,已迁移或共享的根目录会被拒绝。
  • Docker 与 Desktop 安装只打印引导式移除步骤,不删除镜像层或应用包;源码安装永远不会删除你的检出目录。

相关文档:docs/README.md(文档索引)、README.product.md(产品指南)、docs/contributing-docs.md(文档贡献规范)。


以上就是 OpenSquilla CLI 从安装、主命令到自动化的完整参考。核心要点回顾:CLI 与 Desktop 相互独立,uv tool install 是唯一安装路径;所有管理类子命令通过 Gateway RPC 工作,因此 gateway start 常常是许多命令(sessions、cron、cost、diagnostics、skills 变更类)的前置条件;面向脚本与 CI 时优先使用 --json 输出、--event-stream-stderr 的 v1 事件协议(务必持续排空并过滤 _event:true),并行自动化则严格隔离 OPENSQUILLA_STATE_DIR 与 OPENSQUILLA_GATEWAY_STATE_DIR;卸载永远默认保留数据,全量删除需显式确认短语。

登录后查看全文
opensquilla