企业官网建设流程全解析

前言

OpenClaw 是一个面向个人助理、自动化工作流和多渠道消息协作的 AI Agent 系统。它不只是一个聊天机器人外壳，而是把模型、工具、记忆、技能、消息通道、浏览器、节点设备、定时任务和多 Agent 协作都串到了一起。

如果你刚开始使用 OpenClaw，最容易被命令数量吓到：gateway、agent、message、cron、skills、models、sessions、nodes、channels、plugins……看起来很多，但其实可以按“日常使用、系统管理、自动化、扩展开发、排障维护”几类来理解。

本文基于版本为2026.5.7的 OpenClaw CLI 帮助信息整理。目标不是把每个参数逐字翻译，而是帮你建立一张实用地图：什么时候用哪个命令、常见参数怎么搭配、哪些命令需要谨慎操作。

提醒：OpenClaw 命令在不同版本可能会增减参数。执行前建议先运行openclaw <command> --help查看本机版本的准确信息。

一、先记住 OpenClaw CLI 的整体结构

OpenClaw 的命令格式基本是：

openclaw[全局选项]<command>[subcommand][options]

最常用的全局选项包括：

openclaw--helpopenclaw--versionopenclaw--profile<name><command>openclaw--dev<command>openclaw --log-level debug<command>

几个关键概念：

• --profile <name>：使用独立配置目录，适合多环境隔离。
• --dev：开发模式，通常会把状态隔离到开发目录，并使用偏移端口。
• --log-level：临时调整日志级别，排障时常用。
• --container <name>：在指定容器内运行 CLI，适合容器化部署场景。

如果不知道某个命令怎么用，统一使用：

openclaw<command>--helpopenclaw<command><subcommand>--help

这比猜参数可靠得多。

二、入门必会：help、status、doctor

1. 查看总帮助：help

openclawhelpopenclaw--help

这个命令会列出所有顶级命令，例如：

• agent：运行一次 Agent 对话。
• gateway：管理 WebSocket Gateway。
• message：发送和管理消息。
• cron：管理定时任务。
• skills：查看和安装技能。
• models：查看和配置模型。
• channels：管理聊天渠道。
• sessions：查看会话记录。
• nodes：管理设备节点。
• plugins：管理插件。
• config：读写配置。
• tasks：查看后台任务。

2. 查看系统状态：status

openclaw status openclaw status--jsonopenclaw status--allopenclaw status--usageopenclaw status--deep--timeout5000

常用场景：

• 想知道 Gateway 是否正常；
• 想看渠道是否连接；
• 想看最近会话目标；
• 想看模型使用量；
• 排查 WhatsApp、Telegram、Discord、Slack、Signal 等通道。

参数说明：

• --json：机器可读输出，适合脚本处理。
• --all：完整诊断信息，适合贴给自己或团队排障。
• --usage：查看模型使用或成本相关信息。
• --deep：做更深入的通道探测。

3. 健康检查与修复：doctor

openclaw doctor openclaw doctor--fix

doctor适合在“明明配置了但就是不工作”的时候使用。它通常会检查服务、配置、插件、通道、权限等问题。带--fix时可能会尝试自动修复，因此建议先看输出再决定是否执行。

三、Gateway：OpenClaw 的运行中枢

Gateway 是 OpenClaw 的核心运行服务，很多命令和工具都通过它工作。常见命令：

openclaw gateway status openclaw gateway health openclaw gateway restart openclaw gateway run openclaw gateway start openclaw gateway stop openclaw gateway discover openclaw gateway stability openclaw gateway call health

常用场景

查看 Gateway 状态

openclaw gateway status

用于确认 Gateway 服务是否运行、端口是否可达、认证能力是否正常。

查看健康状态

openclaw gateway health

适合脚本或监控系统调用。

重启 Gateway

openclaw gateway restart

当你修改了需要重启生效的配置，或者 Gateway 出现异常时会用到。

注意：重启会中断正在运行的任务或会话处理。生产环境或重要任务执行期间不要随手重启。

