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

相关推荐
SA-D16 分钟前
Agent 如何防御 Prompt 注入:从输入信任边界到工具执行授权
agent·提示词注入·prompt注入
J船长10 小时前
Agent开发 00|从 ChatGPT 到生产级 AI Agent
agent
Csvn11 小时前
如果明天供应商涨价 3 倍?三层解耦,换模型只改一行配置(C05)
人工智能·aigc·agent
七夜zippoe13 小时前
Agent 告警设计:分级告警、智能降噪与值班排班
开发语言·ai·agent·告警·智能降噪·值班排班
prince_zxill18 小时前
把 17 个散文件装进一个文件夹:拆解 claude-plugins-official 的插件打包术(47,413 Star 实测)
python·github·agent·mcp·claude code
程序员张富华19 小时前
一次发布拦住12个破坏性变更:我们给Agent工作流加了Schema门禁
人工智能·agent
ZhengEnCi21 小时前
Claude 的记忆是怎么设计的:四层记忆栈,和一场叫「做梦」的离线整理
aigc·agent·ai编程
Csvn1 天前
换供应商要改一遍代码?把模型接入收进一层网关(C04)
人工智能·aigc·agent
七夜zippoe1 天前
多 Agent 通信灾难:状态不一致导致雪崩故障的排查与防护
ai·agent·通信灾难·雪崩故障·排查与防护
谙弆悕博士2 天前
多智能体架构详解:层级树状架构(分级主从型)
运维·架构·大模型·agent·多智能体·langgraph·层级树状