统一接入层
把多个消息渠道接到一个 Gateway,减少渠道级的重复配置与切换成本。
如果你不想为每个聊天渠道、每个 Agent、每套运维流程分别维护一套系统,OpenClaw 的价值就会比较明显。
把多个消息渠道接到一个 Gateway,减少渠道级的重复配置与切换成本。
CLI、Web UI、桌面端与自动化脚本通过同一套 Gateway 状态与协议协作,排障路径也更集中。
借助 status、doctor、pairing、memory、models 等能力,把可用性与安全控制拉到同一个面板里。
官方文档里最关键的理解是:所有能力围绕 Gateway 展开,CLI、控制台、设备节点都围绕它连接和协作。
长期运行的核心进程,负责维护消息渠道连接、暴露 WebSocket API、同步状态与事件分发。
CLI、Web 控制台、桌面端和自动化工具都作为控制面客户端接入,统一请求状态、消息和 Agent 调用。
macOS、iOS、Android 或 headless 设备可作为 node 接入,但需要独立的设备配对与权限控制。
真正对外提供服务时,消息渠道、模型、记忆、插件和 Agent 会一起围绕 Gateway 协同工作。
第一次接触 OpenClaw,建议先把“安装、初始化、打开控制台”这三步跑通。
# 1) 检查当前 Node.js 版本,确认是否满足 Node 22+ 要求
node --version
# 2) 使用官方安装脚本安装 OpenClaw
curl -fsSL https://openclaw.ai/en/docs/install.sh | bash
# 3) 执行首次引导,并顺带安装守护进程方便后台运行
openclaw onboard --install-daemon
# 4) 打开 Web 控制台,最快验证 OpenClaw 是否已经可用
openclaw dashboard
openclaw setup 开始。http://127.0.0.1:18789/。openclaw gateway status 看运行状态。下面这部分把 README 里的核心命令做成了卡片版,适合日常快速浏览。
setup / onboard / configure初始化与配置# 初始化默认配置文件和默认工作区
openclaw setup
# 把工作区显式创建到指定目录,适合自定义目录结构
openclaw setup --workspace ~/.openclaw/workspace
# 用 setup 方式进入引导式初始化流程
openclaw setup --wizard
# 执行完整首次引导,并安装后台守护进程
openclaw onboard --install-daemon
# 打开交互式配置界面,统一调整现有配置
openclaw configure
# 只定向修改模型和渠道相关配置,避免改动其他部分
openclaw configure --section model --section channels
status / doctor / dashboard运行与排障# 查看 OpenClaw 的整体状态总览
openclaw status
# 展示更完整的状态信息
openclaw status --all
# 对渠道和服务做更深入的在线探测
openclaw status --deep
# 连同使用量信息一起输出
openclaw status --usage
# 执行基础健康检查并给出排障建议
openclaw doctor
# 尝试自动修复常见配置问题
openclaw doctor --repair
# 执行更深入的诊断检查
openclaw doctor --deep
# 直接打开 Web 控制台
openclaw dashboard
# 只启动控制台服务但不自动打开浏览器
openclaw dashboard --no-open
models模型管理# 查看当前默认模型、回退模型和认证状态
openclaw models status
# 列出可用模型或已识别的模型候选
openclaw models list
# 设置默认模型,可以传模型名或别名
openclaw models set <model-or-alias>
# 重新扫描模型与认证配置
openclaw models scan
# 查看当前配置的模型别名
openclaw models aliases list
# 查看回退模型链路
openclaw models fallbacks list
# 新增一个模型认证配置
openclaw models auth add
# 针对指定 provider 执行登录或授权流程
openclaw models auth login --provider <id>
models status --probe 会做真实探测,可能消耗 token。
channels渠道管理# 列出当前已经配置的所有渠道
openclaw channels list
# 查看各渠道当前运行状态
openclaw channels status
# 查看渠道支持的能力与限制
openclaw channels capabilities
# 查看全部渠道的运行日志
openclaw channels logs --channel all
# 为 Telegram 新增一个 bot 账号
openclaw channels add --channel telegram --token <bot-token>
# 删除 Telegram 渠道配置,并清理对应账号
openclaw channels remove --channel telegram --delete
# 对 WhatsApp 渠道执行登录流程
openclaw channels login --channel whatsapp
# 退出 WhatsApp 渠道登录状态
openclaw channels logout --channel whatsapp
# 把 Slack 中的频道名和用户昵称解析成实际 ID
openclaw channels resolve --channel slack "#general" "@jane"
message消息动作# 给默认渠道中的目标号码发送一条文本消息
openclaw message send --target +15555550123 --message "Hello from OpenClaw"
# 在 Discord 的指定频道发送一条消息
openclaw message send --channel discord --target channel:123 --message "hi"
# 给 Slack 中指定消息添加一个勾选表情反应
openclaw message react --channel slack --target C123 --message-id 456 --emoji "✅"
--channel。--target 格式不同,发送前最好先确认。memory / pairing / devices记忆与安全# 查看语义记忆插件和索引状态
openclaw memory status
# 深度检查记忆能力,包括 embedding 和向量能力
openclaw memory status --deep
# 手动触发一次语义记忆重新索引
openclaw memory index
# 在语义记忆中搜索指定关键词
openclaw memory search "release checklist"
# 查看 Telegram 渠道当前待审批的配对请求
openclaw pairing list telegram
# 批准某个 Telegram 配对码,让该发送者获得访问权限
openclaw pairing approve telegram <CODE>
# 查看当前待配对或已配对的设备列表
openclaw devices list
# 批准一个设备接入请求
openclaw devices approve <requestId>
# 拒绝一个设备接入请求
openclaw devices reject <requestId>
如果只保留最有用的最小集合,这一组基本能覆盖安装、验证、排障和一次简单测试。
# 首次引导并安装后台守护进程
openclaw onboard --install-daemon
# 打开控制台快速验证系统是否可用
openclaw dashboard
# 查看当前整体状态
openclaw status
# 做一次深度诊断
openclaw doctor --deep
# 查看模型配置与认证状态
openclaw models status
# 查看当前有哪些渠道已经接入
openclaw channels list
# 发送一条 Telegram 测试消息
openclaw message send --channel telegram --target @yourchat --message "hello"
# 查看语义记忆当前状态
openclaw memory status
这一部分补上更接近完整 CLI 的常见入口,尤其是你提到的 openclaw tui,以及健康检查、Gateway 管理、会话维护、多 Agent 和日志能力。
tui / health终端界面与健康检查# 打开默认的 OpenClaw 终端交互界面
openclaw tui
# 连接指定 Gateway 地址和 token 打开终端界面
openclaw tui --url ws://127.0.0.1:18789 --token <token>
# 打开指定 session,并启用 deliver 模式
openclaw tui --session main --deliver
# 查看当前 Gateway 健康状态
openclaw health
# 用 JSON 形式输出健康信息
openclaw health --json
# 执行更详细的健康探测
openclaw health --verbose
gateway网关核心管理# 以前台方式直接启动 Gateway
openclaw gateway
# 使用 run 别名启动 Gateway
openclaw gateway run
# 查看 Gateway 服务状态
openclaw gateway status
# 探测当前可访问的 Gateway
openclaw gateway probe
# 调用底层 RPC 方法调试 Gateway
openclaw gateway call status
# 安装 Gateway 服务
openclaw gateway install
# 启动 Gateway 服务
openclaw gateway start
# 停止 Gateway 服务
openclaw gateway stop
# 重启 Gateway 服务
openclaw gateway restart
# 卸载 Gateway 服务
openclaw gateway uninstall
sessions会话管理# 查看默认 agent 的会话列表
openclaw sessions
# 查看指定 agent 的会话
openclaw sessions --agent work
# 汇总所有 agent 的会话
openclaw sessions --all-agents
# 只看最近活跃的会话
openclaw sessions --active 120
# 用 JSON 形式输出会话信息
openclaw sessions --json
# 预演一次会话清理,不真正写入
openclaw sessions cleanup --dry-run
# 强制执行会话清理
openclaw sessions cleanup --enforce
agents多 Agent 与路由# 列出当前已配置的所有 agent
openclaw agents list
# 新增一个独立工作区的 agent
openclaw agents add work --workspace ~/.openclaw/workspace-work
# 查看当前所有渠道绑定关系
openclaw agents bindings
# 把 telegram:ops 入口绑定到 work agent
openclaw agents bind --agent work --bind telegram:ops
# 解除 telegram:ops 到 work agent 的绑定
openclaw agents unbind --agent work --bind telegram:ops
# 从工作区中的 IDENTITY.md 导入身份信息
openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity
# 给 main agent 设置头像
openclaw agents set-identity --agent main --avatar avatars/openclaw.png
# 删除一个 agent
openclaw agents delete work
logs日志查看# 查看最近的 Gateway 日志
openclaw logs
# 持续跟随日志输出
openclaw logs --follow
# 用 JSON 格式输出日志
openclaw logs --json
# 限制只看最近 500 条日志
openclaw logs --limit 500
# 用本地时区显示日志时间
openclaw logs --local-time
# 持续跟随日志,并使用本地时区显示时间
openclaw logs --follow --local-time
其他 CLI 入口索引补充# 读取、设置和删除配置项
openclaw config
# 生成 shell 自动补全脚本
openclaw completion
# 更新 OpenClaw
openclaw update
# 重置部分配置或状态
openclaw reset
# 卸载 OpenClaw
openclaw uninstall
# 查看或操作系统级信息
openclaw system
# 查看目录相关信息
openclaw directory
# 管理节点、审批、沙箱、浏览器、定时任务、DNS、文档等能力
openclaw nodes
openclaw approvals
openclaw sandbox
openclaw browser
openclaw cron
openclaw dns
openclaw docs
把页面当成操作地图来用时,这三类场景最常见。
最快路径是直接完成初始化后打开控制台,在浏览器里先确认 Gateway 与基础交互是否正常。
# 首次完成安装、配置和守护进程注册
openclaw onboard --install-daemon
# 打开浏览器控制台,直接验证基础交互能力
openclaw dashboard
优先从整体状态与自动诊断入手,再看具体渠道和模型探测结果。
# 对当前系统做深度状态探测
openclaw status --deep
# 跑一遍健康检查,拿到修复建议
openclaw doctor
# 单独查看各渠道当前状态
openclaw channels status
# 对模型配置做真实探测,确认认证和连通性
openclaw models status --probe
命令行直接发消息,是判断渠道接入是否真正可用的最快方式之一。
# 向 Telegram 指定会话发送测试消息,验证渠道是否真正可用
openclaw message send --channel telegram --target @yourchat --message "test"
这些是把文档内容真正用于本机或服务器部署时,最值得提前记住的几件事。
status、doctor、dashboard,因为 OpenClaw 的核心依赖 Gateway,这三者最能快速定位问题是在网关、模型还是渠道层。
models status --probe 不是纯离线检查,可能消耗配额;多渠道环境也建议始终显式写出 --channel,避免误发消息。
以下是整理这份 Markdown 与 HTML 时使用的主要官方资料,适合继续深挖。