Seashail

CLI 参考

Seashail 所有命令和子命令的命令行界面参考。

Seashail 提供命令行界面,用于运行 MCP 服务器、管理智能体配置、诊断和升级。本页记录所有可用命令及其标志和使用示例。

没有 seashail wallet 命令。钱包操作仅通过 MCP 工具进行。请通过 MCP 客户端调用 create_walletimport_wallet 和其他钱包工具。

seashail mcp

通过 stdio 运行 MCP 服务器。默认情况下,这会启动一个轻量级 stdio 代理,将请求转发给单例本地 Seashail 守护进程(使多个智能体可以共享一个密钥和策略状态)。

标志

Prop

Type

示例

以代理模式启动 MCP 服务器(推荐):

seashail mcp

以测试网覆盖模式启动:

seashail mcp --network testnet

以独立模式启动(无守护进程共享):

seashail mcp --standalone

注意事项

  • 代理模式(默认)允许多个智能体进程共享一个守护进程状态(密钥存储、密码短语会话、策略)。
  • 代理在守护进程未运行时会自动启动它。
  • 使用 --standalone 进行隔离测试或单智能体场景。
  • 有关代理进程/守护进程关系的详细信息,请参阅架构

seashail daemon

运行单例 Seashail 守护进程。守护进程持有独占密钥存储锁,并管理所有 MCP 客户端的密码短语会话。

标志

Prop

Type

示例

运行守护进程直至终止:

seashail daemon

运行守护进程,空闲 5 分钟后自动退出:

seashail daemon --idle-exit-seconds 300

注意事项

  • 通常不需要手动运行——代理模式下的 seashail mcp 会自动启动守护进程。
  • 守护进程在 $DATA_DIR/seashail-daemon.lock 处持有独占文件系统锁,以防止状态分裂。
  • 当所有 MCP 客户端断开连接时,空闲计时器开始计时。如果设置了 --idle-exit-seconds,守护进程在该时长后退出。

seashail paths

打印数据目录、配置目录和日志文件的解析路径。用于调试配置问题。

标志

无标志。

示例

seashail paths

输出(JSON):

{
  "config_dir": "/Users/you/.config/seashail",
  "data_dir": "/Users/you/.local/share/seashail",
  "log_file": "/Users/you/.local/share/seashail/seashail.log.jsonl"
}

注意事项

  • 路径遵循平台约定(Linux 上的 XDG、macOS 应用程序支持、Windows AppData)。
  • 使用 SEASHAIL_CONFIG_DIRSEASHAIL_DATA_DIR 环境变量进行覆盖。

seashail doctor

打印快速自诊断报告。报告不包含任何秘密信息,可以安全地粘贴到 issue 或支持请求中。

标志

Prop

Type

示例

人类可读报告:

seashail doctor

机器可读 JSON:

seashail doctor --json

注意事项

  • 报告包含版本信息、解析路径、钱包数量、策略摘要和基本连接检查。
  • 可安全公开粘贴——不包含私钥、密码短语或地址。

seashail agent list

列出 printinstall 命令支持的智能体目标。

标志

无标志。

示例

seashail agent list

输出(JSON):

[
  { "name": "cursor", "config_path": "~/.cursor/mcp_config.json" },
  { "name": "vscode", "config_path": "~/.vscode/mcp_config.json" },
  { "name": "windsurf", "config_path": "~/.windsurf/mcp_config.json" },
  {
    "name": "claude-desktop",
    "config_path": "~/Library/Application Support/Claude/claude_desktop_config.json"
  }
]

注意事项

  • 目前支持 Cursor、VSCode、Windsurf 和 Claude Desktop。
  • agent printagent install 中使用这些目标名称。

seashail agent print

将特定智能体目标的完整 JSON 配置模板打印到 stdout。用于在安装前检查配置。

标志

Prop

Type

示例

打印 Cursor 配置:

seashail agent print cursor

打印测试网配置:

seashail agent print cursor --network testnet

注意事项

  • 输出是有效的 JSON,可以管道传输到文件或直接安装。
  • 模板包含带有适当标志的正确 seashail mcp 命令。

seashail agent install

将配置模板安装到智能体的默认配置路径(或通过 --path 指定的自定义路径)。

标志

Prop

Type

示例

安装到默认位置:

seashail agent install cursor

安装测试网配置:

seashail agent install cursor --network testnet

安装到自定义路径:

seashail agent install cursor --path ~/my-config.json

注意事项

  • 如果配置文件已存在,将提示你确认覆盖。
  • 安装后,重启你的智能体/编辑器以加载新配置。

seashail openclaw install

安装或管理 OpenClaw 插件集成。这为 OpenClaw 提供更完善的 Seashail 工具支持。

标志

Prop

Type

示例

使用默认设置安装:

seashail openclaw install

以测试网模式安装:

seashail openclaw install --network testnet

使用本地插件进行开发安装:

seashail openclaw install --link --plugin ./packages/openclaw-seashail-plugin

注意事项

  • 此命令在底层运行 openclaw plugins install 并更新 OpenClaw 配置。
  • --restart-gateway 自动重启 OpenClaw 的网关以接受更改。
  • --onboard-wallet 在没有钱包时创建默认钱包,使设置无障碍。

seashail upgrade

通过重新运行托管安装程序将 Seashail 升级到最新版本。

标志

Prop

Type

示例

交互式升级:

seashail upgrade

非交互式升级:

seashail upgrade --yes

静默升级(用于脚本):

seashail upgrade --yes --quiet

注意事项

  • 使用 SEASHAIL_UPGRADE_METHOD=installer 覆盖自动检测。
  • upgrade 命令检查当前版本,仅在有更新版本可用时才升级。

目录