Author SHA1 Message Date
taodeng 98270eed8d docs: add Discord/Feishu channel support notes 2026-03-01 10:51:14 +10:00
8 changed files with 163 additions and 440 deletions
+2 -22
View File
@@ -1,30 +1,10 @@
# OpenClaw Manager — 开发日志
> 最后更新:2026-03-01
> 当前版本:v0.9.0
> 最后更新:2026-02-28
> 当前版本:v0.7.1
---
## 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
+13 -8
View File
@@ -60,13 +60,24 @@ Open [http://localhost:3333](http://localhost:3333) in your browser. For remote
- **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)
## What's New (v0.8.x)
- **Discord support (v0.9.x)**: add agent/sub-agent flows for Discord (main agent binds channel; sub-agent binds thread).
- **Docs refresh (v0.8.x)**: updated English + Chinese guides and refreshed redacted screenshots.
- **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.
## Channel Support
OCM is a local UI for OpenClaw. The core features (agent trees, routing, models/auth, ops, backups) are channel-agnostic.
Current focus:
- **Telegram** — best supported and most documented today
- **Discord** — supported (recommended for private channels/threads + strict allowlist)
- **Feishu / Lark (飞书)** — supported (Beta; enterprise-oriented setup)
- **WhatsApp** — **not supported for sub-agent workflows** (platform constraints make reliable multi-agent isolation + routing hard)
## Telegram Workflow & Safety
OCM is designed primarily for **Telegram-based OpenClaw workflows**:
@@ -206,9 +217,3 @@ 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.
-4
View File
@@ -2,10 +2,6 @@
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.
+10
View File
@@ -51,3 +51,13 @@ That said, your local OpenClaw config contains sensitive information. Follow the
- don't share raw screenshots without redaction
See: `docs/SECURITY.md`.
## Q: 为什么 OCM 暂时不支持 WhatsApp 的 sub-agent 工作流?
WhatsApp 在 bot/group 自动化能力上有较多平台限制(接入方式、权限与路由粒度、稳定性等)。
OCM 的 sub-agent 模式依赖清晰的“会话边界 + 路由 + 最小权限”来保证安全和可维护性。
因此我们目前不把 WhatsApp 作为 sub-agent 的推荐渠道,暂不支持该模式。
如果未来支持 WhatsApp,更可能是 **单聊通知/轻量交互** 方向,而不是多 sub-agent 的群聊拓扑。
+21
View File
@@ -20,6 +20,27 @@ Critical BotFather settings:
- Allow Groups = ON
- Group Privacy = OFF
## Discord safety
Recommended defaults (especially for open-source / shared servers):
- Prefer **private channels / private threads** as agent boundaries.
- Use a strict **allowlist** of channels/threads the bot is allowed to respond in.
- Apply **least-privilege** Discord permissions when installing the bot (only what you need).
- Avoid running memory-enabled agents in public channels.
## Feishu / Lark (飞书) safety
Feishu is enterprise-oriented and typically requires more permission setup:
- Request the smallest permission scope possible for your app/bot.
- Treat group visibility as a security boundary (who can see the bots outputs).
- Prefer separate chats/spaces for different agents to reduce context bleed.
## WhatsApp note
WhatsApp is not a recommended target for sub-agent topology workflows. Constraints in bot/group automation make reliable multi-agent isolation + routing difficult.
## Sharing screenshots
If you share screenshots publicly:
+9 -1
View File
@@ -27,12 +27,20 @@ OCMs role: **a zero-dependency local UI** that helps you view and update Open
---
## 1) Why Telegram groups are the best way to build sub-agents
## 1) Recommended: Telegram group workflow (best supported)
Think of it as:
> **One Telegram group = one agent boundary** (context + purpose + workspace).
### Notes for other channels
OCM is expanding beyond Telegram:
- **Discord**: recommended to use **private channels/threads** as boundaries + strict allowlist routing.
- **Feishu / Lark (飞书)**: supported (Beta); enterprise-oriented setup with stronger permission/visibility considerations.
- **WhatsApp**: not recommended for sub-agent topology workflows (not supported).
### Benefits
1) **Clear isolation**
+9 -1
View File
@@ -27,10 +27,18 @@ OCM 的定位:**把配置变更“可视化 + 可检查 + 可回滚(配合
---
## 1) 为什么用 Telegram group 来建 Sub-Agent 最合适
## 1) 推荐:Telegram 群组工作流(目前支持最好)
> 这里讨论的是 OpenClaw 的一种非常实用的工作方式:**“一个 Telegram 群 = 一个 Agent 的工作空间/人格/上下文边界”**。
### 其他渠道说明
OCM 正在扩展 Telegram 之外的渠道支持:
- **Discord**:建议用**私密频道/私密 thread**作为边界,并启用严格 allowlist 路由。
- **飞书 / Lark**:支持(Beta);企业协作场景更强,但权限/可见性边界需要更谨慎。
- **WhatsApp**:不适合做 sub-agent 群聊拓扑(暂不支持)。
### 1.1 Telegram group 方案的优势
1. **边界天然清晰**
+70 -375
View File
@@ -24,7 +24,7 @@ const SCRIPT_DIR = __dirname;
const MANAGER_CONFIG = path.join(SCRIPT_DIR, 'manager-config.json');
let PORT = 3333;
let HOST = '0.0.0.0';
const APP_VERSION = '0.9.0';
const APP_VERSION = '0.8.2';
// --port 参数
const portIdx = process.argv.indexOf('--port');
if (portIdx !== -1 && process.argv[portIdx + 1]) PORT = parseInt(process.argv[portIdx + 1]) || 3333;
@@ -423,13 +423,7 @@ async function handleApi(req, res, urlObj, body) {
// Workspace: explicit per-agent, or defaults.workspace for main
const workspace = a.workspace || (isMain ? defaultWorkspace : null);
return { ...a, workspace, groupId, requireMention: groupId ? (groups[groupId]?.requireMention ?? true) : null,
effectiveModel: modelVal || defaults.model?.primary || '默认', hasOwnBot, accountId, parentAccountId, parentAgentId: a.parentAgentId || null, bindings: (bindings||[]).filter(b=>b.agentId===a.id).map(b=>({
idx: bindings.indexOf(b),
channel: b.match?.channel || '',
accountId: b.match?.accountId || '',
peerKind: b.match?.peer?.kind || '',
peerId: b.match?.peer?.id || ''
})) };
effectiveModel: modelVal || defaults.model?.primary || '默认', hasOwnBot, accountId, parentAccountId };
});
res.writeHead(200);
res.end(JSON.stringify({ agents: enriched, defaults }));
@@ -514,143 +508,6 @@ async function handleApi(req, res, urlObj, body) {
return;
}
// POST /api/agents/discord — create top-level Discord agent (single bot, channel binding)
if (method === 'POST' && pathname === '/api/agents/discord') {
const { agentId, name, workspaceFolder, model, purpose, personality, guildId, channelId } = body;
if (!agentId || !/^[a-zA-Z0-9_-]+$/.test(agentId)) {
res.writeHead(400); res.end(JSON.stringify({ error: 'Agent ID must contain only alphanumeric characters, underscores, or dashes' })); return;
}
if (!name || !name.trim()) { res.writeHead(400); res.end(JSON.stringify({ error: 'Name is required' })); return; }
const folder = (workspaceFolder || agentId).trim();
if (!folder) { res.writeHead(400); res.end(JSON.stringify({ error: 'Workspace folder is required' })); return; }
if (!channelId || !String(channelId).trim().match(/^\d+$/)) { res.writeHead(400); res.end(JSON.stringify({ error: 'Discord channelId is required' })); return; }
const gid = (guildId || '').trim();
const cfg = await readConfig();
if (cfg.agents?.list?.some(a => a.id === agentId)) {
res.writeHead(400); res.end(JSON.stringify({ error: `Agent ID \"${agentId}\" already exists` })); return;
}
// Prevent workspace reuse
const wsAlias = `~/.openclaw/workspaces/${folder}`;
if (cfg.agents?.list?.some(a => (a.workspace||'').endsWith(`/workspaces/${folder}`) || a.workspace === wsAlias)) {
res.writeHead(400); res.end(JSON.stringify({ error: `Workspace folder \"${folder}\" is already used by another agent` })); return;
}
if (!cfg.agents) cfg.agents = { defaults: {}, list: [] };
if (!cfg.agents.list) cfg.agents.list = [];
const wsPath = path.join(OPENCLAW_DIR, 'workspaces', folder);
const agentEntry = { id: agentId, name: name || agentId, workspace: wsAlias };
if (model && model !== '__default__') agentEntry.model = { primary: model };
cfg.agents.list.push(agentEntry);
if (!cfg.bindings) cfg.bindings = [];
cfg.bindings.unshift({ agentId, match: { channel: 'discord', peer: { kind: 'channel', id: String(channelId).trim() } } });
if (!cfg.channels) cfg.channels = {};
if (!cfg.channels.discord) cfg.channels.discord = {};
cfg.channels.discord.enabled = true;
if (gid) {
if (!cfg.channels.discord.guilds) cfg.channels.discord.guilds = {};
if (!cfg.channels.discord.guilds[gid]) cfg.channels.discord.guilds[gid] = {};
if (!cfg.channels.discord.guilds[gid].channels) cfg.channels.discord.guilds[gid].channels = {};
cfg.channels.discord.guilds[gid].channels[String(channelId).trim()] = { allow: true, requireMention: false };
if (cfg.channels.discord.guilds[gid].requireMention === undefined) cfg.channels.discord.guilds[gid].requireMention = false;
}
const bakPath = await writeConfig(cfg, 'create');
await fsp.mkdir(wsPath, { recursive: true });
await fsp.mkdir(path.join(wsPath, 'memory'), { recursive: true });
await fsp.writeFile(path.join(wsPath, 'SOUL.md'), generateSoulMd(name || agentId, purpose || '', personality || ''), 'utf8');
await fsp.writeFile(path.join(wsPath, 'MEMORY.md'), generateMemoryMd(name || agentId, ''), 'utf8');
const agentRuntimeDir = path.join(OPENCLAW_DIR, 'agents', agentId);
await fsp.mkdir(agentRuntimeDir, { recursive: true });
await fsp.mkdir(path.join(agentRuntimeDir, 'sessions'), { recursive: true });
res.writeHead(200);
res.end(JSON.stringify({ ok: true, agentId, workspacePath: wsPath, configBackup: bakPath,
notes: [
'Discord agent created (single Discord bot)',
'Channel binding added',
'Workspace + runtime directories created',
'Configuration updated and backed up',
'Restart gateway to apply: openclaw gateway restart'
]
}));
return;
}
// POST /api/agents/discord-sub — create Discord sub-agent (thread-only binding, grouping under parentAgentId)
if (method === 'POST' && pathname === '/api/agents/discord-sub') {
const { agentId, displayName, workspaceFolder, model, purpose, personality, initialMemory, parentAgentId, guildId, threadId } = body;
if (!agentId || !/^[a-zA-Z0-9_-]+$/.test(agentId)) {
res.writeHead(400); res.end(JSON.stringify({ error: 'Agent ID must contain only alphanumeric characters, underscores, or dashes' })); return;
}
if (!parentAgentId || !String(parentAgentId).trim()) {
res.writeHead(400); res.end(JSON.stringify({ error: 'Parent Agent ID is required' })); return;
}
if (!threadId || !String(threadId).trim().match(/^\d+$/)) {
res.writeHead(400); res.end(JSON.stringify({ error: 'Discord threadId is required' })); return;
}
const gid = (guildId || '').trim();
const cfg = await readConfig();
const parentAgent = cfg.agents?.list?.find(a => a.id === parentAgentId);
if (!parentAgent) { res.writeHead(404); res.end(JSON.stringify({ error: `Parent agent \"${parentAgentId}\" does not exist` })); return; }
if (cfg.agents?.list?.some(a => a.id === agentId)) { res.writeHead(400); res.end(JSON.stringify({ error: `Agent ID \"${agentId}\" already exists` })); return; }
const folder = (workspaceFolder || agentId).trim();
const wsAlias = `~/.openclaw/workspaces/${folder}`;
if (cfg.agents?.list?.some(a => (a.workspace||'').endsWith(`/workspaces/${folder}`) || a.workspace === wsAlias)) {
res.writeHead(400); res.end(JSON.stringify({ error: `Workspace folder \"${folder}\" is already used by another agent` })); return;
}
const wsPath = path.join(OPENCLAW_DIR, 'workspaces', folder);
const agentEntry = { id: agentId, name: displayName || agentId, workspace: wsAlias, parentAgentId: String(parentAgentId).trim() };
if (model && model !== '__default__') agentEntry.model = { primary: model };
cfg.agents.list.push(agentEntry);
if (!cfg.bindings) cfg.bindings = [];
cfg.bindings.unshift({ agentId, match: { channel: 'discord', peer: { kind: 'channel', id: String(threadId).trim() } } });
if (!cfg.channels) cfg.channels = {};
if (!cfg.channels.discord) cfg.channels.discord = {};
cfg.channels.discord.enabled = true;
if (gid) {
if (!cfg.channels.discord.guilds) cfg.channels.discord.guilds = {};
if (!cfg.channels.discord.guilds[gid]) cfg.channels.discord.guilds[gid] = {};
if (!cfg.channels.discord.guilds[gid].channels) cfg.channels.discord.guilds[gid].channels = {};
cfg.channels.discord.guilds[gid].channels[String(threadId).trim()] = { allow: true, requireMention: false };
if (cfg.channels.discord.guilds[gid].requireMention === undefined) cfg.channels.discord.guilds[gid].requireMention = false;
}
const bakPath = await writeConfig(cfg, 'create');
await fsp.mkdir(wsPath, { recursive: true });
await fsp.mkdir(path.join(wsPath, 'memory'), { recursive: true });
const name = displayName || agentId;
await fsp.writeFile(path.join(wsPath, 'SOUL.md'), generateSoulMd(name, purpose || '', personality || ''), 'utf8');
await fsp.writeFile(path.join(wsPath, 'MEMORY.md'), generateMemoryMd(name, initialMemory || ''), 'utf8');
const agentRuntimeDir = path.join(OPENCLAW_DIR, 'agents', agentId);
await fsp.mkdir(agentRuntimeDir, { recursive: true });
await fsp.mkdir(path.join(agentRuntimeDir, 'sessions'), { recursive: true });
res.writeHead(200);
res.end(JSON.stringify({ ok: true, agentId, workspacePath: wsPath, configBackup: bakPath,
notes: [
'Discord sub-agent created (thread-only binding)',
'Workspace + runtime directories created',
'Configuration updated and backed up',
'Restart gateway to apply: openclaw gateway restart'
]
}));
return;
}
// POST /api/agents — create sub-agent (shares parent bot)
if (method === 'POST' && pathname === '/api/agents') {
const { agentId, displayName, groupId, workspaceFolder, model, purpose, personality, initialMemory, parentAgentId, telegramUserId } = body;
@@ -680,7 +537,7 @@ async function handleApi(req, res, urlObj, body) {
const folder = workspaceFolder || agentId;
const wsPath = path.join(OPENCLAW_DIR, 'workspaces', folder);
const wsAlias= `~/.openclaw/workspaces/${folder}`;
const agentEntry = { id: agentId, name: displayName || agentId, workspace: wsAlias, parentAgentId: String(parentAgentId).trim() };
const agentEntry = { id: agentId, name: displayName || agentId, workspace: wsAlias };
if (model && model !== '__default__') agentEntry.model = { primary: model };
cfg.agents.list.push(agentEntry);
// Binding uses parent's accountId
@@ -1699,10 +1556,6 @@ header { background:var(--surface); border-bottom:1px solid var(--border); paddi
.lang-toggle { background:var(--border); border:none; color:var(--muted); border-radius:6px; padding:5px 10px; font-size:12px; cursor:pointer; }
.lang-toggle:hover { background:#3a3f5c; color:var(--text); }
/* centered version badge */
.top-version{ position:absolute; left:50%; transform:translateX(-50%); font-size:12px; font-weight:800; letter-spacing:.3px; color:var(--text); background:rgba(108,99,255,.18); border:1px solid rgba(108,99,255,.45); padding:4px 12px; border-radius:999px; box-shadow:0 6px 18px rgba(0,0,0,.25); }
.ver-old{ display:none; }
/* dropdown menu */
.menu-wrap { position:relative; }
.menu-btn { background:var(--border); border:none; color:var(--text); border-radius:6px; padding:6px 12px; font-size:13px; cursor:pointer; display:flex; align-items:center; gap:6px; }
@@ -1967,9 +1820,7 @@ const MAIN_HTML_BODY = String.raw`
<!-- Header / Toolbar -->
<header>
<span class="logo" title="OpenClaw Manager">🦀 OpenClaw</span>
<div class="top-version" id="topVersion">v--</div>
<span class="ver" id="versionBadge">v--</span>
<span class="ver ver-old" id="ocmVersionBadge">ocm v--</span>
<div class="spacer"></div>
<div id="healthBadge" title="">
<span id="healthIcon">⚠️</span>
@@ -2430,7 +2281,6 @@ const I18N = {
'tab.stats':'📊 Stats','tab.cron':'⏰ Cron',
'agents.title':'Agents','agents.new':' 新建 Subagent',
'channels.title':'路由绑定','channels.add':' 添加绑定','channels.hint':'用于高级路由管理:维护 Agent 与频道/群组绑定及优先级顺序。日常增减 Agent 请在 Agents 页面操作。',
'channels.removeHint':'如果需要更换 Telegram 群或 Discord thread:请先在本页删除旧绑定,然后用新的 ID 重新绑定。也可用于修正绑定错误、群重建(ID 变化)、重复/冲突或临时断开路由。',
'channels.filterLabel':'Agent','channels.filterAll':'全部 Agent','channels.emptyFiltered':'当前 Agent 下暂无绑定',
'channels.countSuffix':'条绑定','channels.collapse':'折叠','channels.expand':'展开',
'models.title':'模型管理','models.primary':'默认主模型','models.fallback':'Fallback 链',
@@ -2480,21 +2330,13 @@ const I18N = {
'guide.title':'📖 Setup Guide','guide.agent.s1':'Open Telegram, search for <code>@BotFather</code>',
'guide.agent.s2':'Send <code>/newbot</code> and follow prompts to name your Bot',
'guide.agent.s3':'Copy the <code>Bot Token</code> from BotFather and paste below',
'guide.agent.s4':'In BotFather: <code>/mybots</code> → select your bot → <b>Bot Settings</b> → <b>Allow Groups</b> → <b>Turn on</b> (allow the bot to join groups)',
'guide.agent.s5':'Send <code>/setprivacy</code> → select your Bot → click <code>Disable</code> (allow Bot to read group messages)',
'guide.agent.s4':'Send <code>/setprivacy</code> → select your Bot → click <code>Disable</code> (allow Bot to read group messages)',
'guide.sub.s1':'在 BotFather 发送 <code>/newbot</code> 创建新 Bot,获取 Bot Token',
'guide.sub.s2':'在 BotFather 发送 <code>/mybots</code> → 选择 Bot → <b>Bot Settings</b> → <b>Group Privacy</b> → <b>Turn off</b>',
'guide.sub.s3':'在 Telegram 创建新群组,将 Bot 加入群组(<b>不要加其他人</b>',
'guide.sub.s4':'在群内发一条消息,从 gateway 日志中找到 <code>peer.id</code>(负数)',
'guide.sub.s5':'填写下方表单创建 Sub-Agent',
'guide.sub.warn':'⚠️ 安全提示:请勿将其他人加入此群组,只有你和 Bot 应在群内。否则其他人也能与 Bot 对话并产生 API 费用。',
'guide.agent.discord.s1':'Discord 主 Agent:创建/选择一个专用 <b>Channel</b>(建议私密频道)。',
'guide.agent.discord.s2':'右键该 Channel → <b>Copy Link</b>,粘贴到表单里(OCM 自动解析 <code>channelId</code>,可选 <code>guildId</code>)。',
'guide.agent.discord.s3':'建议:一个 Channel 只绑定一个主 Agent,避免上下文串台。',
'guide.sub.discord.s1':'Discord Sub-Agent:在对应主 Channel 下新建一个 <b>Thread</b>(强烈推荐每个任务一个 thread)。',
'guide.sub.discord.s2':'如果是 Private Thread:需要把 Bot/Agent 拉进该 thread(否则读不到消息)。',
'guide.sub.discord.s3':'右键该 Thread → <b>Copy Link</b>,粘贴到表单里(OCM 自动解析 <code>threadId</code>)。',
'guide.sub.discord.warn':'⚠️ 约定:主 Agent 绑定 ChannelSub-Agent 绑定 Thread。不要把 Sub-Agent 绑到普通 Channel。',
'wiz.telegramId':'你的 Telegram User ID','wiz.telegramIdHint':'💡 可通过 @userinfobot 获取,填写后自动配置 allowFrom 白名单','wiz.telegramIdPh':'例如: 123456789',
'agents.empty':'暂无 Agent','agents.main':'主 Agent','agents.bound':'已绑群',
'agents.saveModel':'保存模型','agents.viewFiles':'查看文件',
@@ -2559,7 +2401,7 @@ const I18N = {
'tab.agents':'🤖 Agents','tab.channels':'🧭 Routing','tab.models':'🧠 Models & Auth','tab.auth':'🔑 Auth',
'tab.stats':'📊 Stats','tab.cron':'⏰ Cron',
'agents.title':'Agents','agents.new':' New Subagent',
'channels.title':'Routing Bindings','channels.add':' Add Binding','channels.hint':'Advanced routing rules for agent-channel/group bindings and priority order. Use Agents page for daily add/remove workflows.','channels.removeHint':'When to use Remove binding: if you need to switch to a new Telegram group / Discord thread, remove the old binding here, then add a new binding with the new ID. Also use this for wrong bindings, recreated groups (new id), duplicates/conflicts, decommissioning, or temporary disconnect.',
'channels.title':'Routing Bindings','channels.add':' Add Binding','channels.hint':'Advanced routing rules for agent-channel/group bindings and priority order. Use Agents page for daily add/remove workflows.','channels.removeHint':'When to use Remove binding: wrong agent/chat, group recreated (new id), duplicates/conflicts, decommission a sub-agent, or temporarily disconnect routing for safety.',
'channels.filterLabel':'Agent','channels.filterAll':'All Agents','channels.emptyFiltered':'No bindings for selected agent',
'channels.countSuffix':'bindings','channels.collapse':'Collapse','channels.expand':'Expand',
'models.title':'Model Management','models.primary':'Default Primary Model','models.fallback':'Fallback Chain',
@@ -2609,21 +2451,13 @@ const I18N = {
'guide.title':'📖 Setup Guide','guide.agent.s1':'Open Telegram, search for <code>@BotFather</code>',
'guide.agent.s2':'Send <code>/newbot</code> and follow prompts to name your Bot',
'guide.agent.s3':'Copy the <code>Bot Token</code> from BotFather and paste below',
'guide.agent.s4':'In BotFather: <code>/mybots</code> → select your bot → <b>Bot Settings</b> → <b>Allow Groups</b> → <b>Turn on</b> (allow the bot to join groups)',
'guide.agent.s5':'Send <code>/setprivacy</code> → select your Bot → click <code>Disable</code> (allow Bot to read group messages)',
'guide.agent.s4':'Send <code>/setprivacy</code> → select your Bot → click <code>Disable</code> (allow Bot to read group messages)',
'guide.sub.s1':'Send <code>/newbot</code> to BotFather to create a new Bot and get the Bot Token',
'guide.sub.s2':'Send <code>/mybots</code> to BotFather → select your Bot → <b>Bot Settings</b> → <b>Group Privacy</b> → <b>Turn off</b>',
'guide.sub.s3':'Create a new Telegram group, add the Bot to the group (<b>do NOT add anyone else</b>)',
'guide.sub.s4':'Send a message in the group, find <code>peer.id</code> (negative number) in gateway logs',
'guide.sub.s5':'Fill in the form below to create the Sub-Agent',
'guide.sub.warn':'⚠️ Security: Do NOT add other people to this group. Only you and the Bot should be in the group. Otherwise others can chat with the Bot and incur API costs.',
'guide.agent.discord.s1':'Discord main agent: create/select a dedicated <b>channel</b> (private recommended).',
'guide.agent.discord.s2':'Right-click the channel → <b>Copy Link</b>, paste it into the form (OCM auto-parses <code>channelId</code>; optional <code>guildId</code>).',
'guide.agent.discord.s3':'Recommended: bind one main agent per channel to avoid context bleed.',
'guide.sub.discord.s1':'Discord sub-agent: create a <b>thread</b> under the main channel (one thread per task recommended).',
'guide.sub.discord.s2':'If it is a private thread, add the bot/agent to the thread (otherwise it cannot read messages).',
'guide.sub.discord.s3':'Right-click the thread → <b>Copy Link</b>, paste into the form (OCM auto-parses the <code>threadId</code>).',
'guide.sub.discord.warn':'Important: main agents bind to channels; sub-agents bind to threads. Do not bind sub-agents to normal channels.',
'wiz.telegramId':'Your Telegram User ID','wiz.telegramIdHint':'💡 Get it from @userinfobot — auto-configures allowFrom whitelist','wiz.telegramIdPh':'e.g. 123456789',
'agents.empty':'No Agents','agents.main':'Main Agent','agents.bound':'Bound',
'agents.saveModel':'Save Model','agents.viewFiles':'View Files',
@@ -2759,10 +2593,7 @@ async function checkStatus(){
if(r.needsSetup){ location.reload(); return; }
setDot('ok');
document.getElementById('statusTxt').textContent = r.dir.replace(/.*[/\\\\]/,'.../')+' · v'+r.version;
const tv=document.getElementById('topVersion');
if(tv) tv.textContent = 'OCM v'+(r.ocmVersion||'--');
const vb=document.getElementById('versionBadge'); if(vb) vb.textContent = 'v'+r.version;
const ov=document.getElementById('ocmVersionBadge'); if(ov) ov.textContent='ocm v'+(r.ocmVersion||'--');
document.getElementById('versionBadge').textContent = 'v'+r.version;
}catch{ setDot('err'); document.getElementById('statusTxt').textContent='无法读取配置'; }
}
@@ -2924,51 +2755,24 @@ function buildAddAgentForm() {
const modelOpts = buildModelOpts('__default__');
return '<div class="add-form">' +
'<h3>' + t('agents.addAgentTitle') + '</h3>' +
'<div class="form-group"><label>' + t('wiz.channel') + '</label>' +
'<select id="fa-channel" onchange="toggleAddAgentChannel(this.value)">' +
'<option value="telegram">Telegram</option>' +
'<option value="discord">Discord</option>' +
'</select></div>' +
'<details class="guide-box" open id="fa-guide-telegram"><summary>' + t('guide.title') + '</summary><ol>' +
'<details class="guide-box" open><summary>' + t('guide.title') + '</summary><ol>' +
'<li>' + t('guide.agent.s1') + '</li>' +
'<li>' + t('guide.agent.s2') + '</li>' +
'<li>' + t('guide.agent.s3') + '</li>' +
'<li>' + t('guide.agent.s4') + '</li>' +
'<li>' + t('guide.agent.s5') + '</li>' +
'</ol></details>' +
'<details class="guide-box" open id="fa-guide-discord" style="display:none"><summary>' + t('guide.title') + '</summary><ol>' +
'<li>' + t('guide.agent.discord.s1') + '</li>' +
'<li>' + t('guide.agent.discord.s2') + '</li>' +
'<li>' + t('guide.agent.discord.s3') + '</li>' +
'</ol></details>' +
'<div id="fa-sec-telegram">' +
'<div class="form-group"><label>' + t('agents.botToken') + '</label>' +
'<input id="fa-token" type="text" placeholder="123456:ABC-DEF...">' +
'</div>' +
'</div>' +
'<div class="form-row">' +
'<div class="form-group"><label>Agent ID</label>' +
'<input id="fa-agentid" type="text" placeholder="research, travel_assistant, etc." pattern="[a-zA-Z0-9_-]+">' +
'<input id="fa-agentid" type="text" placeholder="research, alice_bot, etc." pattern="[a-zA-Z0-9_-]+">' +
'<span class="hint-text">Alphanumeric, underscore, or dash only</span></div>' +
'<div class="form-group"><label>' + t('agents.botName') + '</label>' +
'<input id="fa-name" type="text" placeholder="' + t('agents.botNamePh') + '">' +
'</div>' +
'<div class="form-group"><label>Workspace Name</label>' +
'<input id="fa-workspace" type="text" placeholder="research, alice_workspace, etc.">' +
'</div>' +
'<div class="form-group"><label>Workspace Folder</label>' +
'<input id="fa-workspace" type="text" placeholder="(default = Agent ID)">' +
'<span class="hint-text">Each agent must have its own workspace for isolated SOUL/MEMORY.</span></div>' +
'<div id="fa-sec-discord" style="display:none">' +
'<div class="form-group"><label>' + t('wiz.discordChannel') + '</label>' +
'<input id="fa-discord-link" type="text" placeholder="https://discord.com/channels/<guildId>/<channelId> or <channelId>">' +
'<span class="hint-text">' + t('wiz.discordChannelHint') + '</span></div>' +
'</div>' +
'<div class="form-group"><label>' + t('wiz.model') + '</label>' +
'<select id="fa-model">' + modelOpts + '</select>' +
'</div>' +
@@ -2983,35 +2787,22 @@ function buildAddAgentForm() {
'</div></div>';
}
function toggleAddAgentChannel(ch){
const tg=document.getElementById('fa-sec-telegram');
const dg=document.getElementById('fa-sec-discord');
const gT=document.getElementById('fa-guide-telegram');
const gD=document.getElementById('fa-guide-discord');
if(tg) tg.style.display = (ch==='telegram')?'block':'none';
if(dg) dg.style.display = (ch==='discord')?'block':'none';
if(gT) gT.style.display = (ch==='telegram')?'block':'none';
if(gD) gD.style.display = (ch==='discord')?'block':'none';
}
function buildAddSubForm() {
// Build parent agent dropdown (agents with their own bot)
const cfg = S.agents || [];
// Parent agent dropdown (all agents as potential parent for grouping)
const botAgents = cfg.filter(a => a.hasOwnBot);
let parentOpts = '';
if (cfg.length === 0) parentOpts = '<option value="">No agents available</option>';
else cfg.forEach(a=>{ parentOpts += '<option value="'+esc(a.id)+'">'+esc(a.name||a.id)+'</option>'; });
if (botAgents.length === 0) {
parentOpts = '<option value="">No agents with bot available</option>';
} else {
botAgents.forEach(a => {
parentOpts += '<option value="' + esc(a.id) + '">' + esc(a.name || a.id) + '</option>';
});
}
const modelOpts = buildModelOpts('__default__');
return '<div class="add-form">' +
'<h3>' + t('agents.addSubTitle') + '</h3>' +
'<div class="form-group"><label>' + t('wiz.channel') + '</label>' +
'<select id="fs-channel" onchange="toggleAddSubChannel(this.value)">' +
'<option value="telegram">Telegram</option>' +
'<option value="discord">Discord (thread only)</option>' +
'</select>' +
'</div>' +
'<details class="guide-box" open id="fs-guide-telegram"><summary>' + t('guide.title') + '</summary><ol>' +
'<details class="guide-box" open><summary>' + t('guide.title') + '</summary><ol>' +
'<li>' + t('guide.sub.s1') + '</li>' +
'<li>' + t('guide.sub.s2') + '</li>' +
'<li>' + t('guide.sub.s3') + '</li>' +
@@ -3020,50 +2811,19 @@ function buildAddSubForm() {
'</ol>' +
'<div style="margin-top:10px;padding:10px 12px;background:rgba(239,68,68,0.1);border:1px solid rgba(239,68,68,0.3);border-radius:8px;font-size:13px;line-height:1.5">' + t('guide.sub.warn') + '</div>' +
'</details>' +
'<details class="guide-box" open id="fs-guide-discord" style="display:none"><summary>' + t('guide.title') + '</summary><ol>' +
'<li>' + t('guide.sub.discord.s1') + '</li>' +
'<li>' + t('guide.sub.discord.s2') + '</li>' +
'<li>' + t('guide.sub.discord.s3') + '</li>' +
'</ol>' +
'<div style="margin-top:10px;padding:10px 12px;background:rgba(234,179,8,0.12);border:1px solid rgba(234,179,8,0.35);border-radius:8px;font-size:13px;line-height:1.5">' + t('guide.sub.discord.warn') + '</div>' +
'</details>' +
'<div class="form-group"><label>Parent Agent</label>' +
'<select id="fs-parent">' + parentOpts + '</select>' +
'<span class="hint-text">Used for grouping only (Discord sub-agents do not share bots).</span>' +
'</div>' +
'<div id="fs-sec-telegram">' +
'<select id="fs-parent">' + parentOpts + '</select></div>' +
'<div class="form-group"><label>' + t('wiz.groupId') + '</label>' +
'<input id="fs-gid" placeholder="-100XXXXXXXXXX">' +
'<span class="hint-text">' + t('wiz.groupHint') + '</span>' +
'</div>' +
'<span class="hint-text">' + t('wiz.groupHint') + '</span></div>' +
'<div class="form-group"><label>' + t('wiz.telegramId') + '</label>' +
'<input id="fs-tgid" placeholder="' + t('wiz.telegramIdPh') + '">' +
'<span class="hint-text">' + t('wiz.telegramIdHint') + '</span>' +
'</div>' +
'</div>' +
'<div id="fs-sec-discord" style="display:none">' +
'<div class="form-group"><label>' + t('wiz.discordThread') + '</label>' +
'<input id="fs-discord-link" placeholder="https://discord.com/channels/<guildId>/<threadId> or <threadId>">' +
'<span class="hint-text">' + t('wiz.discordThreadHint') + '</span>' +
'</div>' +
'</div>' +
'<span class="hint-text">' + t('wiz.telegramIdHint') + '</span></div>' +
'<div class="form-row">' +
'<div class="form-group"><label>' + t('wiz.agentId') + ' <span style="color:var(--muted);font-weight:400">' + t('wiz.agentIdHint') + '</span></label>' +
'<input id="fs-aid" placeholder="' + t('wiz.agentIdPh') + '"></div>' +
'<div class="form-group"><label>' + t('wiz.displayName') + '</label>' +
'<input id="fs-name" placeholder="' + t('wiz.displayNamePh') + '"></div>' +
'</div>' +
'<div class="form-group"><label>Workspace Folder</label>' +
'<input id="fs-workspace" placeholder="(default = Agent ID)">' +
'<span class="hint-text">Each sub-agent must have its own workspace for isolated SOUL/MEMORY.</span>' +
'</div>' +
'<input id="fs-name" placeholder="' + t('wiz.displayNamePh') + '"></div></div>' +
'<div class="form-group"><label>' + t('wiz.model') + '</label>' +
'<select id="fs-model">' + modelOpts + '</select></div>' +
'<div class="form-group"><label>' + t('wiz.purpose') + '</label>' +
@@ -3072,55 +2832,31 @@ function buildAddSubForm() {
'<input id="fs-soul" placeholder="' + t('wiz.soulPh') + '"></div>' +
'<div class="form-group"><label>' + t('wiz.memory') + ' <span style="color:var(--muted);font-weight:400">' + t('wiz.memoryHint') + '</span></label>' +
'<textarea id="fs-mem" placeholder="' + t('wiz.memoryPh') + '" rows="2"></textarea></div>' +
'<div style="display:flex;gap:8px;margin-top:14px">' +
'<button class="btn-primary" onclick="submitAddSub()">' + t('agents.addSubSubmit') + '</button>' +
'<button class="btn-ghost" onclick="clearAddForm()">' + t('btn.cancel') + '</button>' +
'</div></div>';
}
function toggleAddSubChannel(ch){
const tg=document.getElementById('fs-sec-telegram');
const dg=document.getElementById('fs-sec-discord');
const gT=document.getElementById('fs-guide-telegram');
const gD=document.getElementById('fs-guide-discord');
if(tg) tg.style.display = (ch==='telegram')?'block':'none';
if(dg) dg.style.display = (ch==='discord')?'block':'none';
if(gT) gT.style.display = (ch==='telegram')?'block':'none';
if(gD) gD.style.display = (ch==='discord')?'block':'none';
}
// ── Submit Add Agent (with own bot) ──────────────────────────
async function submitAddAgent() {
const channel = (document.getElementById('fa-channel')?.value||'telegram').trim();
const token = document.getElementById('fa-token').value.trim();
const agentId = document.getElementById('fa-agentid').value.trim();
const name = document.getElementById('fa-name').value.trim();
const workspace = (document.getElementById('fa-workspace').value.trim() || agentId);
const workspace = document.getElementById('fa-workspace').value.trim();
const model = document.getElementById('fa-model').value;
const purpose = (document.getElementById('fa-purpose')?.value||'').trim();
const personality = (document.getElementById('fa-soul')?.value||'').trim();
if (!token) { toast(t('agents.errToken'), 'err'); return; }
if (!agentId) { toast('Agent ID is required', 'err'); return; }
if (!/^[a-zA-Z0-9_-]+$/.test(agentId)) { toast('Agent ID must contain only alphanumeric characters, underscores, or dashes', 'err'); return; }
if (!name) { toast(t('agents.errName'), 'err'); return; }
if (!workspace) { toast('Workspace folder is required', 'err'); return; }
if (!workspace) { toast('Workspace name is required', 'err'); return; }
try {
if (channel === 'telegram') {
const token = document.getElementById('fa-token').value.trim();
if (!token) { toast(t('agents.errToken'), 'err'); return; }
const payload = { botToken: token, agentId, name, workspace, model: model === '__default__' ? '' : model, purpose, personality };
await api('POST', '/api/agents/bot', payload);
} else {
const link = (document.getElementById('fa-discord-link')?.value||'').trim();
const parsed = parseDiscordLinkOrId(link);
if (!parsed) { toast('Discord channel link/ID is required', 'err'); return; }
const payload = { agentId, name, workspaceFolder: workspace, model: model === '__default__' ? '' : model, purpose, personality,
guildId: parsed.guildId, channelId: parsed.channelId };
await api('POST', '/api/agents/discord', payload);
}
const r = await api('POST', '/api/agents/bot', payload);
toast('Agent created successfully', 'ok');
clearAddForm();
closePopover();
showRestartBanner();
await loadAll();
} catch (e) {
@@ -3130,39 +2866,25 @@ async function submitAddAgent() {
// ── Submit Add Sub-Agent ────────────────────────────────────
async function submitAddSub() {
const channel = (document.getElementById('fs-channel')?.value||'telegram').trim();
const parentAgentId = document.getElementById('fs-parent').value.trim();
const groupId = document.getElementById('fs-gid').value.trim();
const telegramUserId = (document.getElementById('fs-tgid')?.value||'').trim();
const agentId = document.getElementById('fs-aid').value.trim();
const displayName = document.getElementById('fs-name').value.trim();
const workspaceFolder = (document.getElementById('fs-workspace')?.value||'').trim() || agentId;
const model = document.getElementById('fs-model').value;
const purpose = document.getElementById('fs-purpose').value.trim();
const personality = document.getElementById('fs-soul').value.trim();
const initialMemory = document.getElementById('fs-mem').value.trim();
if (!parentAgentId) { toast('Parent Agent is required', 'err'); return; }
if (!groupId) { toast(t('wiz.errGroupId'), 'err'); return; }
if (!agentId) { toast(t('wiz.errAgentId'), 'err'); return; }
if (!/^[a-zA-Z0-9_-]+$/.test(agentId)) { toast(t('wiz.errIdFormat'), 'err'); return; }
if (!workspaceFolder) { toast('Workspace folder is required', 'err'); return; }
if (telegramUserId && !/^\\d+$/.test(telegramUserId)) { toast('Telegram User ID must be a number', 'err'); return; }
try {
if (channel === 'telegram') {
const groupId = document.getElementById('fs-gid').value.trim();
const telegramUserId = (document.getElementById('fs-tgid')?.value||'').trim();
if (!groupId) { toast(t('wiz.errGroupId'), 'err'); return; }
if (telegramUserId && !/^\d+$/.test(telegramUserId)) { toast('Telegram User ID must be a number', 'err'); return; }
await api('POST', '/api/agents', { parentAgentId, agentId, displayName: displayName || agentId, groupId,
workspaceFolder, model: model === '__default__' ? '' : model, purpose, personality, initialMemory, telegramUserId });
} else {
const link = (document.getElementById('fs-discord-link')?.value||'').trim();
const parsed = parseDiscordLinkOrId(link);
if (!parsed) { toast('Discord thread link/ID is required', 'err'); return; }
await api('POST', '/api/agents/discord-sub', { parentAgentId, agentId, displayName: displayName || agentId,
workspaceFolder, model: model === '__default__' ? '' : model, purpose, personality, initialMemory,
guildId: parsed.guildId, threadId: parsed.channelId });
}
const r = await api('POST', '/api/agents', { parentAgentId, agentId, displayName: displayName || agentId, groupId, workspaceFolder: agentId, model: model === '__default__' ? '' : model, purpose, personality, initialMemory, telegramUserId });
if (r.error) { toast(r.error, 'err'); return; }
toast(t('wiz.created'), 'ok');
clearAddForm();
document.getElementById('addFormArea').innerHTML = '';
showRestartBanner();
await loadAll();
} catch (e) { toast(e.message, 'err'); }
@@ -3173,59 +2895,39 @@ function renderAgents() {
const el = document.getElementById('agentTree');
if (!S.agents.length) { el.innerHTML = '<div class="empty">' + t('agents.empty') + '</div>'; return; }
// Build grouping: prefer explicit parentAgentId; fallback to telegram bot-root grouping.
const byId = {}; (S.agents||[]).forEach(a=>{ byId[a.id]=a; });
// Build tree: each hasOwnBot agent is a root, others are sub-agents grouped by parentAccountId
const roots = S.agents.filter(a => a.hasOwnBot);
const subs = S.agents.filter(a => !a.hasOwnBot);
// infer parentAgentId for legacy telegram sub-agents if missing
const accountToRootId = {};
(S.agents||[]).forEach(a=>{ if(a.hasOwnBot && a.accountId) accountToRootId[a.accountId]=a.id; });
(S.agents||[]).forEach(a=>{
if(!a.parentAgentId && !a.hasOwnBot && a.parentAccountId && accountToRootId[a.parentAccountId]){
a._inferParentAgentId = accountToRootId[a.parentAccountId];
}
});
// Map accountId -> root agent for sub-agent grouping
const rootByAccount = {};
roots.forEach(a => { if (a.accountId) rootByAccount[a.accountId] = a; });
const roots=[]; const childrenByRoot={}; const orphans=[];
(S.agents||[]).forEach(a=>{
const pid = a.parentAgentId || a._inferParentAgentId || '';
if(pid && byId[pid]){
(childrenByRoot[pid] ||= []).push(a);
// Group subs under their parent
const subsByRoot = {};
const orphanSubs = [];
subs.forEach(a => {
const parentAcct = a.parentAccountId;
if (parentAcct && rootByAccount[parentAcct]) {
const rootId = rootByAccount[parentAcct].id;
if (!subsByRoot[rootId]) subsByRoot[rootId] = [];
subsByRoot[rootId].push(a);
} else {
roots.push(a);
orphanSubs.push(a);
}
});
function fmtBinding(b){
const ch = (b.channel||'').toLowerCase();
const peer = b.peerId ? String(b.peerId) : '';
const acct = b.accountId ? String(b.accountId) : '';
if(ch==='telegram'){
if(peer) return '<span class="badge ok ch-badge ch-tg">TG</span> <span class="badge ok">'+esc(peer)+'</span>';
if(acct) return '<span class="badge ok ch-badge ch-tg">TG Bot</span> <span class="badge">'+esc(acct)+'</span>';
}
if(ch==='discord'){
if(peer) return '<span class="badge ok ch-badge ch-any">Discord</span> <span class="badge">'+esc(peer)+'</span>';
}
return '<span class="badge">'+esc(ch||'bind')+'</span>';
}
function bindingsLine(a){
const arr = (a.bindings||[]).filter(x=>x.peerId||x.accountId);
if(!arr.length) return '';
return '<div class="tree-meta">🔗 '+arr.map(fmtBinding).join(' · ')+'</div>';
}
function agentCard(a, isRoot) {
let h = '';
const icon = isRoot ? '🤖' : '🧩';
const icon = isRoot ? '🤖' : '📱';
const cls = isRoot ? 'tree-main' : 'tree-child';
h += '<div class="' + cls + '">';
h += '<div class="tree-title">' + icon + ' ' + esc(a.name || a.id);
if (a.id === 'main') h += ' <span class="badge main">' + t('agents.main') + '</span>';
if (isRoot) h += ' <span class="badge main">' + (a.id === 'main' ? t('agents.main') : 'Bot') + '</span>';
if (a.groupId) h += ' <span class="badge ok">' + esc(a.groupId) + '</span>';
h += '</div>';
h += '<div class="tree-meta">🧠 ' + esc(a.effectiveModel) + '</div>';
if (a.workspace) h += '<div class="tree-meta">📁 ' + esc(a.workspace) + '</div>';
h += bindingsLine(a);
h += '<div class="tree-actions">';
h += '<select class="inline-sel" id="msel-' + a.id + '">' + buildModelOpts(a.effectiveModel !== t('agents.noModel') ? a.effectiveModel : '__default__') + '</select>';
h += '<button class="btn-secondary" data-action="saveModel" data-id="' + esc(a.id) + '">' + t('agents.saveModel') + '</button>';
@@ -3236,27 +2938,35 @@ function renderAgents() {
}
let html = '<div class="agents-roots">';
// Render each root with its children, side by side
roots.forEach(root => {
const children = childrenByRoot[root.id] || [];
const children = subsByRoot[root.id] || [];
html += '<div class="agent-tree-root">';
html += agentCard(root, true);
if (children.length) {
const treeId = 'tree-' + root.id;
html += '<div class="tree-children-wrap">';
html += '<button class="tree-toggle" data-tree="' + treeId + '" title="Expand / Collapse"></button>';
html += '<button class="tree-toggle" onclick="toggleTree(\\'' + treeId + '\\',this)" title="Expand / Collapse"></button>';
html += '<div class="tree-children" id="' + treeId + '">';
children.forEach(c => { html += agentCard(c, false); });
html += '</div></div>';
}
html += '</div>';
});
// Orphan subs (no matching root — edge case)
orphanSubs.forEach(a => {
html += '<div class="agent-tree-root">';
html += agentCard(a, false);
html += '</div>';
});
html += '</div>';
el.innerHTML = html;
// Event delegation for agent tree buttons
el.onclick = function(ev) {
const tbtn = ev.target.closest('.tree-toggle');
if (tbtn && tbtn.dataset.tree) { toggleTree(tbtn.dataset.tree, tbtn); return; }
const btn = ev.target.closest('[data-action]');
if (!btn) return;
const action = btn.dataset.action;
@@ -4395,21 +4105,6 @@ function assertBrowserScriptSyntax(name, scriptText) {
);
}
}
function parseDiscordLinkOrId(input){
const raw=(input||'').trim();
if(!raw) return null;
// URL form: https://discord.com/channels/<guildId>/<channelId>
const m = raw.match(/discord(?:app)?\.com\/channels\/(\d+)\/(\d+)/i);
if(m) return { guildId: m[1], channelId: m[2] };
// Accept plain numeric id
if(/^\d+$/.test(raw)) return { guildId: '', channelId: raw };
// Accept channel:<id>
const m2 = raw.match(/^channel:(\d+)$/i);
if(m2) return { guildId: '', channelId: m2[1] };
return null;
}
assertBrowserScriptSyntax('main-html-script', MAIN_HTML_SCRIPT);
// ── HTTP 服务器 ───────────────────────────────────────────────