CLI 参考
Seashail 所有命令和子命令的命令行界面参考。
Seashail 提供命令行界面,用于运行 MCP 服务器、管理智能体配置、诊断和升级。本页记录所有可用命令及其标志和使用示例。
没有
seashail wallet命令。钱包操作仅通过 MCP 工具进行。请通过 MCP 客户端调用create_wallet、import_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_DIR和SEASHAIL_DATA_DIR环境变量进行覆盖。
seashail doctor
打印快速自诊断报告。报告不包含任何秘密信息,可以安全地粘贴到 issue 或支持请求中。
标志
Prop
Type
示例
人类可读报告:
seashail doctor机器可读 JSON:
seashail doctor --json注意事项
- 报告包含版本信息、解析路径、钱包数量、策略摘要和基本连接检查。
- 可安全公开粘贴——不包含私钥、密码短语或地址。
seashail agent list
列出 print 和 install 命令支持的智能体目标。
标志
无标志。
示例
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 print和agent 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 命令检查当前版本,仅在有更新版本可用时才升级。