25 Commits
Author SHA1 Message Date
taodeng a0e8d352f9 release: v0.9.0 2026-03-01 21:15:34 +10:00
taodeng d9bae98c2d fix: escape discord guide apostrophe in MAIN_HTML_SCRIPT 2026-03-01 21:10:57 +10:00
taodeng 61b73ad678 fix: center OCM-only version badge + include ocmVersion in status + discord guide i18n 2026-03-01 21:10:32 +10:00
taodeng 4897a66498 ui: center prominent version badge + update Telegram/Discord setup guides 2026-03-01 21:02:28 +10:00
taodeng 894f4841e3 ui: centered version badge + update Telegram/Discord setup guides 2026-03-01 20:52:57 +10:00
taodeng 0a96b4581c fix: main-html-script syntax (tree toggle) 2026-03-01 20:40:16 +10:00
taodeng c3976108a9 feat: Agents wizard for Telegram/Discord + OCM header version 2026-03-01 20:26:11 +10:00
taodeng bfbc4e76da ui: add Agents page hint for Agent vs Sub-Agent 2026-03-01 07:41:01 +10:00
taodeng 0a8779b790 ui: add Remove binding help text 2026-03-01 06:58:21 +10:00
taodeng c006b2f8fb docs: add small-change auto-merge policy 2026-02-28 22:15:05 +10:00
taodeng 80e6532ca2 docs: add CONTRIBUTING guidelines 2026-02-28 22:12:47 +10:00
dtzp555-maxandGitHub f67d9d2991 docs: collapse README screenshots + bump to v0.8.2 (#1)
Merged after adding Backups/Rollback docs + README screenshot gallery (v0.8.2).
2026-02-28 21:59:37 +10:00
taodeng 474f62a4c7 feat: group routing bindings by agent with collapse 2026-02-28 20:55:30 +10:00
taodeng fb5ea6bc84 feat: improve dashboard and routing UX 2026-02-28 20:53:03 +10:00
taodeng 6c789e3471 docs: update channels/actions screenshots 2026-02-28 19:51:37 +10:00
taodeng 85a2178a80 docs: add usage stats screenshot 2026-02-28 19:41:13 +10:00
taodeng 532a605e58 chore: remove extra terminal screenshots 2026-02-28 19:39:58 +10:00
taodeng 149620dc1a chore: remove extra terminal screenshots 2026-02-28 19:39:45 +10:00
taodeng ba3ef27766 docs: update screenshots (EN, redacted) + improve CLI/Actions docs 2026-02-28 19:39:35 +10:00
taodeng 373d8bda27 docs: re-redact agents screenshot (hide user path + peer IDs) 2026-02-28 18:56:40 +10:00
taodeng d7274f6c88 chore: remove nav arrow example 2026-02-28 17:16:24 +10:00
taodeng f9375ebf89 chore: remove nav arrow example 2026-02-28 17:16:14 +10:00
taodeng 79fa8b35ca docs: refresh redacted screenshots 2026-02-28 17:16:08 +10:00
taodeng 3bd82c5892 docs: further redact screenshots (hide local username) 2026-02-28 17:15:59 +10:00
taodeng 18b1b9529b ui: default language to English 2026-02-28 17:04:25 +10:00
19 changed files with 790 additions and 198 deletions
+59 -2
View File
@@ -1,7 +1,64 @@
# OpenClaw Manager — 开发日志
> 最后更新:2026-02-27
> 当前版本:v0.7.1
> 最后更新:2026-03-01
> 当前版本:v0.9.0
---
## v0.9.0 更新日志(2026-03-01
### New Features
- Agents: Add Agent / Add Sub-Agent 向导支持 Telegram + Discord
- Telegram: 传统 group 绑定
- Discord: 主 Agent 建议绑定 ChannelSub-Agent 建议绑定 Thread
- Routing: 删除绑定提示文案增强(支持“更换 group/thread → 先删旧绑定再加新绑定”)
### UX / UI
- 顶部居中显示醒目的 OCM 版本标识
- Agents 页面:Agent Tree 支持显示 bindings 概览(Telegram/Discord)并按 parentAgentId 分组
- Setup Guide:补全 Telegram Allow Groups 步骤;Discord guide 按 channel/thread 经验重写
### Fixes
- 修复 MAIN_HTML_SCRIPT 内联 JS 语法问题(tree toggle / i18n 单引号等),避免启动自检失败
## Unreleased2026-02-28
### Dashboard / Layout
- Removed the dashboard `HTTP Ping` field (often misleading in Telegram gateway setups)
- Expanded dashboard visibility with richer gateway routing metadata:
- bind host
- telegram account count
- group count
- binding count
- allowFrom count
- Reordered dashboard cards and made `Agents` / `Gateway` cards wider for denser information display
### Bug Fixes
- Fixed `main` agent workspace file browsing/editing fallback:
- when agent-level workspace is empty, it now resolves from defaults or `workspace/<agentId>`
- writing files now ensures workspace directory exists before save
### UX Clarification
- Channels page hint text updated to position it as **advanced routing management**
- Clarifies scope difference from Agents page (daily add/remove should stay in Agents)
- Navigation label updated from `Channels` to `Routing` to reduce conceptual overlap with Agent lifecycle management
- Added `Routing` page agent filter (`All Agents` + per-agent quick filter) for easier large-tree inspection
- Added compact grouped rendering in `Routing`: bindings are grouped by agent with expand/collapse support for denser large-config browsing
### Settings UX
- Merged `Models` and `Auth` pages into a single `Models & Auth` tab
### Stats
- Added daily (`1 day`) range option and set it as default
---
+35 -36
View File
@@ -33,47 +33,40 @@ Open [http://localhost:3333](http://localhost:3333) in your browser. For remote
## Features
**Screenshots** — Redacted UI walkthrough (no personal paths, no Telegram IDs):
<details>
<summary><b>Screenshots</b> (redacted: no personal paths, no Telegram IDs)</summary>
![](docs/redacted-screenshots/dashboard.jpg)
<p>
<img src="docs/redacted-screenshots/dashboard.jpg" width="240" />
<img src="docs/redacted-screenshots/agents.jpg" width="240" />
<img src="docs/redacted-screenshots/channels.jpg" width="240" />
<img src="docs/redacted-screenshots/models.jpg" width="240" />
<img src="docs/redacted-screenshots/auth.jpg" width="240" />
<img src="docs/redacted-screenshots/stats.jpg" width="240" />
<img src="docs/redacted-screenshots/cron.jpg" width="240" />
<img src="docs/redacted-screenshots/actions.jpg" width="240" />
<img src="docs/redacted-screenshots/cli.jpg" width="240" />
<img src="docs/redacted-screenshots/cli-output.jpg" width="240" />
<img src="docs/redacted-screenshots/backup-rollback.jpg" width="240" />
</p>
![](docs/redacted-screenshots/agents.jpg)
</details>
![](docs/redacted-screenshots/channels.jpg)
![](docs/redacted-screenshots/models.jpg)
![](docs/redacted-screenshots/auth.jpg)
![](docs/redacted-screenshots/stats.jpg)
![](docs/redacted-screenshots/cron.jpg)
**Agent Management** — Add main agents and sub-agents through a guided setup flow. View all agents in a tree structure with model selection, workspace browsing, and inline configuration.
**Usage Statistics** — Real token usage data parsed directly from OpenClaw session files. Breakdown by model, agent, and day with a visual chart.
**Model & Auth** — Configure models from your registered provider list. Follow built-in guides for provider authentication setup.
**Built-in CLI** — Run any OpenClaw CLI command with real-time streaming output. Includes tab completion and saved favorites.
![](docs/redacted-screenshots/cli.jpg)
**Ops Panel** — Restart gateway, view logs, run health checks, manage backups (local + NAS via SFTP/rsync), and handle cron tasks.
**Bilingual UI** — English and Chinese interface with one-click language switching.
## What's New (v0.7.x)
- **Dashboard redesign**: circular CPU/RAM/DISK gauges + system/gateway/agent overview, with optional auto-refresh.
- **Sub-agent creation flow**: step-by-step Telegram guide (BotFather → group → get group ID → fill form), with explicit safety warnings.
- **Telegram allowlist helper**: optional “Your Telegram User ID” field can auto-append to `channels.telegram.allowFrom`.
- **Model dropdown = real CLI output**: selectors are sourced from `openclaw models list` (with a warning if parsing fails).
- **Cache-busting**: response headers + version checks help prevent stale frontend after updates.
- **Setup page EN localization**: first-run directory selection page is fully bilingual.
- **Agent Management** — Add main agents and sub-agents through a guided setup flow. View all agents in a tree structure with model selection, workspace browsing, and inline configuration.
- **Usage Statistics** — Real token usage data parsed directly from OpenClaw session files. Breakdown by model, agent, and day with a visual chart.
- **Model & Auth** — Configure models from your registered provider list. Follow built-in guides for provider authentication setup.
- **Built-in CLI** — Available from any page (top-right **Terminal** + bottom dock). Run OpenClaw commands with **real-time streaming output**, **Tab completion**, built-in presets, and your own saved favorites.
- **Ops Panel** — Restart gateway, view logs, run health checks, manage backups, **rollback/restore configs**, and handle cron tasks.
- **Backups / Rollback** — Browse auto-snapshots of `openclaw.json*` and restore any previous version (current config is auto-backed up first).
- **Bilingual UI** — English and Chinese interface with one-click language switching.
## What's New (v0.9.x)
- **Discord support (v0.9.x)**: add agent/sub-agent flows for Discord (main agent binds channel; sub-agent binds thread).
- **README screenshots gallery**: all screenshots are now grouped into one collapsible section to keep the homepage short.
- **Built-in CLI terminal**: run OpenClaw commands from any page with streaming output, presets, favorites, and Tab completion.
- **Ops actions**: restart gateway, view logs, health check, backups (local + NAS), and cron management.
- **Telegram-first workflow**: safer sub-agent setup flow + allowlist helper + warnings for group privacy.
## Telegram Workflow & Safety
OCM is designed primarily for **Telegram-based OpenClaw workflows**:
@@ -213,3 +206,9 @@ bash start.sh --dir /path/to/.openclaw --port 8080
```json
{ "dir": "~/.openclaw" }
```
## Discord (thread-first) notes
- Recommended: keep top-level agents in dedicated channels, and bind sub-agents to **threads** (one thread per task).
- To switch a Telegram group / Discord thread binding: go to **Routing** → remove the old binding → add a new binding with the new ID/link.
+15
View File
@@ -2,6 +2,21 @@
This is a user-facing summary derived from `DEVLOG.md`.
## v0.9.0
- Agents: Telegram + Discord support in Add Agent / Add Sub-Agent wizard (main agent binds channel; sub-agent binds thread).
- UI: top-center OCM version badge; improved Telegram/Discord setup guides.
## v0.8.2
- Docs: reorganize README screenshots into a collapsible gallery to reduce scroll.
- Docs: add Backups / Rollback screenshot and README feature blurb.
- Docs: refresh redacted screenshots (Channels + Actions + Stats) and feature descriptions.
## v0.8.1
- Docs: add Stats screenshot and expand feature list.
## v0.8.0
- Docs: bilingual usage guides refreshed (EN + zh-CN) with redacted screenshots.
## v0.7.6
- Docs: annotated screenshots with arrows for key UI controls.
+65
View File
@@ -0,0 +1,65 @@
# Contributing (OCM)
This repo is optimized for fast iteration and safe maintenance.
## Workflow (PM + Codex)
Default rule:
- Codex implements changes on a **new branch** and opens a **PR**.
- Xiao Qiang (PM) reviews + runs local smoke tests.
- Tao approves.
- Only after explicit approval, we merge.
Fast-path (small changes):
- For small doc/copy/layout fixes, Tao allows **auto-merge after PM verification** (tests/smoke pass).
- PM must still send Tao a short completion note with the PR link and summary.
## Versioning
- Single source of truth:
- `package.json#version`
- `openclaw-manager.js``APP_VERSION`
- When bumping a version, update **both** in the same commit.
- Prefer **semver-ish**: `MAJOR.MINOR.PATCH` (e.g. `0.8.2`).
## Language policy (Docs + UI)
- **DEVLOG.md must be English-only.**
- UI:
- English mode should not show Chinese strings (except user-provided content).
- Chinese mode can be fully Chinese.
- When adding new UI strings, ensure both locales are updated.
## README policy
- Keep the README homepage **short**.
- Screenshots should be grouped (e.g. in a collapsible gallery) to avoid long scroll.
- The “Features” section should be **complete** and reflect actual UI capabilities.
## Screenshots (redaction)
- Store public screenshots under: `docs/redacted-screenshots/`
- Redact sensitive info:
- local username/path fragments
- Telegram peer IDs
- any tokens/keys
- Prefer **English UI** screenshots.
- Prefer clean crops (avoid arrows/annotations unless truly necessary).
## Text style
- Be concrete and user-focused.
- Prefer consistent naming:
- “Remote backup setup” (not “NAS backup setup”)
- “Backups / Rollback” for restore/snapshot functionality
## PR checklist
- [ ] Description includes: what/why/how
- [ ] If UI changed: include screenshots
- [ ] Version updated when needed
- [ ] English UI audited (no stray Chinese)
- [ ] `DEVLOG.md` updated (English-only)
+16
View File
@@ -223,6 +223,20 @@ OCM parses usage from OpenClaw session JSONL files.
---
## 10) Actions menu (ops shortcuts)
The **⚡ Actions** dropdown in the top-right provides common operational shortcuts:
- Restart Gateway
- Live Logs
- Manual Backup / Backups & Rollback
- NAS Backup Setup
- Health Check
- Open Config Dir / Switch OpenClaw Dir
Screenshot:
![](redacted-screenshots/actions.jpg)
## 10) Cron jobs (Cron)
Go to **Cron**:
@@ -252,6 +266,8 @@ Screenshot:
![](redacted-screenshots/cli.jpg)
![](redacted-screenshots/cli-output.jpg)
## 11) Fast troubleshooting
### “Typing…” but no reply in a Telegram group
+16
View File
@@ -224,6 +224,22 @@ OCM 内置一个 CLI 面板,用来直接运行 OpenClaw 命令(例如:`ope
![](redacted-screenshots/cli.jpg)
![](redacted-screenshots/cli-output.jpg)
## 9) Actions 菜单(运维快捷入口)
右上角 **⚡ Actions** 下拉菜单提供常用运维操作:
- Restart Gateway(重启网关)
- Live Logs(实时日志)
- Manual Backup / Backups & Rollback(备份/回滚)
- NAS Backup SetupNAS 备份配置)
- Health Check(健康检查)
- Open Config Dir / Switch OpenClaw Dir(打开/切换配置目录)
截图示例:
![](redacted-screenshots/actions.jpg)
## 9) Cron(定时任务)
进入 **Cron**
Binary file not shown.

After

Width:  |  Height:  |  Size: 29 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 112 KiB

After

Width:  |  Height:  |  Size: 24 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 162 KiB

After

Width:  |  Height:  |  Size: 162 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 71 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 122 KiB

After

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 238 KiB

After

Width:  |  Height:  |  Size: 16 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 172 KiB

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 226 KiB

After

Width:  |  Height:  |  Size: 226 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 129 KiB

After

Width:  |  Height:  |  Size: 129 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 207 KiB

After

Width:  |  Height:  |  Size: 29 KiB

+552 -128
View File
File diff suppressed because it is too large Load Diff
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "openclaw-manager",
"version": "0.7.1",
"version": "0.8.2",
"description": "A local web UI for managing OpenClaw AI agents — no npm install required",
"main": "openclaw-manager.js",
"scripts": {