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

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

核心命令

网关

bash 复制代码

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

诊断

bash 复制代码

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

渠道与配置

bash 复制代码

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

个人助手配置

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

关键点：

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

最简配置：

json5 复制代码

{
  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 的行为和人设。

bash 复制代码

openclaw setup  # 初始化

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

心跳

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

会话

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

向导自动化

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

非交互模式

bash 复制代码

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 存环境变量引用而非明文：

bash 复制代码

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。这个设计我觉得挺巧妙的------把密钥管理的复杂度推给了运行时环境。

各供应商

bash 复制代码

# 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

bash 复制代码

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 中文文档系列第五篇，后面会一篇篇写完。觉得有用点个赞，有问题评论区聊。