前台运行 Gateway

openclaw gateway run

适合开发调试，可以直接看日志。

发现 Gateway

openclaw gateway discover

用于局域网或广域发现，适合多设备环境。

Gateway 常见参数

openclaw gateway--port18789openclaw gateway--bindloopback openclaw gateway--authtoken--token<token>openclaw gateway--verbose

含义大致如下：

• --port：指定端口。
• --bind：绑定模式，如 loopback、lan、tailnet、auto、custom。
• --auth：认证方式，如 none、token、password、trusted-proxy。
• --verbose：输出更详细日志。

四、agent：直接运行一次 Agent 对话

如果你想从命令行直接让 OpenClaw 处理一个任务，可以用agent。

openclaw agent--message"总结一下今天的任务"openclaw agent--agentops--message"检查日志并给出结论"openclaw agent --session-id demo--message"继续上次的话题"openclaw agent--message"生成周报"--model<model-id>

常用参数

--message<text># 消息内容--agent<id># 指定 agent--session-id<id># 指定会话 ID--model<id># 指定模型--thinking<level># 指定推理等级--deliver# 将回复发送回对应渠道--reply-channel# 指定回复渠道--reply-to# 指定回复目标--timeout<seconds># 设置超时时间--json# JSON 输出

典型用法

只在命令行运行，不发送外部消息

openclaw agent--message"帮我列一个 OpenClaw 入门清单"

指定某个 Agent 执行任务

openclaw agent--agentops--message"检查服务状态并总结异常"

运行后发送到聊天渠道

openclaw agent--message"生成日报"--deliver--reply-channel slack --reply-to"#daily"

这里要特别小心：--deliver会把结果发出去。涉及客户、公开群、合同、报价、敏感信息时，最好先不加--deliver，确认内容后再发送。

五、message：发送和管理消息

message是 OpenClaw 连接外部聊天渠道的命令集合。它支持发送、读取、编辑、删除、反应、投票、事件、成员管理等能力。

常见命令：

openclaw message send--target<target>--message"Hi"openclaw message send--channeltelegram--target@mychat--message"Hi"openclaw messageread--channeltelegram--target<target>openclaw message react--channeldiscord--target<channel>--message-id<id>--emoji"✅"openclaw message delete--channeldiscord--target<channel>--message-id<id>openclaw message poll--channeldiscord--targetchannel:123 --poll-question"Snack?"--poll-option Pizza --poll-option Sushi

常用子命令

发送文本消息

openclaw message send--channeltelegram--target@mychat--message"部署完成"

发送带媒体的消息

openclaw message send--target+15555550123--message"见附件"--media./report.pdf

安全提醒

message send会真实把内容发到外部渠道。建议遵守三条规则：

1. 发给谁要确认；
2. 发什么要确认；
3. 代表谁发要确认。

尤其是以用户身份、对外客户、群公告、合同报价、公开平台发布等场景，不能让 Agent 自行决定发送。

六、channels：管理聊天渠道

OpenClaw 可以接入 Telegram、Discord、Slack、WhatsApp、Signal、Feishu 等多个渠道。渠道相关命令主要在channels下。

openclaw channels list openclaw channels list--allopenclaw channels status openclaw channels status--probeopenclaw channels login--channelwhatsapp openclaw channelslogout--channelwhatsapp openclaw channelsadd--channeltelegram--token<token>openclaw channels resolve--channeltelegram--query<name>openclaw channels capabilities--channelfeishu

常用场景

• 查看已配置渠道：channels list
• 查看渠道是否在线：channels status
• 登录 Web 类渠道：channels login
• 退出登录：channels logout
• 添加 Bot Token：channels add
• 查询用户或群 ID：channels resolve
• 查看渠道能力：channels capabilities

示例：添加 Telegram

openclaw channelsadd--channeltelegram--token<bot-token>

示例：登录 WhatsApp

openclaw channels login--channelwhatsapp

这类命令可能涉及账号授权和会话状态，建议只在可信设备上执行。

