Skip to content

commands-reference.zh-CN.md

Latest commit

 

History

History
220 lines (160 loc) · 7.69 KB

commands-reference.zh-CN.md

File metadata and controls

220 lines (160 loc) · 7.69 KB

ZeroClaw 命令参考文档

本参考文档派生自当前 CLI 界面（zeroclaw --help）。

最后验证时间：2026年2月21日。

顶级命令

命令 用途
onboard 快速或交互式初始化工作区/配置
agent 运行交互式聊天或单消息模式
gateway 启动 webhook 和 WhatsApp HTTP 网关
daemon 启动受监管的运行时（网关 + 渠道 + 可选心跳/调度器）
service 管理用户级操作系统服务生命周期
doctor 运行诊断和新鲜度检查
status 打印当前配置和系统摘要
estop 启动/恢复紧急停止级别并检查 estop 状态
cron 管理计划任务
models 刷新提供商模型目录
providers 列出提供商 ID、别名和活动提供商
channel 管理渠道和渠道健康检查
integrations 检查集成详情
skills 列出/安装/移除技能
migrate 从外部运行时导入（当前支持 OpenClaw）
config 导出机器可读的配置模式
completions 生成 shell 补全脚本到 stdout
hardware 发现和检查 USB 硬件
peripheral 配置和烧录外围设备

命令组

onboard

  • zeroclaw onboard
  • zeroclaw onboard --interactive
  • zeroclaw onboard --channels-only
  • zeroclaw onboard --force
  • zeroclaw onboard --api-key <KEY> --provider <ID> --memory <sqlite|lucid|markdown|none>
  • zeroclaw onboard --api-key <KEY> --provider <ID> --model <MODEL_ID> --memory <sqlite|lucid|markdown|none>
  • zeroclaw onboard --api-key <KEY> --provider <ID> --model <MODEL_ID> --memory <sqlite|lucid|markdown|none> --force
  • zeroclaw onboard --reinit --interactive

onboard 安全行为：

  • 如果 config.toml 已存在且你运行 --interactive，引导程序现在提供两种模式：
    • 完整引导（覆盖 config.toml）
    • 仅更新提供商（更新提供商/模型/API 密钥，同时保留现有渠道、隧道、内存、钩子和其他设置）
  • 在非交互式环境中，现有 config.toml 会导致安全拒绝，除非传递 --force。
  • 当你只需要轮换渠道令牌/白名单时，使用 zeroclaw onboard --channels-only。
  • 使用 zeroclaw onboard --reinit --interactive 重新开始。这会备份现有配置目录并添加时间戳后缀，然后从头创建新配置。需要 --interactive。

agent

  • zeroclaw agent
  • zeroclaw agent -m \"Hello\"
  • zeroclaw agent --provider <ID> --model <MODEL> --temperature <0.0-2.0>
  • zeroclaw agent --peripheral <board:path>

提示：

  • 在交互式聊天中，你可以用自然语言要求更改路由（例如“对话使用 kimi，编码使用 gpt-5.3-codex”）；助手可以通过工具 model_routing_config 持久化这些设置。

gateway / daemon

  • zeroclaw gateway [--host <HOST>] [--port <PORT>]
  • zeroclaw daemon [--host <HOST>] [--port <PORT>]

estop

  • zeroclaw estop（启动 kill-all）
  • zeroclaw estop --level network-kill
  • zeroclaw estop --level domain-block --domain \"*.chase.com\" [--domain \"*.paypal.com\"]
  • zeroclaw estop --level tool-freeze --tool shell [--tool browser]
  • zeroclaw estop status
  • zeroclaw estop resume
  • zeroclaw estop resume --network
  • zeroclaw estop resume --domain \"*.chase.com\"
  • zeroclaw estop resume --tool shell
  • zeroclaw estop resume --otp <123456>

注意事项：

  • estop 命令需要 [security.estop].enabled = true。
  • 当 [security.estop].require_otp_to_resume = true 时，resume 需要 OTP 验证。
  • 如果省略 --otp，OTP 提示会自动出现。

service

  • zeroclaw service install
  • zeroclaw service start
  • zeroclaw service stop
  • zeroclaw service restart
  • zeroclaw service status
  • zeroclaw service uninstall

