渠道 + 会话的诊断。 openclaw status openclaw status --all openclaw status --deep openclaw status --usage 注意事项： --deep 运行实时探测（WhatsApp Web + Telegram + Discord + Google Chat + Slack + Signal）。 当配置了多个智能体时，输出包含每个智能体的会话存储。 概览包含 Gateway 网关 + 节点主机服务安装/运行时状态（如果可用）。 概览包含更新渠道 + git SHA（用于源代码检出）。 更新信息显示在概览中；如果有可用更新，status 会打印提示运行 openclaw update（参见更新）。
Gateway 网关的系统级辅助工具：入队系统事件、控制心跳和查看在线状态。 常用命令 openclaw system event --text "Check for urgent follow-ups" --mode now openclaw system heartbeat enable openclaw system heartbeat last openclaw system presence system event 在主会话上入队系统事件。下一次心跳会将其作为 System: 行注入到提示中。使用 --mode now 立即触发心跳；next-heartbeat 等待下一个计划的心跳时刻。 标志： --text <text>：必填的系统事件文本。 --mode <mode>：now 或 next-heartbeat（默认）。 --json：机器可读输出。 system heartbeat last|enable|disable 心跳控制： last：显示最后一次心跳事件。 enable：重新开启心跳（如果之前被禁用，使用此命令）。 disable：暂停心跳。 标志： --json：机器可读输出。 system presence 列出 Gateway 网关已知的当前系统在线状态条目（节点、实例和类似状态行）。 标志： --json：机器可读输出。 注意 需要一个运行中的 Gateway 网关，可通过你当前的配置访问（本地或远程）。 系统事件是临时的，不会在重启后持久化。
打开连接到 Gateway 网关的终端 UI。 相关： TUI 指南：TUI 示例 openclaw tui openclaw tui --url ws://127.0.0.1:18789 --token <token> openclaw tui --session main --deliver
卸载 Gateway 网关服务 + 本地数据（CLI 保留）。 openclaw uninstall openclaw uninstall --all --yes openclaw uninstall --dry-run
安全更新 OpenClaw 并在 stable/beta/dev 渠道之间切换。 如果你通过 npm/pnpm 安装（全局安装，无 git 元数据），更新通过 更新 中的包管理器流程进行。 用法 openclaw update openclaw update status openclaw update wizard openclaw update --channel beta openclaw update --channel dev openclaw update --tag beta openclaw update --no-restart openclaw update --json openclaw --update 选项 --no-restart：成功更新后跳过重启 Gateway 网关服务。 --channel <stable|beta|dev>：设置更新渠道（git + npm；持久化到配置中）。 --tag <dist-tag|version>：仅为本次更新覆盖 npm dist-tag 或版本。 --json：打印机器可读的 UpdateRunResult JSON。 --timeout <seconds>：每步超时时间（默认 1200 秒）。 注意：降级需要确认，因为旧版本可能会破坏配置。 update status 显示当前更新渠道 + git 标签/分支/SHA（对于源码检出），以及更新可用性。 openclaw update status openclaw update status --json openclaw update status --timeout 10 选项： ...
voicecall 是一个由插件提供的命令。只有在安装并启用了语音通话插件时才会出现。 主要文档： 语音通话插件：语音通话 常用命令 openclaw voicecall status --call-id <id> openclaw voicecall call --to "+15555550123" --message "Hello" --mode notify openclaw voicecall continue --call-id <id> --message "Any questions?" openclaw voicecall end --call-id <id> 暴露 Webhook（Tailscale） openclaw voicecall expose --mode serve openclaw voicecall expose --mode funnel openclaw voicecall unexpose 安全提示：仅将 webhook 端点暴露给你信任的网络。尽可能优先使用 Tailscale Serve 而非 Funnel。
Webhook 辅助工具和集成（Gmail Pub/Sub、Webhook 辅助工具）。 相关内容： Webhook：Webhook Gmail Pub/Sub：Gmail Pub/Sub Gmail openclaw webhooks gmail setup --account [email protected] openclaw webhooks gmail run 详情请参阅 Gmail Pub/Sub 文档。
运行与 OpenClaw Gateway 网关通信的 ACP（Agent Client Protocol）桥接器。 此命令通过 stdio 使用 ACP 协议与 IDE 通信，并通过 WebSocket 将提示转发到 Gateway 网关。它将 ACP 会话映射到 Gateway 网关会话键。 用法 openclaw acp # Remote Gateway openclaw acp --url wss://gateway-host:18789 --token <token> # Attach to an existing session key openclaw acp --session agent:main:main # Attach by label (must already exist) openclaw acp --session-label "support inbox" # Reset the session key before the first prompt openclaw acp --session agent:main:main --reset-session ACP 客户端（调试） 使用内置 ACP 客户端在没有 IDE 的情况下检查桥接器的安装完整性。 它会启动 ACP 桥接器并让你交互式输入提示。 ...
Gateway 网关是 OpenClaw 的 WebSocket 服务器（渠道、节点、会话、hooks）。 本页中的子命令位于 openclaw gateway … 下。 相关文档： /gateway/bonjour /gateway/discovery /gateway/configuration 运行 Gateway 网关 运行本地 Gateway 网关进程： openclaw gateway 前台运行别名： openclaw gateway run 注意事项： 默认情况下，除非在 ~/.openclaw/openclaw.json 中设置了 gateway.mode=local，否则 Gateway 网关将拒绝启动。使用 --allow-unconfigured 进行临时/开发运行。 在没有认证的情况下绑定到 loopback 之外的地址会被阻止（安全护栏）。 SIGUSR1 在授权时触发进程内重启（启用 commands.restart 或使用 gateway 工具/config apply/update）。 SIGINT/SIGTERM 处理程序会停止 Gateway 网关进程，但不会恢复任何自定义终端状态。如果你用 TUI 或 raw-mode 输入包装 CLI，请在退出前恢复终端。 选项 --port <port>：WebSocket 端口（默认来自配置/环境变量；通常为 18789）。 --bind <loopback|lan|tailnet|auto|custom>：监听器绑定模式。 --auth <token|password>：认证模式覆盖。 --token <token>：令牌覆盖（同时为进程设置 OPENCLAW_GATEWAY_TOKEN）。 --password <password>：密码覆盖（同时为进程设置 OPENCLAW_GATEWAY_PASSWORD）。 --tailscale <off|serve|funnel>：通过 Tailscale 暴露 Gateway 网关。 --tailscale-reset-on-exit：关闭时重置 Tailscale serve/funnel 配置。 --allow-unconfigured：允许在配置中没有 gateway.mode=local 的情况下启动 Gateway 网关。 --dev：如果缺失则创建开发配置 + 工作区（跳过 BOOTSTRAP.md）。 --reset：重置开发配置 + 凭证 + 会话 + 工作区（需要 --dev）。 --force：启动前杀死所选端口上的任何现有监听器。 --verbose：详细日志。 --claude-cli-logs：仅在控制台显示 claude-cli 日志（并启用其 stdout/stderr）。 --ws-log <auto|full|compact>：WebSocket 日志样式（默认 auto）。 --compact：--ws-log compact 的别名。 --raw-stream：将原始模型流事件记录到 jsonl。 --raw-stream-path <path>：原始流 jsonl 路径。 查询运行中的 Gateway 网关 所有查询命令使用 WebSocket RPC。 ...
管理基于 Docker 的沙箱容器，用于隔离智能体执行。 概述 OpenClaw 可以在隔离的 Docker 容器中运行智能体以确保安全。sandbox 命令帮助你管理这些容器，特别是在更新或配置更改后。 命令 openclaw sandbox explain 检查生效的沙箱模式/作用域/工作区访问权限、沙箱工具策略和提权门控（附带修复配置的键路径）。 openclaw sandbox explain openclaw sandbox explain --session agent:main:main openclaw sandbox explain --agent work openclaw sandbox explain --json openclaw sandbox list 列出所有沙箱容器及其状态和配置。 openclaw sandbox list openclaw sandbox list --browser # List only browser containers openclaw sandbox list --json # JSON output 输出包括： 容器名称和状态（运行中/已停止） Docker 镜像及其是否与配置匹配 创建时间 空闲时间（自上次使用以来的时间） 关联的会话/智能体 openclaw sandbox recreate 移除沙箱容器以强制使用更新的镜像/配置重新创建。 openclaw sandbox recreate --all # Recreate all containers openclaw sandbox recreate --session main # Specific session openclaw sandbox recreate --agent mybot # Specific agent openclaw sandbox recreate --browser # Only browser containers openclaw sandbox recreate --all --force # Skip confirmation 选项： ...