OpenClaw命令完全指南：从入门到精通

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

OpenClaw 是一款功能强大的开源个人 AI 助手，支持在自有设备上部署，实现多渠道交互、本地化运行的智能助理体验。要高效使用 OpenClaw，掌握其命令行工具（CLI）是关键 —— 它覆盖了配置管理、服务运维、智能体控制、渠道连接等全场景操作。

本文将基于官方文档与实战经验，把 OpenClaw 的所有命令按功能分类整理，附上详细说明与示例，帮你快速上手并精通这个工具。

在执行任何 OpenClaw 命令前，这些全局标志可以帮你灵活控制 CLI 的行为，适配不同的使用场景。

标志	说明	示例
–dev	将状态隔离到 ~/.openclaw-dev 目录，调整默认端口，适用于开发环境	openclaw –dev gateway start
–profile <name>	将状态隔离到 ~/.openclaw-<name>，支持多配置文件管理，比如同时维护测试和生产配置	openclaw –profile work onboard
–no-color	禁用 ANSI 颜色输出，适用于日志文件或不支持颜色的终端	openclaw –no-color logs
–json / –plain	以机器可读的格式输出，禁用样式和进度条，便于脚本集成	openclaw –json status
-V, –version	打印版本号并退出	openclaw –version

提示：OpenClaw 默认在 TTY 会话中渲染彩色输出和进度指示器，若需将输出重定向到文件，建议使用 –json 或 –plain 标志。

初次使用或需要调整系统配置时，这些命令是核心工具，帮你完成基础设置。

这是最全面的交互式配置向导，涵盖网关设置、工作区初始化、技能配置、模型认证等所有环节，强烈推荐新用户使用。

# 重置所有配置并重新运行向导 openclaw onboard –reset

GPT plus 代充只需 145

非交互式模式，指定远程网关

openclaw onboard –non-interactive –mode remote –remote-url <url> –remote-token <token>

配置时直接安装守护进程，实现开机自启

openclaw onboard –install-daemon

关键参数：

–workspace <dir>：指定智能体工作区路径
–mode <local|remote>：选择本地模式或连接远程网关
–auth-choice <选项>：直接指定认证方式，比如 openai-api-key
–skip-channels：跳过渠道配置环节
–skip-skills：跳过技能配置环节

相比 onboard，setup 是更轻量化的初始化命令，仅生成基础配置文件和工作区目录。

讯享网# 运行交互式向导 openclaw setup –wizard

非交互式模式，快速初始化本地工作区

openclaw setup –non-interactive –mode local

非交互式地读取、设置或删除配置项，适合脚本自动化修改配置。

# 获取配置值，使用点号语法访问嵌套配置 openclaw config get agents.defaults.model.primary

设置配置值，支持JSON5格式

openclaw config set agents.defaults.model.primary “claude-3-5-sonnet”

删除配置项

openclaw config unset some.deprecated.key

按菜单选择要修改的配置域（模型、网关、渠道等），可视化调整配置。

讯享网# 进入交互式配置界面 openclaw configure

直接进入渠道配置页面

openclaw configure –section channels

Gateway 是 OpenClaw 的心脏，负责管理会话、调度智能体、处理事件和指令，这些命令用于控制它的生命周期和状态。

# 启动网关服务（前台运行，可查看实时日志） openclaw gateway –port 18789 –verbose

安装网关为系统服务（systemd/launchd/schtasks），实现开机自启

openclaw gateway service install

查看网关服务状态

openclaw gateway status

重启网关服务（修改配置后必须执行）

openclaw gateway service restart

停止网关服务

openclaw gateway service stop

讯享网# 指定端口启动网关，避免端口冲突 openclaw gateway –port 19000

绑定不同的网络模式

openclaw gateway –bind loopback # 仅本机访问（默认，最安全） openclaw gateway –bind lan # 局域网可访问 openclaw gateway –bind tailnet # Tailscale 网络

通过 Tailscale 暴露服务

openclaw gateway –tailscale serve # 内网暴露 openclaw gateway –tailscale funnel # 公网暴露（需要 Tailscale 账户）

# 打开 Web 控制面板，在浏览器中可视化管理 openclaw dashboard

启动终端交互界面，直接在终端与 AI 对话，无需打开浏览器

openclaw tui

OpenClaw 支持接入 WhatsApp、Telegram、Discord、飞书等多种聊天平台，这些命令用于管理这些渠道的连接和状态。

讯享网# 列出已配置的所有渠道 openclaw channels list

检查渠道连接状态，–probe 会运行额外的连通性检查

openclaw channels status –probe

查看渠道日志，排查消息收发问题

openclaw channels logs –channel telegram –lines 50

登出并断开指定渠道

openclaw channels logout –channel whatsapp

# 交互式添加渠道，按向导提示完成配置 openclaw channels add

非交互式添加 Telegram 渠道，适合自动化脚本

openclaw channels add –channel telegram –account alerts –name “Alerts Bot” –token $TELEGRAM_BOT_TOKEN

添加飞书渠道（需提前安装飞书插件）

openclaw channels add –channel feishu –account work –name “Work Bot” –app-id $FEISHU_APP_ID --app-secret $FEISHU_APP_SECRET

默认情况下，OpenClaw 会对陌生人的私聊请求进行配对验证，需要手动批准后才能对话：

讯享网# 列出待批准的配对请求 openclaw pairing list whatsapp

批准配对请求

openclaw pairing approve whatsapp

