运维
本指南介绍 day-two 命令：sessions、cron、cost、diagnostics、replay、迁移、durable agents、MCP 与安装清单。在首次成功的对话或 gateway 运行之后使用。
Sessions
Sessions 是持久化的对话/任务历史。可用于恢复、检查、导出或清理之前的工作。
opensquilla sessions list
opensquilla sessions show <session-key>
opensquilla sessions resume <session-key>
opensquilla sessions export <session-key>
opensquilla sessions abort <session-key>
opensquilla sessions delete <session-key>当精确的旧上下文很重要，或希望在聊天 UI 之外调试长时间运行的任务时，使用 session 导出。
关于 resume、abort、export 与清理工作流，参见 sessions.md。
Durable Agents
OpenSquilla 支持持久化的 agent 条目，包括内置的 main agent。
opensquilla agents list
opensquilla agents add research --name Research --workspace /path/to/research
opensquilla agents delete research当你希望为反复出现的角色配置独立的工作区、指令或工具档案时，使用 durable agents。修改 agent 配置后需要重启 gateway。
让每个 durable agent 的指令聚焦于其角色，而不是把每个 agent 都变成 main 的副本。
关于 agent 示例与概念，参见 agents.md。
Cron 与定时运行
Cron 任务按调度计划运行 OpenSquilla 任务。
查看任务：
opensquilla cron list
opensquilla cron status <job-id>
opensquilla cron runs <job-id>添加一个简单的重复提醒：
opensquilla cron add \
--every 1h \
--text "Check for urgent project updates and summarize them" \
--name hourly-project-check添加一个 cron 风格的每日任务：
opensquilla cron add \
--cron "0 9 * * 1-5" \
--tz "America/Los_Angeles" \
--text "Prepare my weekday morning briefing" \
--name weekday-briefing管理任务：
opensquilla cron update <job-id> --enabled
opensquilla cron remove <job-id>
opensquilla cron run <job-id>适用场景：
- 早间简报；
- 周期性研究摘要；
- PR 或 CI 检查；
- 通过 channel 投递的提醒；
- 定时的 memory 整合或汇报任务。
当输出应投递到本地 Web UI 之外的地方时，将 cron 与 channels 搭配使用。
关于调度示例、投递选项与排障，参见 scheduling.md。
成本与用量
查看用量与预估成本：
opensquilla cost
opensquilla cost --by-model
opensquilla cost --json在执行了重度工具调用、路由或长上下文任务之后，通过成本检查了解实际的运行时行为。
关于成本调查工作流，参见 usage-and-cost.md。
诊断
诊断在不改变核心任务的前提下帮助解释运行时行为。
opensquilla diagnostics status
opensquilla diagnostics on
opensquilla diagnostics off在调查以下问题时使用诊断：
- provider 重试行为；
- router 决策；
- cache break；
- compaction 事件；
- 工具结果压缩；
- channel 投递失败。
收集到所需证据后关闭诊断。
关于诊断使用指南与安全共享说明，参见 diagnostics-and-replay.md。
Replay
从决策日志中 replay 一个已记录的 turn：
opensquilla replay --session <session-key> --turn <turn-id>Replay 适用于复现某个 agent turn、查看决策元数据，或在原始对话继续之后调试行为。
迁移
先做预览：
opensquilla migrate openclaw --json
opensquilla migrate hermes --json审阅报告后再应用：
opensquilla migrate openclaw --apply
opensquilla migrate hermes --apply关于自定义路径与冲突处理，参见 ../MIGRATION.md。
MCP Server
当使用 mcp extra 安装后，OpenSquilla 可以运行一个 MCP server 桥接：
opensquilla mcp-server run安装命令：
uv tool install --python 3.12 "opensquilla[recommended,mcp] @ https://github.com/opensquilla/opensquilla/releases/download/v0.4.0/opensquilla-0.4.0-py3-none-any.whl"当其他支持 MCP 的客户端需要访问由 OpenSquilla 管理的 tools 或运行时接入面时，使用此功能。
关于设置详情，参见 mcp-server.md。
安装清单
输出可复现的工作区状态清单：
opensquilla dist适用于支持、发版 QA 或环境对比。
模型
查看可用模型：
opensquilla models list在该构建中，模型查看可由运行时支撑。如果无法连接，请先启动 gateway：
opensquilla gateway run如果想在不依赖运行中的 gateway 的情况下查看 provider 目录，使用：
opensquilla providers list健康检查清单
当安装或运行时令人困惑：
opensquilla doctor
opensquilla gateway status
opensquilla providers list
opensquilla search list
opensquilla channels types
opensquilla sandbox status仅当基本健康接入面信息不够时，再开启诊断。