Cli

运行一个无头节点主机，连接到 Gateway 网关 WebSocket 并在此机器上暴露 system.run / system.which。 为什么使用节点主机？ 当你希望智能体在网络中的其他机器上运行命令，而无需在那里安装完整的 macOS 配套应用时，请使用节点主机。 常见用例： 在远程 Linux/Windows 机器上运行命令（构建服务器、实验室机器、NAS）。 在 Gateway 网关上保持执行的沙箱隔离，但将批准的运行委托给其他主机。 为自动化或 CI 节点提供轻量级、无头的执行目标。 执行仍然受执行批准和节点主机上的每智能体允许列表保护，因此你可以保持命令访问的范围明确。 浏览器代理（零配置） 如果节点上的 browser.enabled 未被禁用，节点主机会自动广播浏览器代理。这让智能体无需额外配置即可在该节点上使用浏览器自动化。 如需在节点上禁用： { nodeHost: { browserProxy: { enabled: false, }, }, } 运行（前台） openclaw node run --host <gateway-host> --port 18789 选项： --host <host>：Gateway 网关 WebSocket 主机（默认：127.0.0.1） --port <port>：Gateway 网关 WebSocket 端口（默认：18789） --tls：为 Gateway 网关连接使用 TLS --tls-fingerprint <sha256>：预期的 TLS 证书指纹（sha256） --node-id <id>：覆盖节点 id（清除配对 token） --display-name <name>：覆盖节点显示名称 服务（后台） 将无头节点主机安装为用户服务。 ...

管理已配对的节点（设备）并调用节点功能。 相关内容： 节点概述：节点 摄像头：摄像头节点 图像：图像节点 通用选项： --url、--token、--timeout、--json 常用命令 openclaw nodes list openclaw nodes list --connected openclaw nodes list --last-connected 24h openclaw nodes pending openclaw nodes approve <requestId> openclaw nodes status openclaw nodes status --connected openclaw nodes status --last-connected 24h nodes list 打印待处理/已配对表格。已配对行包含最近连接时长（Last Connect）。 使用 --connected 仅显示当前已连接的节点。使用 --last-connected <duration> 筛选在指定时间段内连接过的节点（例如 24h、7d）。 调用 / 运行 openclaw nodes invoke --node <id|name|ip> --command <command> --params <json> openclaw nodes run --node <id|name|ip> <command...> openclaw nodes run --raw "git status" openclaw nodes run --agent main --node <id|name|ip> --raw "git status" 调用标志： ...

交互式新手引导向导（本地或远程 Gateway 网关设置）。 相关内容： 向导指南：新手引导 示例 openclaw onboard openclaw onboard --flow quickstart openclaw onboard --flow manual openclaw onboard --mode remote --remote-url ws://gateway-host:18789 流程说明： quickstart：最少提示，自动生成 Gateway 网关令牌。 manual：完整的端口/绑定/认证提示（advanced 的别名）。 最快开始聊天：openclaw dashboard（控制 UI，无需渠道设置）。

批准或检查私信配对请求（适用于支持配对的渠道）。 相关内容： 配对流程：配对 命令 openclaw pairing list whatsapp openclaw pairing approve whatsapp <code> --notify

管理 Gateway 网关插件/扩展（进程内加载）。 相关内容： 插件系统：插件 插件清单 + 模式：插件清单 安全加固：安全 命令 openclaw plugins list openclaw plugins info <id> openclaw plugins enable <id> openclaw plugins disable <id> openclaw plugins doctor openclaw plugins update <id> openclaw plugins update --all 内置插件随 OpenClaw 一起发布，但默认禁用。使用 plugins enable 来激活它们。 所有插件必须提供 openclaw.plugin.json 文件，其中包含内联 JSON Schema（configSchema，即使为空）。缺少或无效的清单或模式会阻止插件加载并导致配置验证失败。 安装 openclaw plugins install <path-or-spec> 安全提示：将插件安装视为运行代码。优先使用固定版本。 支持的归档格式：.zip、.tgz、.tar.gz、.tar。 使用 --link 避免复制本地目录（添加到 plugins.load.paths）： openclaw plugins install -l ./my-plugin 更新 openclaw plugins update <id> openclaw plugins update --all openclaw plugins update <id> --dry-run 更新仅适用于从 npm 安装的插件（在 plugins.installs 中跟踪）。

重置本地配置/状态（保留 CLI 安装）。 openclaw reset openclaw reset --dry-run openclaw reset --scope config+creds+sessions --yes --non-interactive

安全工具（审计 + 可选修复）。 相关： 安全指南：安全 审计 openclaw security audit openclaw security audit --deep openclaw security audit --fix 当多个私信发送者共享主会话时，审计会发出警告，并建议对共享收件箱使用 session.dmScope="per-channel-peer"（或多账户渠道使用 per-account-channel-peer）。 当使用小模型（<=300B）且未启用沙箱隔离但启用了 web/browser 工具时，它也会发出警告。

列出已存储的对话会话。 openclaw sessions openclaw sessions --active 120 openclaw sessions --json

初始化 ~/.openclaw/openclaw.json 和智能体工作区。 相关内容： 快速开始：快速开始 向导：新手引导 示例 openclaw setup openclaw setup --workspace ~/.openclaw/workspace 通过 setup 运行向导： openclaw setup --wizard

检查 Skills（内置 + 工作区 + 托管覆盖）并查看哪些符合条件，哪些缺少要求。 相关内容： Skills 系统：Skills Skills 配置：Skills 配置 ClawHub 安装：ClawHub 命令 openclaw skills list openclaw skills list --eligible openclaw skills info <name> openclaw skills check