OpenClaw 中文文档 — CLI 入门与向导自动化

前面几篇把安装和升级都过了。这篇聊两件事：日常 CLI 怎么用，以及怎么把 onboarding 脚本化。

核心命令

网关

openclaw gateway --port 18789   # 前台启动
openclaw gateway status         # 状态
openclaw gateway stop           # 停止
openclaw gateway restart        # 重启
openclaw gateway install        # 注册系统服务

诊断

openclaw status              # 本地状态
openclaw status --all         # 完整诊断
openclaw status --deep        # 附带 Gateway 健康探测
openclaw health --json        # 健康快照
openclaw doctor               # 配置检查 + 迁移
openclaw logs --follow        # 实时日志

渠道与配置

openclaw channels login       # 渠道登录（扫码等）
openclaw configure             # 修改配置
openclaw setup                 # 初始化工作区
openclaw dashboard             # 打开 Control UI

个人助手配置

比较典型的场景：用一个专用 瓦茨爱皮皮 号当 AI 助手。

关键点：

• 别用个人号——否则每条消息都会被 Agent 处理
• 用一个预付费 SIM 专门做助手号
• 一定要设 allowFrom 白名单

最简配置：

{
  agent: {
    model: "anthropic/claude-opus-4-6",
    heartbeat: { every: "0m" },  // 先关
  },
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  session: {
    scope: "per-sender",
    resetTriggers: ["/new", "/reset"],
  },
}

工作区

Agent 的"大脑"在工作区里——~/.openclaw/workspace。里面有 AGENTS.md、SOUL.md、TOOLS.md 等文件，定义了 Agent 的行为和人设。

openclaw setup  # 初始化

建议做成 Git 仓库，备份记忆。

心跳

默认每 30 分钟让 Agent 主动检查任务。消耗 token，先关掉体验一下再说。

会话

• /new 或 /reset — 新会话
• /compact — 压缩上下文

向导自动化

这个才是重点——CI/CD 场景下不可能手动跑向导。

非交互模式

openclaw onboard --non-interactive 
  --mode local 
  --auth-choice apiKey 
  --anthropic-api-key "$ANTHROPIC_API_KEY" 
  --secret-input-mode plaintext 
  --gateway-port 18789 
  --gateway-bind loopback 
  --install-daemon 
  --daemon-runtime node 
  --skip-skills

注意：--json 不是非交互模式，脚本里要用 --non-interactive。

密钥引用模式

用 --secret-input-mode ref 存环境变量引用而非明文：

export ANTHROPIC_API_KEY="sk-xxx"
openclaw onboard --non-interactive 
  --mode local 
  --auth-choice apiKey 
  --secret-input-mode ref 
  --gateway-port 18789 
  --gateway-bind loopback

配置里存的是引用，不是明文 key。这个设计我觉得挺巧妙的——把密钥管理的复杂度推给了运行时环境。

各供应商

# Ollama（本地模型）
openclaw onboard --non-interactive 
  --auth-choice ollama 
  --custom-model-id "qwen3.5:27b" 
  --accept-risk

# 自定义供应商
openclaw onboard --non-interactive 
  --auth-choice custom-api-key 
  --custom-base-url "https://llm.example.com/v1" 
  --custom-model-id "my-model" 
  --custom-provider-id "my-custom" 
  --custom-compatibility anthropic

自动化添加 Agent

openclaw agents add work 
  --workspace ~/.openclaw/workspace-work 
  --model openai/gpt-5.2 
  --bind whatsapp:biz 
  --non-interactive --json

每个 Agent 有独立的工作区、会话和认证。

下一篇

入门篇结束。下一篇进入渠道篇——渠道总览与配对机制。

完整中文文档：OpenClaw 中文文档

GitHub 仓库：openclaw/openclaw

OpenClaw 中文文档系列第五篇，后面会一篇篇写完。觉得有用点个赞，有问题评论区聊。