快速入口

常见问题入口

使用建议

  • 先看本页，再跳到详细专题
  • 先看 status，再看 logs --follow
  • 改配置前先确认对象，再执行修改；批量改可用 config patch
  • 浏览器自动化优先 snapshot
  • 记忆排障优先 memory status、memory index、memory search
  • 查持久任务看 tasks，查 transcripts 看 transcripts

常用命令速查

1. 启动、状态、排错

openclaw status
openclaw status --deep
openclaw gateway status
openclaw health
openclaw logs --follow
openclaw doctor
# 新增：
openclaw doctor --fix          # 自动修复常见问题
openclaw gateway stability     # Gateway 稳定性快照
openclaw gateway usage-cost    # 用量与费用估算
openclaw tui                   # 终端 TUI（替代 dashboard）
openclaw chat                  # 独立聊天终端

详见：Gateway 与诊断

2. 初始化与配置

openclaw setup --wizard         # 推荐：交互式引导（替代旧 onboard）
openclaw configure               # 交互式配置
openclaw config file
openclaw config get <path>
openclaw config set <path> <value>
openclaw config patch --file ./patch.json5  # 批量补丁修改（v2026.5.26 新增）
openclaw config schema                      # 查看配置 JSON Schema（v2026.5.26 新增）
openclaw config validate
openclaw crestodian             # 交互式设置与修复助手（v2026.5.26 新增）

详见：配置与模型

3. 模型与认证

openclaw models status
openclaw models list
openclaw models set <model>
openclaw models set-image <model>
openclaw models scan
openclaw models aliases list           # 模型别名（v2026.5.26 新增）
openclaw models fallbacks list          # 回退链（v2026.5.26 新增）
openclaw models auth add               # 认证 profiles（v2026.5.26 新增）
openclaw secrets audit
openclaw secrets reload
openclaw secrets configure              # 交互式 secret 配置（v2026.5.26 新增）
openclaw secrets apply --from plan.json # 基于计划文件应用 secret

详见：配置与模型

4. 频道与消息

openclaw channels list
openclaw channels status
openclaw channels add
openclaw channels login
openclaw channels resolve
openclaw message send --target <target> --message "Hi"
openclaw message poll <...>
openclaw message react <...>
openclaw message search --channel <name> --query "关键词"  # 搜索历史消息（v2026.5.26 新增）
openclaw message voice --channel <name> --message "Hi"    # 语音消息（v2026.5.26 新增）
openclaw message broadcast --channel <name> --message "Hi" # 广播（v2026.5.26 新增）
openclaw message ban/kick --channel <name> --target <id>   # 频道管理（v2026.5.26 新增）

详见：频道与消息

5. Agent、会话、记忆

openclaw agent --message "帮我总结今天日志"
openclaw agent --deliver --to +1555... --message "Run summary"  # 投递结果到频道
openclaw sessions --active 120
openclaw sessions cleanup              # 会话运维清理（v2026.5.26 新增）
openclaw sessions export-trajectory    # 导出 trajectory（v2026.5.26 新增）
openclaw memory status
openclaw memory index --force
openclaw memory search "上次讨论的配置"
openclaw memory promote --apply        # 短期记忆提升为长期（REM，v2026.5.26 新增）
openclaw memory rem-backfill            # 写回 REM 摘要（v2026.5.26 新增）
openclaw tasks list                     # 持久后台任务（v2026.5.26 新增）
openclaw tasks show <id>
openclaw tasks flow                     # TaskFlow 状态
openclaw transcripts list               # 检视 transcripts（v2026.5.26 新增）
openclaw transcripts show <id>

详见：Agent / 会话 / 记忆

6. 浏览器自动化与定时任务

openclaw browser start --profile <name>  # 支持多 profile
openclaw browser open <url>
openclaw browser snapshot
openclaw browser click <ref>
openclaw browser type <ref> "hello" --submit
openclaw browser screenshot --full-page
openclaw browser pdf <url>               # 生成 PDF（v2026.5.26 新增）
openclaw browser evaluate "document.title"  # 执行 JS（v2026.5.26 新增）
openclaw browser profiles list          # 管理 profile（v2026.5.26 新增）
openclaw browser trace start/stop       # 录制/回放（v2026.5.26 新增）
openclaw browser cookies get <domain>   # Cookie 操作（v2026.5.26 新增）
openclaw cron list
openclaw cron add
openclaw cron runs --id <id>

详见：浏览器与自动化

7. Nodes 与远程操作

openclaw node status
openclaw nodes status
openclaw nodes describe --node <id>
openclaw nodes list                      # 列出所有配对节点
openclaw nodes notify --node <id> --body "任务完成"
openclaw nodes camera snap --node <id>
openclaw nodes camera clip --node <id>   # 录制视频片段（v2026.5.26 新增）
openclaw nodes screen record --node <id> # 录屏（v2026.5.26 新增）
openclaw nodes canvas present --node <id> --url <url>  # Canvas（v2026.5.26 新增）
openclaw nodes location get --node <id>
openclaw nodes pending                   # 查看待审批的配对请求（v2026.5.26 新增）
openclaw nodes approve/reject <id>       # 审批/拒绝（v2026.5.26 新增）
openclaw nodes push/remove/rename <id>   # 节点管理（v2026.5.26 新增）

详见：Nodes 与远程操作

8. Skills、插件、安全与维护

openclaw skills check
openclaw skills search <query>
openclaw skills install <slug>
openclaw skills update <slug>            # 更新 Skill（v2026.5.26 新增）
openclaw plugins list
openclaw plugins doctor
openclaw plugins marketplace search      # 插件市场（v2026.5.26 新增）
openclaw plugins install/update/remove   # 插件生命周期扩展
openclaw plugins validate                # 校验插件（v2026.5.26 新增）
openclaw security audit
openclaw security audit --deep           # 深度审计（v2026.5.26 新增）
openclaw backup verify
openclaw sandbox list/explain            # sandbox 管理（v2026.5.26 新增）
openclaw update

详见：Skills / 插件 / 安全 / 维护