管理 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 中跟踪）。

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

交互式新手引导向导（本地或远程 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，无需渠道设置）。

管理已配对的节点（设备）并调用节点功能。 相关内容： 节点概述：节点 摄像头：摄像头节点 图像：图像节点 通用选项： --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 网关 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>：覆盖节点显示名称 服务（后台） 将无头节点主机安装为用户服务。 ...

模型发现、扫描和配置（默认模型、回退、认证配置）。 相关内容： 提供商 + 模型：模型 提供商认证设置：快速开始 常用命令 openclaw models status openclaw models list openclaw models set <model-or-alias> openclaw models scan openclaw models status 显示已解析的默认模型/回退配置以及认证概览。 当提供商使用快照可用时，OAuth/令牌状态部分会包含提供商使用头信息。 添加 --probe 可对每个已配置的提供商配置运行实时认证探测。 探测会发送真实请求（可能消耗令牌并触发速率限制）。 使用 --agent <id> 可检查已配置智能体的模型/认证状态。省略时， 命令会使用 OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR（如已设置），否则使用 已配置的默认智能体。 注意事项： models set <model-or-alias> 接受 provider/model 或别名。 模型引用通过在第一个 / 处拆分来解析。如果模型 ID 包含 /（OpenRouter 风格），需包含提供商前缀（示例：openrouter/moonshotai/kimi-k2）。 如果省略提供商，OpenClaw 会将输入视为别名或默认提供商的模型（仅在模型 ID 不包含 / 时有效）。 models status 选项： --json --plain --check（退出码 1=已过期/缺失，2=即将过期） --probe（对已配置的认证配置进行实时探测） --probe-provider <name>（探测单个提供商） --probe-profile <id>（可重复或逗号分隔的配置 ID） --probe-timeout <ms> --probe-concurrency <n> --probe-max-tokens <n> --agent <id>（已配置的智能体 ID；覆盖 OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR） 别名 + 回退 openclaw models aliases list openclaw models fallbacks list 认证配置 openclaw models auth add openclaw models auth login --provider <id> openclaw models auth setup-token openclaw models auth paste-token models auth login 运行提供商插件的认证流程（OAuth/API 密钥）。使用 openclaw plugins list 查看已安装的提供商。 ...

用于发送消息和渠道操作的单一出站命令 （Discord/Google Chat/Slack/Mattermost（插件）/Telegram/WhatsApp/Signal/iMessage/MS Teams）。 用法 openclaw message <subcommand> [flags] 渠道选择： 如果配置了多个渠道，则必须指定 --channel。 如果只配置了一个渠道，则该渠道为默认值。 可选值：whatsapp|telegram|discord|googlechat|slack|mattermost|signal|imessage|msteams（Mattermost 需要插件） 目标格式（--target）： WhatsApp：E.164 或群组 JID Telegram：聊天 ID 或 @username Discord：channel:<id> 或 user:<id>（或 <@id> 提及；纯数字 ID 被视为频道） Google Chat：spaces/<spaceId> 或 users/<userId> Slack：channel:<id> 或 user:<id>（接受纯频道 ID） Mattermost（插件）：channel:<id>、user:<id> 或 @username（纯 ID 被视为频道） Signal：+E.164、group:<id>、signal:+E.164、signal:group:<id> 或 username:<name>/u:<name> iMessage：句柄、chat_id:<id>、chat_guid:<guid> 或 chat_identifier:<id> MS Teams：会话 ID（19:[email protected]）或 conversation:<id> 或 user:<aad-object-id> 名称查找： 对于支持的提供商（Discord/Slack 等），如 Help 或 #help 之类的频道名称会通过目录缓存进行解析。 缓存未命中时，如果提供商支持，OpenClaw 将尝试实时目录查找。 通用标志 --channel <name> --account <id> --target <dest>（用于 send/poll/read 等的目标渠道或用户） --targets <name>（可重复；仅限广播） --json --dry-run --verbose 操作 核心 send ...

管理语义记忆的索引和搜索。 由活跃的记忆插件提供（默认：memory-core；设置 plugins.slots.memory = "none" 可禁用）。 相关内容： 记忆概念：记忆 插件：插件 示例 openclaw memory status openclaw memory status --deep openclaw memory status --deep --index openclaw memory status --deep --index --verbose openclaw memory index openclaw memory index --verbose openclaw memory search "release checklist" openclaw memory status --agent main openclaw memory index --agent main --verbose 选项 通用选项： --agent <id>：限定到单个智能体（默认：所有已配置的智能体）。 --verbose：在探测和索引期间输出详细日志。 说明： memory status --deep 探测向量存储和嵌入模型的可用性。 memory status --deep --index 在存储有未同步变更时运行重新索引。 memory index --verbose 打印每个阶段的详细信息（提供商、模型、数据源、批处理活动）。 memory status 包含通过 memorySearch.extraPaths 配置的所有额外路径。

通过 RPC 跟踪 Gateway 网关文件日志（在远程模式下可用）。 相关内容： 日志概述：日志 示例 openclaw logs openclaw logs --follow openclaw logs --json openclaw logs --limit 500

管理智能体钩子（针对 /new、/reset 等命令以及 Gateway 网关启动的事件驱动自动化）。 相关内容： 钩子：钩子 插件钩子：插件 列出所有钩子 openclaw hooks list 列出从工作区、托管目录和内置目录中发现的所有钩子。 选项： --eligible：仅显示符合条件的钩子（满足要求） --json：以 JSON 格式输出 -v, --verbose：显示详细信息，包括缺失的要求 示例输出： Hooks (3/3 ready) Ready: 🚀 boot-md ✓ - Run BOOT.md on gateway startup 📝 command-logger ✓ - Log all command events to a centralized audit file 💾 session-memory ✓ - Save session context to memory when /new command is issued 示例（详细模式）： openclaw hooks list --verbose 显示不符合条件的钩子缺失的要求。 示例（JSON）： openclaw hooks list --json 返回结构化 JSON，供程序化使用。 ...