自托管 AI 助手网关 / HTML 可视化版

把聊天渠道、AI Agent 与控制台连接到同一个 Gateway

OpenClaw 的定位可以理解为一个自托管中枢:它把 WhatsApp、Telegram、Discord、Slack、Signal、iMessage 等聊天渠道统一接入,再通过 Gateway 对接 AI Agent、CLI、Web 控制台和自动化流程。

它适合解决什么问题

如果你不想为每个聊天渠道、每个 Agent、每套运维流程分别维护一套系统,OpenClaw 的价值就会比较明显。

统一接入层

把多个消息渠道接到一个 Gateway,减少渠道级的重复配置与切换成本。

WhatsApp Telegram Discord Slack

统一控制面

CLI、Web UI、桌面端与自动化脚本通过同一套 Gateway 状态与协议协作,排障路径也更集中。

CLI Dashboard WebSocket

统一运维与安全

借助 status、doctor、pairing、memory、models 等能力,把可用性与安全控制拉到同一个面板里。

Health Pairing Models

核心架构

官方文档里最关键的理解是:所有能力围绕 Gateway 展开,CLI、控制台、设备节点都围绕它连接和协作。

01

Gateway

长期运行的核心进程,负责维护消息渠道连接、暴露 WebSocket API、同步状态与事件分发。

02

Client

CLI、Web 控制台、桌面端和自动化工具都作为控制面客户端接入,统一请求状态、消息和 Agent 调用。

03

Node / Device

macOS、iOS、Android 或 headless 设备可作为 node 接入,但需要独立的设备配对与权限控制。

04

Channels + Agent

真正对外提供服务时,消息渠道、模型、记忆、插件和 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

关键说明

  • 环境要求是 Node.js 22 或以上。
  • 如果只想先生成基础配置,也可以从 openclaw setup 开始。
  • 默认可在网关主机访问 http://127.0.0.1:18789/。
  • 如果已安装 daemon,可以先执行 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运行与排障

查看整体状态、执行深度诊断,并通过 Web 控制台快速验证当前系统是否可用。
# 查看 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模型管理

查看模型状态、列出候选模型、设置默认模型,并管理认证 profile 与 fallback。
# 查看当前默认模型、回退模型和认证状态
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渠道管理

查看渠道状态、能力和日志,添加账号,或做名称到 ID 的解析。
# 列出当前已经配置的所有渠道
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消息动作

统一负责发送消息,以及 poll、reaction、read、edit、delete、pin、broadcast 等动作。
# 给默认渠道中的目标号码发送一条文本消息
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记忆与安全

语义索引、搜索、DM 配对与设备配对是 OpenClaw 的另一条重要能力线。
# 查看语义记忆插件和索引状态
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>

新手建议先记住的 8 条命令

如果只保留最有用的最小集合,这一组基本能覆盖安装、验证、排障和一次简单测试。

# 首次引导并安装后台守护进程
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,或单独查看 Gateway 健康状况时使用。
# 打开默认的 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网关核心管理

OpenClaw 的底层核心命令组,用于启动、探测、服务安装和生命周期管理。
# 以前台方式直接启动 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 工作区、身份配置,以及渠道到 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 日志,用于快速定位运行问题。
# 查看最近的 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 入口索引补充

这些命令也出现在官方 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

常见使用场景

把页面当成操作地图来用时,这三类场景最常见。

Scene 01

先体验,不先接聊天渠道

最快路径是直接完成初始化后打开控制台,在浏览器里先确认 Gateway 与基础交互是否正常。

# 首次完成安装、配置和守护进程注册
openclaw onboard --install-daemon

# 打开浏览器控制台,直接验证基础交互能力
openclaw dashboard
Scene 02

模型已接好,检查系统整体健康

优先从整体状态与自动诊断入手,再看具体渠道和模型探测结果。

# 对当前系统做深度状态探测
openclaw status --deep

# 跑一遍健康检查,拿到修复建议
openclaw doctor

# 单独查看各渠道当前状态
openclaw channels status

# 对模型配置做真实探测,确认认证和连通性
openclaw models status --probe
Scene 03

发一条测试消息验证渠道

命令行直接发消息,是判断渠道接入是否真正可用的最快方式之一。

# 向 Telegram 指定会话发送测试消息,验证渠道是否真正可用
openclaw message send --channel telegram --target @yourchat --message "test"

本地落地注意点

这些是把文档内容真正用于本机或服务器部署时,最值得提前记住的几件事。

推荐优先级: 排障时先看 status、doctor、dashboard,因为 OpenClaw 的核心依赖 Gateway,这三者最能快速定位问题是在网关、模型还是渠道层。
风险提示: models status --probe 不是纯离线检查,可能消耗配额;多渠道环境也建议始终显式写出 --channel,避免误发消息。
本页基于本目录中的 README 内容整理,并按 HTML 可视化方式重组展示。适合本地直接打开浏览,也适合作为项目内部介绍页基础版本。