七、cron：定时任务和提醒

OpenClaw 的cron用于管理定时任务。适合做提醒、定期检查、自动日报、周期性总结等。

openclawcronstatus openclawcronlist openclawcronaddopenclawcronshow<job-id>openclawcronrun<job-id>openclawcrondisable<job-id>openclawcronenable<job-id>openclawcronedit<job-id>openclawcronrm<job-id>openclawcronruns<job-id>

常用场景

查看调度器状态

openclawcronstatus

查看任务列表

openclawcronlist

立即触发某个任务

openclawcronrun<job-id>

查看运行历史

openclawcronruns<job-id>

使用建议

• 精确时间提醒用cron，不要用sleep常驻进程模拟。
• 周期性任务要写清楚时区，例如 Asia/Shanghai。
• 自动发送外部消息前，确认是否需要人工审阅。
• 对可能失败的任务配置失败提醒或运行历史检查。

八、skills：查看、安装和检查技能

Skills 是 OpenClaw 的“能力包”。一个技能通常包含使用说明、脚本、流程约束和最佳实践。

openclaw skills list openclaw skills check openclaw skills info<skill-name>openclaw skills search<keyword>openclaw skillsinstall<skill-spec>openclaw skills update

常用场景

查看可用技能

openclaw skills list

检查技能可见性和依赖

openclaw skills check

查看技能详情

openclaw skills info csdn-draft-publisher

搜索技能

openclaw skills search browser

安装技能

openclaw skillsinstall<skill-spec>

使用建议

真正执行任务前，先读对应技能说明。比如涉及浏览器自动化，就应该看浏览器技能；涉及 CSDN 草稿，就应该看 CSDN 草稿发布技能。技能通常不仅告诉你“怎么做”，还会告诉你“哪些事情不能做”。

九、models：模型配置与状态

模型相关命令集中在models。

openclaw models status openclaw models list openclaw modelsset<model-id>openclaw models aliases openclaw models fallbacks openclaw models image-fallbacks openclaw models auth openclaw models scan

常用场景

查看当前模型状态

openclaw models status

查看可用模型

openclaw models list

设置默认模型

openclaw modelsset<provider/model>

管理别名

openclaw models aliases

管理失败回退模型

openclaw models fallbacks

使用建议

• 长任务优先选择稳定模型；
• 工具调用任务要确认模型支持工具调用；
• 图像生成、视觉理解、长上下文任务要选择对应能力模型；
• 不要只看模型名字，要看当前 provider 的配置和额度。

十、sessions：会话管理

sessions用于查看历史会话、活跃会话和会话使用情况。

openclaw sessions openclaw sessions--active120openclaw sessions--limit25openclaw sessions--jsonopenclaw sessions--agentwork openclaw sessions --all-agents openclaw sessions cleanup openclaw sessions export-trajectory<session-id>

常用参数

• --active <minutes>：只看最近 N 分钟活跃的会话。
• --limit <count>：限制返回数量。
• --json：机器可读输出。
• --agent <id>：指定 Agent。
• --all-agents：跨 Agent 汇总。

常用场景

查看最近两小时会话

openclaw sessions--active120

导出轨迹用于排障

openclaw sessions export-trajectory<session-id>

导出会话轨迹时要注意隐私和敏感信息，避免把包含密钥、客户数据或个人信息的内容随意外传。

十一、tasks：后台任务管理

OpenClaw 的一些工作会以后台任务形式运行，比如子 Agent、Cron、CLI 任务等。

openclaw tasks list openclaw tasks list--statusrunning openclaw tasks list--runtimesubagent openclaw tasks show<task-id>openclaw tasks cancel<task-id>openclaw tasks audit openclaw tasks maintenance openclaw tasks notify<task-id>

常用场景

• 查看正在跑的任务；
• 检查失败任务原因；
• 取消长时间卡住的任务；
• 审计 stale 或 broken 的后台任务；
• 管理任务通知策略。

示例

openclaw tasks list--statusrunning openclaw tasks show<run-id>openclaw tasks cancel<run-id>