cron

  • zeroclaw cron list
  • zeroclaw cron add <expr> [--tz <IANA_TZ>] <command>
  • zeroclaw cron add-at <rfc3339_timestamp> <command>
  • zeroclaw cron add-every <every_ms> <command>
  • zeroclaw cron once <delay> <command>
  • zeroclaw cron remove <id>
  • zeroclaw cron pause <id>
  • zeroclaw cron resume <id>

注意事项：

  • 修改计划/cron 操作需要 cron.enabled = true。
  • 用于创建计划的 Shell 命令 payload（create / add / once）在作业持久化前会经过安全命令策略验证。

models

  • zeroclaw models refresh
  • zeroclaw models refresh --provider <ID>
  • zeroclaw models refresh --force

models refresh 当前支持以下提供商 ID 的实时目录刷新：openrouter、openai、anthropic、groq、mistral、deepseek、xai、together-ai、gemini、ollama、llamacpp、sglang、vllm、astrai、venice、fireworks、cohere、moonshot、glm、zai、qwen 和 nvidia。

doctor

  • zeroclaw doctor
  • zeroclaw doctor models [--provider <ID>] [--use-cache]
  • zeroclaw doctor traces [--limit <N>] [--event <TYPE>] [--contains <TEXT>]
  • zeroclaw doctor traces --id <TRACE_ID>

doctor traces 从 observability.runtime_trace_path 读取运行时工具/模型诊断信息。

channel

  • zeroclaw channel list
  • zeroclaw channel start
  • zeroclaw channel doctor
  • zeroclaw channel bind-telegram <IDENTITY>
  • zeroclaw channel add <type> <json>
  • zeroclaw channel remove <name>

运行时聊天内命令（渠道服务器运行时的 Telegram/Discord）：

  • /models
  • /models <provider>
  • /model
  • /model <model-id>
  • /new

渠道运行时还会监视 config.toml 并热应用以下更新：

  • default_provider
  • default_model
  • default_temperature
  • api_key / api_url（针对默认提供商）
  • reliability.* 提供商重试设置

add/remove 当前会引导你回到托管安装/手动配置路径（尚未支持完整的声明式修改）。

integrations

  • zeroclaw integrations info <name>

skills

  • zeroclaw skills list
  • zeroclaw skills audit <source_or_name>
  • zeroclaw skills install <source>
  • zeroclaw skills remove <name>

<source> 接受 git 远程地址（https://...、http://...、ssh://... 和 git@host:owner/repo.git）或本地文件系统路径。

skills install 在接受技能前始终会运行内置的静态安全审计。审计会阻止：

  • 技能包内的符号链接
  • 类脚本文件（.sh、.bash、.zsh、.ps1、.bat、.cmd）
  • 高风险命令片段（例如管道到 Shell 的 payload）
  • 逃出技能根目录、指向远程 markdown 或目标为脚本文件的 markdown 链接

在共享候选技能目录（或按名称已安装的技能）前，使用 skills audit 手动验证。

技能清单（SKILL.toml）支持 prompts 和 [[tools]]；两者都会在运行时注入到代理系统提示中，因此模型可以遵循技能指令而无需手动读取技能文件。

migrate

  • zeroclaw migrate openclaw [--source <path>] [--dry-run]

config

  • zeroclaw config schema

config schema 将完整 config.toml 契约的 JSON Schema（草案 2020-12）打印到 stdout。

completions

  • zeroclaw completions bash
  • zeroclaw completions fish
  • zeroclaw completions zsh
  • zeroclaw completions powershell
  • zeroclaw completions elvish

completions 设计为仅输出到 stdout，因此脚本可以直接被 source 而不会被日志/警告污染。

hardware

  • zeroclaw hardware discover
  • zeroclaw hardware introspect <path>
  • zeroclaw hardware info [--chip <chip_name>]

peripheral

  • zeroclaw peripheral list
  • zeroclaw peripheral add <board> <path>
  • zeroclaw peripheral flash [--port <serial_port>]
  • zeroclaw peripheral setup-uno-q [--host <ip_or_host>]
  • zeroclaw peripheral flash-nucleo

验证提示

要快速针对当前二进制文件验证文档：

zeroclaw --help
zeroclaw <command> --help