CLI 命令参考
当前开发版本的完整命令族、公共参数和输入约束。
命令表
| 命令 | 作用 |
|---|---|
init --pg-bin-dir PATH | 使用PostgreSQL 17二进制目录初始化 |
daemon | 前台启动 |
status [--run RUN_ID] | 总览或单个运行 |
pair CHANNEL --workspace PATH [--run-deadline SECONDS] | 渠道配对 |
bindings list | 绑定列表 |
bindings revoke ID | 撤销绑定 |
bindings reconfirm ID | 重新确认绑定 |
bindings reset-thread ID --ack-unknown RUN_ID | 明确确认未知运行后重置线程 |
bindings receiver CHANNEL | 从标准输入读取插件声明的凭据字段 |
bindings host crabcode --workspace PATH [--run-deadline SECONDS] | 绑定支持的宿主 |
approve ID / deny ID | 所有者审批 |
cancel RUN_ID | 请求取消工作 |
plugins list | 查看已装插件 |
plugins add PATH | 安装本地目录插件 |
plugins add --built-in telegram / feishu | 安装随程序提供的渠道插件 |
plugins remove NAME | 移除插件 |
mcp | stdio MCP服务器 |
表中命令均以 openmybot 开头。PATH必须为绝对路径。子命令参数应放在该命令词之后,不传未知参数。
公共参数
除mcp外,命令支持 --data-dir PATH 与 --json。mcp仅支持 --data-dir PATH,不支持 --json。数据目录还可由 OPENMYBOT_DATA_DIR 设置;显式参数优先。
命令解析错误返回退出码2。当前CLI使用封闭的命令解析器,不把其他工具的 --help、--version 或任意开关假定为本CLI支持;请使用本页及对应源码版本的README。
自动化使用
使用JSON输出读取状态,保留run/binding/permission ID,按原对象查询结果。不能仅看命令返回就认定渠道投递或后台执行完成。凭据通过receiver标准输入传入,不放argv。