通过 Gateway 网关运行智能体回合（使用 --local 进行嵌入式运行）。使用 --agent <id> 直接指定已配置的智能体。 相关内容： 智能体发送工具：Agent send 示例 openclaw agent --to +15555550123 --message "status update" --deliver openclaw agent --agent ops --message "Summarize logs" openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium openclaw agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"
管理隔离的智能体（工作区 + 认证 + 路由）。 相关内容： 多智能体路由：多智能体路由 智能体工作区：智能体工作区 示例 openclaw agents list openclaw agents add work --workspace ~/.openclaw/workspace-work openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity openclaw agents set-identity --agent main --avatar avatars/openclaw.png openclaw agents delete work 身份文件 每个智能体工作区可以在工作区根目录包含一个 IDENTITY.md： 示例路径：~/.openclaw/workspace/IDENTITY.md set-identity --from-identity 从工作区根目录读取（或从显式指定的 --identity-file 读取） 头像路径相对于工作区根目录解析。 设置身份 set-identity 将字段写入 agents.list[].identity： name theme emoji avatar（工作区相对路径、http(s) URL 或 data URI） 从 IDENTITY.md 加载： openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity 显式覆盖字段： openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞" --avatar avatars/openclaw.png 配置示例： ...
管理本地主机、Gateway 网关主机或节点主机的执行审批。 默认情况下，命令针对磁盘上的本地审批文件。使用 --gateway 可针对 Gateway 网关，使用 --node 可针对特定节点。 相关内容： 执行审批：执行审批 节点：节点 常用命令 openclaw approvals get openclaw approvals get --node <id|name|ip> openclaw approvals get --gateway 从文件替换审批 openclaw approvals set --file ./exec-approvals.json openclaw approvals set --node <id|name|ip> --file ./exec-approvals.json openclaw approvals set --gateway --file ./exec-approvals.json 允许列表辅助命令 openclaw approvals allowlist add "~/Projects/**/bin/rg" openclaw approvals allowlist add --agent main --node <id|name|ip> "/usr/bin/uptime" openclaw approvals allowlist add --agent "*" "/usr/bin/uname" openclaw approvals allowlist remove "~/Projects/**/bin/rg" 注意事项 --node 使用与 openclaw nodes 相同的解析器（id、name、ip 或 id 前缀）。 --agent 默认为 "*"，表示适用于所有智能体。 节点主机必须公开 system.execApprovals.get/set（macOS 应用或无头节点主机）。 审批文件按主机存储在 ~/.openclaw/exec-approvals.json。
管理 OpenClaw 的浏览器控制服务器并运行浏览器操作（标签页、快照、截图、导航、点击、输入）。 相关： 浏览器工具 + API：浏览器工具 Chrome 扩展中继：Chrome 扩展 通用标志 --url <gatewayWsUrl>：Gateway 网关 WebSocket URL（默认从配置获取）。 --token <token>：Gateway 网关令牌（如果需要）。 --timeout <ms>：请求超时（毫秒）。 --browser-profile <name>：选择浏览器配置文件（默认从配置获取）。 --json：机器可读输出（在支持的地方）。 快速开始（本地） openclaw browser --browser-profile chrome tabs openclaw browser --browser-profile openclaw start openclaw browser --browser-profile openclaw open https://example.com openclaw browser --browser-profile openclaw snapshot 配置文件 配置文件是命名的浏览器路由配置。实际上： openclaw：启动/附加到专用的 OpenClaw 管理的 Chrome 实例（隔离的用户数据目录）。 chrome：通过 Chrome 扩展中继控制你现有的 Chrome 标签页。 openclaw browser profiles openclaw browser create-profile --name work --color "#FF5A36" openclaw browser delete-profile --name work 使用特定配置文件： ...
管理 Gateway 网关上的聊天渠道账户及其运行时状态。 相关文档： 渠道指南：渠道 Gateway 网关配置：配置 常用命令 openclaw channels list openclaw channels status openclaw channels capabilities openclaw channels capabilities --channel discord --target channel:123 openclaw channels resolve --channel slack "#general" "@jane" openclaw channels logs --channel all 添加/删除账户 openclaw channels add --channel telegram --token <bot-token> openclaw channels remove --channel telegram --delete 提示：openclaw channels add --help 显示每个渠道的标志（token、app token、signal-cli 路径等）。 登录/登出（交互式） openclaw channels login --channel whatsapp openclaw channels logout --channel whatsapp 故障排除 运行 openclaw status --deep 进行全面探测。 使用 openclaw doctor 获取引导式修复。 openclaw channels list 输出 Claude: HTTP 403 ... user:profile → 用量快照需要 user:profile 权限范围。使用 --no-usage，或提供 claude.ai 会话密钥（CLAUDE_WEB_SESSION_KEY / CLAUDE_WEB_COOKIE），或通过 Claude Code CLI 重新授权。 能力探测 获取提供商能力提示（可用的 intents/scopes）以及静态功能支持： ...
配置辅助命令：通过路径获取/设置/取消设置值。不带子命令运行将打开 配置向导（与 openclaw configure 相同）。 示例 openclaw config get browser.executablePath openclaw config set browser.executablePath "/usr/bin/google-chrome" openclaw config set agents.defaults.heartbeat.every "2h" openclaw config set agents.list[0].tools.exec.node "node-id-or-name" openclaw config unset tools.web.search.apiKey 路径 路径使用点号或括号表示法： openclaw config get agents.defaults.workspace openclaw config get agents.list[0].id 使用智能体列表索引来定位特定智能体： openclaw config get agents.list openclaw config set agents.list[1].tools.exec.node "node-id-or-name" 值 值会尽可能解析为 JSON5；否则将被视为字符串。 使用 --json 强制要求 JSON5 解析。 openclaw config set agents.defaults.heartbeat.every "0m" openclaw config set gateway.port 19001 --json openclaw config set channels.whatsapp.groups '["*"]' --json 编辑后请重启 Gateway 网关。
用于设置凭证、设备和智能体默认值的交互式提示。 注意：模型部分现在包含一个用于 agents.defaults.models 允许列表的多选项（显示在 /model 和模型选择器中的内容）。 提示：不带子命令的 openclaw config 会打开相同的向导。使用 openclaw config get|set|unset 进行非交互式编辑。 相关内容： Gateway 网关配置参考：配置 Config CLI：Config 注意事项： 选择 Gateway 网关运行位置始终会更新 gateway.mode。如果这是你唯一需要的，可以不选择其他部分直接选择"继续"。 面向渠道的服务（Slack/Discord/Matrix/Microsoft Teams）在设置期间会提示输入频道/房间允许列表。你可以输入名称或 ID；向导会尽可能将名称解析为 ID。 示例 openclaw configure openclaw configure --section models --section channels
管理 Gateway 网关调度器的 cron 作业。 相关内容： Cron 作业：Cron 作业 提示：运行 openclaw cron --help 查看完整的命令集。 说明：隔离式 cron add 任务默认使用 --announce 投递摘要。使用 --no-deliver 仅内部运行。 --deliver 仍作为 --announce 的弃用别名保留。 说明：一次性（--at）任务成功后默认删除。使用 --keep-after-run 保留。 常见编辑 更新投递设置而不更改消息： openclaw cron edit <job-id> --announce --channel telegram --to "123456789" 为隔离的作业禁用投递： openclaw cron edit <job-id> --no-deliver
使用当前认证信息打开控制界面。 openclaw dashboard openclaw dashboard --no-open
管理设备配对请求和设备范围的 token。 命令 openclaw devices list 列出待处理的配对请求和已配对的设备。 openclaw devices list openclaw devices list --json openclaw devices approve <requestId> 批准待处理的设备配对请求。 openclaw devices approve <requestId> openclaw devices reject <requestId> 拒绝待处理的设备配对请求。 openclaw devices reject <requestId> openclaw devices rotate --device <id> --role <role> [--scope <scope...>] 为特定角色轮换设备 token（可选更新 scope）。 openclaw devices rotate --device <deviceId> --role operator --scope operator.read --scope operator.write openclaw devices revoke --device <id> --role <role> 为特定角色撤销设备 token。 openclaw devices revoke --device <deviceId> --role node 通用选项 --url <url>：Gateway 网关 WebSocket URL（配置后默认使用 gateway.remote.url）。 --token <token>：Gateway 网关 token（如需要）。 --password <password>：Gateway 网关密码（密码认证）。 --timeout <ms>：RPC 超时。 --json：JSON 输出（推荐用于脚本）。 注意事项 Token 轮换会返回新 token（敏感信息）。请像对待密钥一样对待它。 这些命令需要 operator.pairing（或 operator.admin）scope。