CLI 命令

--dev                 使用开发配置（隔离状态到 ~/.crabclaw-dev）
--profile <NAME>      使用命名配置（隔离状态到 ~/.crabclaw-<name>）
-v, --verbose         详细输出
--json                JSON 格式输出
--no-color            禁用 ANSI 颜色
--lang <LANG>         UI 语言覆盖（如 zh-CN、en-US）

crabclaw setup

crabclaw onboard
crabclaw onboard --non-interactive --auth-choice anthropic-api-key

crabclaw auth

crabclaw configure

crabclaw status

crabclaw health

crabclaw doctor

crabclaw gateway run          # 前台运行
crabclaw gateway start        # 后台启动
crabclaw gateway stop         # 停止服务
crabclaw gateway status       # 查看状态
crabclaw gateway install      # 安装为系统服务
crabclaw gateway uninstall    # 卸载系统服务
crabclaw gateway call <method> [params]  # 直接调用 RPC 方法
crabclaw gateway usage-cost   # 查看用量费用
crabclaw gateway health       # 健康检查
crabclaw gateway probe        # 探测端点（HTTP、RPC、发现）
crabclaw gateway discover     # 网络发现 Gateway 实例

crabclaw daemon status | start | stop | restart | install | uninstall

crabclaw agent                      # 交互模式
crabclaw agent "你好"                # 发送单条消息

crabclaw agents list                          # 列出智能体
crabclaw agents add <name>                    # 创建智能体
crabclaw agents delete <name>                 # 删除智能体
crabclaw agents set-identity <name> --emoji 🤖  # 设置身份

crabclaw sessions              # 列出会话

crabclaw channels list                # 列出频道状态
crabclaw channels add <type>          # 添加频道账号
crabclaw channels remove <type>       # 移除频道账号
crabclaw channels status              # 频道状态检查
crabclaw channels capabilities        # 显示频道能力
crabclaw channels logs                # 查看频道日志
crabclaw channels login <type>        # 登录频道
crabclaw channels logout <type>       # 登出频道
crabclaw channels resolve <contact>   # 解析联系人

crabclaw pairing list <type>          # 列出待审批配对
crabclaw pairing approve <type> <code>  # 批准配对

crabclaw message --channel telegram --to "@user" "消息内容"

crabclaw directory peers <channel>    # 列出联系人
crabclaw directory groups <channel>   # 列出群组

crabclaw models list               # 列出可用模型
crabclaw models get                # 查看当前默认模型
crabclaw models set <model>        # 设置默认模型
crabclaw models set-image <model>  # 设置默认图像模型

# 别名管理
crabclaw models aliases list | add <alias> <model> | remove <alias>

# 回退链
crabclaw models fallbacks list | add <model> | remove <model> | clear
crabclaw models image-fallbacks list | add | remove | clear

# 钱包
crabclaw models wallet balance     # 查看余额
crabclaw models wallet usage       # 查看用量

crabclaw skills list                     # 列出技能
crabclaw skills info <name>              # 查看技能详情
crabclaw skills check                    # 检查技能系统健康
crabclaw skills codegen                  # 编译组合技能
crabclaw skills codegen --dry-run        # 预览编译结果
crabclaw skills codegen --status         # 查看编译状态
crabclaw skills codegen --name <name>    # 编译指定技能
crabclaw skills run <name> --input '{}'  # 运行组合工具

crabclaw plugins list              # 列出插件
crabclaw plugins info <name>       # 查看详情
crabclaw plugins install <path>    # 安装插件
crabclaw plugins enable <name>     # 启用
crabclaw plugins disable <name>    # 禁用
crabclaw plugins doctor            # 诊断加载错误

crabclaw packages browse            # 浏览可用包
crabclaw packages detail <name>     # 查看包详情
crabclaw packages install <name>    # 安装
crabclaw packages remove <name>     # 卸载
crabclaw packages installed         # 列出已安装

crabclaw hooks list                # 列出 Hook
crabclaw hooks info <name>         # 查看详情
crabclaw hooks check               # 检查系统健康
crabclaw hooks enable <name>       # 启用
crabclaw hooks disable <name>      # 禁用
crabclaw hooks install <pack>      # 安装 Hook 包
crabclaw hooks update              # 更新 Hook 包

# 管理
crabclaw browser status            # 查看状态
crabclaw browser start             # 启动浏览器
crabclaw browser stop              # 停止浏览器
crabclaw browser tabs              # 列出标签页
crabclaw browser open <url>        # 打开 URL
crabclaw browser focus <targetId>  # 聚焦标签页
crabclaw browser close [targetId]  # 关闭标签页
crabclaw browser screenshot        # 截图
crabclaw browser profiles          # 列出配置文件
crabclaw browser create-profile    # 创建配置文件
crabclaw browser delete-profile    # 删除配置文件

# 检查
crabclaw browser snapshot          # 无障碍快照
crabclaw browser console           # 控制台输出
crabclaw browser errors            # 页面错误
crabclaw browser requests          # 网络请求
crabclaw browser pdf               # 生成 PDF