取消任务属于中断性操作，确认任务确实不需要继续后再执行。

十二、config：配置读写

config用于读取、修改和校验 OpenClaw 配置。

openclaw configfileopenclaw config get<dot.path>openclaw configset<dot.path><value>openclaw config patch--file./openclaw.patch.json5 --dry-run openclaw config patch--stdinopenclaw configunset<dot.path>openclaw config schema openclaw config validate

常用场景

查看配置文件路径

openclaw configfile

读取某个配置项

openclaw config get gateway.port

校验配置

openclaw config validate

使用 patch 修改配置

openclaw config patch--file./openclaw.patch.json5 --dry-run openclaw config patch--file./openclaw.patch.json5

安全提醒

配置命令很强大，也很容易把系统改坏。尤其是以下内容要谨慎：

• Gateway 端口、认证、绑定地址；
• 渠道 Token；
• 模型密钥；
• 插件 allow/deny；
• 安全策略；
• secrets providers。

修改前建议先--dry-run或备份配置。涉及密钥时不要把真实值贴到聊天、日志或文档里。

十三、nodes：设备节点管理

nodes用于管理已配对设备节点，包括状态、通知、摄像头、屏幕、位置、远程调用等。

openclaw nodes status openclaw nodes list openclaw nodes pending openclaw nodes approve<request-id>openclaw nodes reject<request-id>openclaw nodes describe--node<id>openclaw nodes notify--node<id>--title"提醒"--body"该休息了"openclaw nodes invoke--node<id>--commandsystem.which--params'{"name":"uname"}'openclaw nodes camera snap--node<id>openclaw nodesscreen--node<id>openclaw nodes location--node<id>

常用场景

• 查看设备在线状态；
• 批准或拒绝新设备配对；
• 给设备发送通知；
• 调用设备能力；
• 获取摄像头、屏幕或位置数据。

安全提醒

节点能力可能涉及摄像头、屏幕、位置、通知等敏感权限。使用前要确认：

1. 设备是谁的；
2. 当前场景是否需要；
3. 是否会采集隐私；
4. 结果是否会外传。

十四、plugins：插件管理

插件用于扩展 OpenClaw 能力，包括模型 provider、渠道、工具、记忆、TTS 等。

openclaw plugins list openclaw plugins inspect<plugin>openclaw plugins doctor openclaw pluginsinstall<plugin-spec>openclaw pluginsenable<plugin>openclaw plugins disable<plugin>openclaw plugins uninstall<plugin>openclaw plugins update openclaw plugins registry openclaw plugins search<keyword>

常用场景

• 查看已安装插件；
• 排查插件加载失败；
• 启用或禁用插件；
• 安装新插件；
• 更新插件；
• 重建插件注册表。

安全提醒

插件本质上是扩展代码，安装前要确认来源可信。不要随便安装来路不明的插件，尤其是会接触消息、文件、浏览器、密钥或网络的插件。

十五、security、approvals 与 exec-policy

OpenClaw 里有一类命令专门和安全、审批、执行策略有关。

常见命令包括：

openclaw security--helpopenclaw approvals--helpopenclaw exec-policy--help

典型用途

• 查看本地安全配置；
• 管理执行审批；
• 同步或展示 exec policy；
• 审计高风险命令执行策略。

由于这类命令直接影响执行权限，建议不要在不理解含义的情况下修改。尤其是降低执行限制、放开危险命令、关闭审批等操作，都应该经过明确确认。

十六、backup、logs、health：维护和排障

1. 备份

openclaw backup--help

备份命令用于创建和验证本地 OpenClaw 状态归档。升级、迁移、重大配置调整前建议先备份。

2. 查看日志

openclaw logs openclaw logs--help

当 Gateway 或渠道异常时，日志通常比猜测更有用。

3. 查看健康状态

openclaw health

health会从运行中的 Gateway 获取健康信息，适合快速判断服务是否在线。

十七、docs：搜索文档

