docs/ux: startup polish and channel support follow-ups (#4)

* Fix localized startup status text

* Improve startup UX and docs positioning

* Clean up guide section numbering

* Docs: merge remaining channel support notes

---------

Co-authored-by: Tao <dtzp555@gmail.com>
This commit is contained in:
dtzp555-max
2026-03-06 21:10:12 +10:00
committed by GitHub
co-authored by taodeng
parent 1c894d4ee7
commit e0ebe68fb5
7 changed files with 130 additions and 37 deletions
+25 -14
View File
@@ -2,7 +2,7 @@
> 面向:已经在本机安装并跑通 OpenClaw 的用户(至少会用 `openclaw status` / `openclaw gateway logs`
>
> 目标: **OpenClaw Manager (OCM)** 把“创建 Agent / Sub-Agent、绑定 Telegram 群、管理模型/认证、看用量、看 cron”这套流程做成可视化、可回溯、低风险
> 目标: **OpenClaw Manager (OCM)** 当成 **OpenClaw 控制台** 来用:管理 Agent、查看 Routing、做健康检查、运行内置 CLI,并更安全地修改配置
---
@@ -54,9 +54,20 @@ OCM 的定位:**把配置变更“可视化 + 可检查 + 可回滚(配合
---
## 2) 启动与进入 OCM
## 2) 第一次使用时最该确认什么
### 2.1 启动(macOS
对新用户来说,第一步不是“先把所有配置都改完”,而是先确认四件事:
1. OCM 找到的是正确的 OpenClaw 目录
2. Gateway 是健康的
3. Agent / Routing 能正常查看
4. 内置终端可以正常跑命令
所以第一次使用时,最重要的页面其实是 Dashboard、Routing 和内置终端。
## 3) 启动与进入 OCM
### 3.1 启动(macOS
在 OCM 目录:
@@ -68,7 +79,7 @@ bash start.sh
> 需要限制只能本机访问:`bash start.sh --host 127.0.0.1`
### 2.2 Dashboard(先看健康状态)
### 3.2 Dashboard(先看健康状态)
建议第一步先看 Dashboard,确认:
- 机器资源(CPU/RAM/DISK
@@ -81,11 +92,11 @@ bash start.sh
---
## 3) 创建主 AgentMain Agent / 独立 Bot
## 4) 创建主 AgentMain Agent / 独立 Bot
> 你的 `main` 一般是默认存在的;这里重点讲“新增一个 **拥有独立 Telegram bot 的主 Agent**”。
### 3.1 BotFather 侧准备(必须)
### 4.1 BotFather 侧准备(必须)
1) 创建 bot
- 在 Telegram 找 **BotFather**
@@ -101,7 +112,7 @@ bash start.sh
> 如果 Group Privacy 没关,bot 在群里看不到普通消息,会表现成“经常 typing 但没输出 / 没反应”。
### 3.2 在 OCM 添加主 Agent
### 4.2 在 OCM 添加主 Agent
进入 **Agents** 页面:
@@ -117,14 +128,14 @@ bash start.sh
---
## 4) 创建 Sub-Agent(最常用)
## 5) 创建 Sub-Agent(最常用)
### 4.1 为什么 Sub-Agent 要用“新群”
### 5.1 为什么 Sub-Agent 要用“新群”
- 让每个 Sub-Agent 有自己独立的对话上下文、任务边界
- 出问题直接在该群排查,不污染主 Agent 的对话
### 4.2 Sub-Agent 创建流程(逐步)
### 5.2 Sub-Agent 创建流程(逐步)
进入 **Agents** 页面 → 点击 `+ Add Sub-Agent`,按引导做:
@@ -157,7 +168,7 @@ OCM 的表单里可以填 “Your Telegram User ID”,让它自动把你的 us
## 5) Discord 工作流(主 Agent + Sub-Agent
## 6) Discord 工作流(主 Agent + Sub-Agent
OCM 也支持 Discord
@@ -185,7 +196,7 @@ OCM 也支持 Discord
2) 如果是 private thread,需要把 bot 拉进 thread
3) 右键 Thread → **Copy Link** → 粘贴到表单(自动解析 threadId)
## 5) 绑定检查(Channels 页)
## 7) 绑定检查(Channels 页)
进入 **Channels**
@@ -199,7 +210,7 @@ OCM 也支持 Discord
---
## 6) 模型管理(Models 页)
## 8) 模型管理(Models 页)
进入 **模型**
@@ -211,7 +222,7 @@ OCM 也支持 Discord
---
## 7) 认证管理(Auth 页)
## 9) 认证管理(Auth 页)
进入 **认证**