# 操作
crabclaw browser navigate <url>    # 导航
crabclaw browser click <ref>       # 点击元素
crabclaw browser type <ref> <text> # 输入文本
crabclaw browser press <key>       # 按键
crabclaw browser hover <ref>       # 悬停
crabclaw browser fill --field <f> --value <v>  # 批量填表
crabclaw browser evaluate <js>     # 执行 JavaScript
crabclaw browser wait <condition>  # 等待条件
crabclaw browser upload <ref> <file>  # 上传文件
crabclaw browser select <ref> <option>  # 选择下拉项
crabclaw browser drag <from> <to>  # 拖拽

# 录制与存储
crabclaw browser trace start | stop     # 跟踪录制
crabclaw browser cookies set | clear    # Cookie 管理
crabclaw browser storage get | set | clear  # 存储管理

# 环境覆盖
crabclaw browser set offline | headers | credentials | geo | media | timezone | locale | device

crabclaw cron status               # 调度器状态
crabclaw cron list                 # 列出任务
crabclaw cron add <spec>           # 添加任务
crabclaw cron edit <id>            # 编辑任务
crabclaw cron enable <id>          # 启用
crabclaw cron disable <id>         # 禁用
crabclaw cron run <id>             # 立即执行
crabclaw cron runs <id>            # 查看执行历史
crabclaw cron remove <id>          # 删除

crabclaw config get <path>         # 读取值（如 gateway.port）
crabclaw config set <path> <value> # 设置值
crabclaw config unset <path>       # 删除值

crabclaw logs follow               # 实时跟踪日志
crabclaw logs list                 # 列出日志文件
crabclaw logs show <file>          # 查看日志内容
crabclaw logs clear                # 清除所有日志
crabclaw logs export               # 导出日志到单文件

crabclaw memory status             # 记忆系统状态
crabclaw memory index              # 触发重新索引
crabclaw memory check              # 健康检查
crabclaw memory search <query>     # 搜索记忆

crabclaw security                  # 安全审计与管理

crabclaw approvals get                          # 查看当前审批
crabclaw approvals set <file>                   # 从文件设置
crabclaw approvals allowlist-add <pattern>      # 添加白名单
crabclaw approvals allowlist-remove <pattern>   # 移除白名单

crabclaw sandbox list              # 列出沙箱容器
crabclaw sandbox recreate          # 重建沙箱
crabclaw sandbox explain           # 解释沙箱配置
crabclaw sandbox run <cmd>         # 在沙箱中执行命令

crabclaw node run                  # 运行无头节点
crabclaw node install              # 安装为系统服务
crabclaw node status | stop | restart | uninstall

crabclaw devices list              # 列出已配对设备
crabclaw devices approve <id>      # 批准配对
crabclaw devices reject <id>       # 拒绝配对
crabclaw devices rotate <id>       # 轮换令牌
crabclaw devices revoke <id>       # 撤销令牌

crabclaw dns setup                 # 设置广域发现 DNS

crabclaw system event <type>       # 发送系统事件
crabclaw system heartbeat-last     # 查看最后心跳
crabclaw system heartbeat-enable   # 启用心跳
crabclaw system heartbeat-disable  # 禁用心跳
crabclaw system presence           # 查看在线状态

crabclaw mcp install <url>         # 安装 MCP 服务器
crabclaw mcp list                  # 列出已安装
crabclaw mcp status <name>         # 查看状态
crabclaw mcp update <name>         # 更新
crabclaw mcp uninstall <name>      # 卸载
crabclaw mcp start <name>          # 启动
crabclaw mcp stop <name>           # 停止
crabclaw mcp import                # 从 Claude Desktop/Cursor/VS Code 导入

crabclaw coder start               # 启动 MCP 编码智能体（stdin/stdout）

crabclaw coder-terminal --session=<id> --gateway=ws://localhost:19001

crabclaw browser mcp               # stdio 模式，可被 Claude Desktop/Cursor 等调用

crabclaw webhooks list             # 列出 Webhook
crabclaw webhooks test             # 测试端点
crabclaw webhooks gmail-setup      # 设置 Gmail Pub/Sub
crabclaw webhooks gmail-run        # 运行 Gmail 监听

crabclaw voicecall status          # 通话状态
crabclaw voicecall call <contact>  # 发起通话
crabclaw voicecall continue <msg>  # 继续通话
crabclaw voicecall end             # 结束通话
crabclaw voicecall expose          # 暴露语音服务
crabclaw voicecall unexpose        # 取消暴露

crabclaw update run                # 运行更新
crabclaw update status             # 更新状态
crabclaw update wizard             # 交互式更新向导

crabclaw dashboard                 # 在浏览器中打开仪表盘

crabclaw tui                       # 启动终端 UI（连接 Gateway）

crabclaw reset                     # 重置配置、会话、工作区

crabclaw completion bash | zsh | fish | powershell