openclaw docs openclaw docs<keyword>

当你不确定某个概念或命令时，可以直接搜索 OpenClaw 文档。对于配置字段、Gateway、渠道、插件等问题，优先查本地版本文档，避免网上旧资料误导。

十八、常用命令速查表

十九、几个典型工作流

工作流 1：刚装好后检查系统

openclaw status openclaw gateway status openclaw channels list openclaw models status openclaw skills check

如果有异常，再执行：

openclaw doctor openclaw plugins doctor openclaw logs

工作流 2：从命令行让 Agent 做一次任务

openclaw agent--message"帮我生成一份 OpenClaw 入门教程大纲"

如果需要指定模型：

openclaw agent--message"分析这段日志"--model<provider/model>

如果需要发到某个渠道，先审阅结果，再考虑：

openclaw agent--message"生成日报"--deliver--reply-channel slack --reply-to"#daily"

工作流 3：创建和排查定时任务

openclawcronstatus openclawcronlist openclawcronshow<job-id>openclawcronrun<job-id>openclawcronruns<job-id>

如果任务不该继续运行：

openclawcrondisable<job-id>

工作流 4：排查渠道问题

openclaw channels status openclaw channels status--probeopenclaw status--deepopenclaw logs

如果是 Web 登录类渠道，再考虑：

openclaw channels login--channelwhatsapp

工作流 5：排查长任务卡住

openclaw tasks list--statusrunning openclaw tasks show<task-id>openclaw sessions--active120

确认确实卡死后再取消：

openclaw tasks cancel<task-id>

二十、哪些命令要谨慎使用

OpenClaw 很强，所以有些命令不能随手执行。

1. 会改变系统状态的命令

例如：

openclaw gateway restart openclaw gateway stop openclaw configset... openclaw config patch... openclaw plugins disable... openclaw plugins uninstall... openclaw tasks cancel...

这些命令可能中断服务、改变配置或停止任务。

2. 会对外发送内容的命令

例如：

openclaw message send... openclaw agent...--deliver

执行前确认发送对象和内容。

3. 涉及账号授权的命令

例如：

openclaw channels login--channel<name>openclaw channelslogout--channel<name>

这些会影响渠道登录态。

4. 涉及设备隐私的命令

例如：

openclaw nodes camera snap--node<id>openclaw nodesscreen--node<id>openclaw nodes location--node<id>

执行前确认设备和权限边界。

二十一、使用 OpenClaw CLI 的最佳实践

1. 先 help，再执行：不确定参数时先--help。
2. 先 dry-run，再修改：配置变更优先使用--dry-run。
3. 先看状态，再重启：不要把重启当万能解法。
4. 外发前先审阅：message send和agent --deliver要谨慎。
5. 敏感信息不要进命令行历史：Token、密码、密钥尽量走安全配置或环境变量。
6. 把任务分层：普通任务用agent，定时任务用cron，后台任务用tasks管理。
7. 把技能当操作手册：涉及专项任务先看skills info或技能文件。
8. 保留审计线索：重要操作记录命令、时间、目标和结果。
9. 使用 profile 隔离环境：开发、测试、生产不要混用配置。
10. 升级前备份：重大变更前使用 backup 或手动备份配置。

总结

OpenClaw CLI 看起来命令很多，但核心可以这样记：

• 运行与服务：gateway、health、status、logs、doctor
• 对话与消息：agent、message、channels
• 自动化任务：cron、tasks、sessions
• 能力扩展：skills、plugins、models
• 设备与节点：nodes、devices
• 配置与安全：config、security、approvals、exec-policy
• 维护迁移：backup、migrate、update

日常使用时，不需要一次记住所有命令。先掌握status、gateway、agent、message、cron、skills、models、sessions这几类，就已经能覆盖大多数场景。

真正的诀窍是：把 OpenClaw 当成一个长期运行的自动化系统，而不是一次性脚本。先查状态、再执行动作、最后看结果；对外发送和配置修改保持谨慎；遇到不确定的命令，永远先看本机--help。