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 # 非交互式模式，指定远程网关 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 channelsGateway 是 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 tuiOpenClaw 支持接入 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 openclaw 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 --yesOpenClaw 还提供了浏览器自动化和远程节点管理的能力，适合更复杂的自动化场景。
控制无头浏览器进行截图、导航、交互等操作：
# 启动浏览器服务 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 <操作ID> allow-once # 拒绝待确认的操作 /deny <操作ID> # 控制命令执行的安全策略 /exec host=sandbox security=allowlist ask=alwaysOpenClaw 的 CLI 设计遵循模块化原则，从基础的初始化到高级的浏览器和节点控制，覆盖了智能体开发生命周期的各个环节。熟练掌握这些命令，你可以灵活配置系统、高效运维服务，让 OpenClaw 成为你的私人数字助理。
日常使用中，建议多利用 --help 查看具体命令的实时帮助，并结合 openclaw doctor 定期维护系统健康。如果你是开发者，还可以通过这些命令搭建自动化脚本，让 OpenClaw 帮你完成更多重复性工作。
发布者：Ai探索者，转载请注明出处：https://javaforall.net/258400.html原文链接：https://javaforall.net
