Appearance
CLI 快速开始
前提条件
- 已安装 Workova 桌面端
- 桌面端正在运行(CLI 依赖桌面端 runtime)
安装完成后,CLI 命令 workova 已在 PATH 中可用:
bash
workova runtime:health第一条命令:检查 runtime 状态
bash
workova runtime:health预期输出:
runtime: connected
version: 1.2.0如果返回连接失败,请确认:
- 桌面端是否正在运行
- 防火墙是否放行了 bridge 端口
第二条命令:查看可用 contracts
bash
workova contracts:list该命令列出当前账号下所有可用的 contract(服务契约),帮助您确认 runtime 和后端的连接均正常。
第三条命令:确认登录状态
bash
workova auth:status如果未登录,执行登录:
bash
workova auth:login登录成功后,会话信息保存在 ~/.workova/cli-session.json。
WARNING
如果 bridge 不可用,auth:login 会自动降级为本地模式完成认证。此时其他依赖 runtime 的命令仍不可用,需启动桌面端后重试。
下一步
- 认证与账号命令 - 管理登录和账号信息
- Agent 与对话命令 - 创建 Agent 并发送消息
- 完整命令参考 - 所有命令和参数详情