OpenClaw 支持几乎所有主流 AI 模型，这些命令用于配置模型提供商、切换默认模型、管理认证信息。

# 列出所有已配置的模型 openclaw models list

查看当前使用的模型和认证状态

openclaw models status

设置默认模型

openclaw models set anthropic/claude-3-5-sonnet- openclaw models set openai/gpt-4o openclaw models set google/gemini-2.5-pro

设置图像生成模型

openclaw models set-image openai/dall-e-3

讯享网# 配置模型提供商认证，以 Anthropic 为例 openclaw models auth setup-token –provider anthropic

设置模型回退链，当主模型不可用时自动切换到备用模型

openclaw models fallbacks add gpt-4o openclaw models image-fallbacks add dall-e-2

管理模型别名，给长模型名起短名，方便调用

openclaw models aliases add fast-model gpt-4o-mini

这部分命令用于直接和智能体交互、管理对话会话、发送消息，是使用 OpenClaw 完成实际任务的核心操作。

# 直接通过 CLI 向网关发送一条消息并获取回复，常用于测试 openclaw agent –message “帮我总结今天的新闻” –channel telegram

本地嵌入式运行（不经过网关），适合快速测试本地模型

openclaw agent –message “测试本地模型” –local

指定思考级别，让 AI 进行更深度的推理

openclaw agent –message “分析这段代码的性能问题” –thinking high

统一的出站消息及渠道操作工具，支持发送、投票、反应等多种操作：

讯享网# 发送文本消息 openclaw message send –target + –message “Hi from OpenClaw”

创建投票

openclaw message poll –channel discord –target channel:123 –poll-question “Snack?” –poll-option Pizza –poll-option Sushi

给消息添加反应

openclaw message react –channel telegram –target message:123 –emoji 👍

查看和管理存储的对话历史，方便回溯和清理会话：

# 列出最近活跃的会话 openclaw sessions –active 60

查看指定会话的历史记录

openclaw sessions history <session-id>

重置会话，清除上下文

openclaw sessions reset <session-id>

OpenClaw 的技能（Skills）和插件（Plugins）系统可以扩展它的功能，这些命令用于管理这些扩展组件。

讯享网# 列出所有已安装的技能 openclaw skills list

搜索相关技能

openclaw skills search “excel”

安装技能

openclaw skills install @openclaw/office

检查技能就绪情况，查看缺失的依赖

openclaw skills check –verbose

# 列出所有可用插件 openclaw plugins list

安装插件

openclaw plugins install @m1heng-clawd/feishu

启用/禁用插件

openclaw plugins enable feishu openclaw plugins disable feishu

诊断插件加载错误

openclaw plugins doctor

当 OpenClaw 出现问题时，这些命令可以帮你排查故障、修复配置、维护系统健康。

讯享网# 自动检测配置错误、权限问题及旧版服务残留，并提供修复建议 openclaw doctor

深度扫描并尝试自动修复

openclaw doctor –deep –fix

# 跟随最新日志，实时查看网关运行状态 openclaw logs –follow

以 JSON 格式输出最后 200 条日志，便于脚本分析

openclaw logs –limit 200 –json

讯享网# 更新 OpenClaw 到最新版本 openclaw update –channel stable

重置配置和凭证，保留工作区

openclaw reset –scope config+creds –yes

卸载网关服务及所有本地数据

openclaw uninstall –all –yes

OpenClaw 还提供了浏览器自动化和远程节点管理的能力，适合更复杂的自动化场景。

控制无头浏览器进行截图、导航、交互等操作：

# 启动浏览器服务 openclaw browser start

打开网页并截图

openclaw browser open https://example.com openclaw browser screenshot –full-page

模拟点击和输入

openclaw browser click “#login-button” openclaw browser type “#username” “myuser”

管理配对的远程设备节点（如手机、其他电脑），实现跨设备操作：

讯享网# 列出已连接节点 openclaw nodes list

批准节点连接请求

openclaw nodes approve <requestId>

在远程节点执行命令

openclaw nodes run –node <id> –command “ls -la”

给远程节点发送通知

openclaw nodes notify –node <id> –title “任务完成” –body “你的自动化任务已经执行完毕”

除了终端命令，在 OpenClaw 的聊天窗口（如 Telegram、Web 控制台）中，还可以使用斜杠命令快速控制会话和模型。

命令	说明
/new	重置当前会话，清空历史记录，节省 Token 消耗
/compact	压缩上下文，将长对话总结为摘要，减少 Token 占用
/status	查看当前会话状态，包括模型、Token 用量及预估成本
/help	显示所有可用的斜杠命令

# 切换到指定模型 /model claude-3-5-sonnet

列出所有可用模型

/model list

讯享网# 批准待确认的操作 /approve &lt;操作ID&gt; allow-once

拒绝待确认的操作

/deny <操作ID>

控制命令执行的安全策略

/exec host=sandbox security=allowlist ask=always

OpenClaw 的 CLI 设计遵循模块化原则，从基础的初始化到高级的浏览器和节点控制，覆盖了智能体开发生命周期的各个环节。熟练掌握这些命令，你可以灵活配置系统、高效运维服务，让 OpenClaw 成为你的私人数字助理。

日常使用中，建议多利用 –help 查看具体命令的实时帮助，并结合 openclaw doctor 定期维护系统健康。如果你是开发者，还可以通过这些命令搭建自动化脚本，让 OpenClaw 帮你完成更多重复性工作。