duoduo-channel-admin

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Duoduo Channel Admin

This skill owns host-mode channel lifecycle and channel-facing configuration.

本技能负责主机模式通道的生命周期管理及面向通道的配置工作。

Start With Channel Discovery

从通道发现开始

Confirm host mode with
```
duoduo daemon status
```
.

Read

duoduo daemon config

to resolve the actual

kernel_dir

and

runtime_dir

Inspect installed plugins with
```
duoduo channel list
```
.
When changing one specific channel instance, inspect the relevant
```
descriptor.md
```
before editing it.

Read references/channel-lifecycle.md for the actual install and lifecycle rules, and references/channel-config-model.md for the kind-vs-instance config model.

通过
```
duoduo daemon status
```
确认主机模式状态。

读取

duoduo daemon config

获取实际的

kernel_dir

和

runtime_dir

。

通过
```
duoduo channel list
```
检查已安装的插件。
修改特定通道实例时，编辑前先查看对应的
```
descriptor.md
```
文件。

查看references/channel-lifecycle.md了解实际的安装和生命周期规则，查看references/channel-config-model.md了解kind与实例的配置模型。

Install And Run Channels

安装并运行通道

Feishu

Use the official install path:

bash

duoduo channel install @openduo/channel-feishu

For the simplest credential setup, direct the user to get the official Feishu bot

App ID

and

App Secret

from:

open.feishu.cn/page/openclaw?form=multiAgent

Then ensure those host-mode credentials are present in

~/.config/duoduo/.env

and start the plugin with:

bash

duoduo channel feishu start

If the user wants the agent to do the setup for them, it is acceptable for them to paste the

App ID

and

App Secret

directly into chat and ask the agent to write

FEISHU_APP_ID

and

FEISHU_APP_SECRET

into

~/.config/duoduo/.env

. Before doing that, explicitly remind them that these are sensitive credentials and that sharing them in chat carries the normal leakage and retention risks.

Use

status

stop

, and

logs

for lifecycle operations.

使用官方安装路径：

bash

duoduo channel install @openduo/channel-feishu

最简单的凭证配置方式是引导用户从以下地址获取官方Feishu机器人的

App ID

和

App Secret

：

open.feishu.cn/page/openclaw?form=multiAgent

然后确认这些主机模式凭证已存入

~/.config/duoduo/.env

，并通过以下命令启动插件：

bash

duoduo channel feishu start

如果用户希望Agent代为配置，也可以让他们直接在聊天中粘贴

App ID

和

App Secret

，要求Agent将

FEISHU_APP_ID

和

FEISHU_APP_SECRET

写入

~/.config/duoduo/.env

。执行操作前，需明确提醒用户这些是敏感凭证，在聊天中分享存在常规的泄露和留存风险。

可使用

status

、

stop

、

logs

命令执行生命周期操作。

ACP (Editor Integration)

ACP（编辑器集成）

Install the official ACP bridge for editor integrations (Zed, Cursor, etc.):

bash

duoduo channel install @openduo/channel-acp
duoduo channel acp start

No credentials are required. Each ACP session maps 1:1 to a daemon session.

安装官方ACP桥接插件用于编辑器集成（Zed、Cursor等）：

bash

duoduo channel install @openduo/channel-acp
duoduo channel acp start

无需凭证，每个ACP会话与守护进程会话一一对应。

WeChat And Other Third-Party Channels

微信及其他第三方通道

Duoduo's installer accepts npm package specs or
```
.tgz
```
tarballs.
Do not claim that
```
duoduo channel install https://github.com/...
```
works unless the runtime actually supports it.
If a third-party repo is not yet published in a duoduo-compatible form, package or publish it first, then install the npm package or tarball.

Duoduo的安装器支持npm包规范或
```
.tgz
```
tarball格式。
除非运行时实际支持，否则不要声称
```
duoduo channel install https://github.com/...
```
可用。
如果第三方仓库尚未发布为duoduo兼容格式，先打包发布，再安装对应的npm包或tarball。

Configure Channel Behavior

配置通道行为

Use kind descriptors for defaults that should apply to every channel of a kind. Use instance descriptors for one specific channel only.

Kind descriptor:
```
kernel_dir/config/<kind>.md
```

Instance descriptor:

runtime_dir/var/channels/<channel_id>/descriptor.md

Typical editable keys:

```
new_session_workspace
```
```
prompt_mode
```
```
time_gap_minutes
```
```
stream
```
```
allowedTools
```
```
disallowedTools
```
```
additionalDirectories
```

Use scripts/patch_markdown_frontmatter.py for frontmatter edits that should preserve comments and the Markdown body. For prompt-body rewrites, use

replace-body

or apply a direct patch when that is clearer.

Kind描述符适用于所有同类型通道的默认配置，实例描述符仅适用于单个特定通道。

Kind描述符：
```
kernel_dir/config/<kind>.md
```

实例描述符：

runtime_dir/var/channels/<channel_id>/descriptor.md

常见可编辑配置项：

```
new_session_workspace
```
```
prompt_mode
```
```
time_gap_minutes
```
```
stream
```
```
allowedTools
```
```
disallowedTools
```
```
additionalDirectories
```

如果需要编辑Markdown frontmatter同时保留注释和Markdown正文，可使用scripts/patch_markdown_frontmatter.py。如果要重写提示词正文，可使用

replace-body

或者直接应用补丁（当逻辑更清晰时）。

Prompt Editing Rules

提示词编辑规则

The Markdown body of
```
kernel/config/<kind>.md
```
is the kind prompt.
The Markdown body of
```
descriptor.md
```
is the instance prompt.
Instance frontmatter and prompt override kind defaults for that one channel.
Preserve guidance comments in bootstrapped files whenever possible.

```
kernel/config/<kind>.md
```
的Markdown正文是类型默认提示词。
```
descriptor.md
```
的Markdown正文是实例提示词。
单个通道的实例frontmatter和提示词会覆盖类型默认配置。
尽可能保留引导文件中的指导注释。

Operating Rules

操作规则

Prefer the smallest scope that matches the request: kind-level for defaults, instance-level for a single room or session surface.
After changing channel credentials in
```
~/.config/duoduo/.env
```
, restart the affected channel process.

After installing a new plugin, verify with

duoduo channel list

and

duoduo channel <type> status

If the channel still fails after credentials, install state, and runtime config look correct, treat it as a likely product or plugin issue and use the public issue flow from ../duoduo-admin/references/issue-reporting.md.
If the request is really about telemetry, cadence, debug logs, or Codex, hand off to
```
duoduo-runtime-admin
```
.

优先选择符合需求的最小作用域：默认配置修改用kind级别，单个房间/会话层面的修改用实例级别。
修改
```
~/.config/duoduo/.env
```
中的通道凭证后，重启受影响的通道进程。
安装新插件后，通过
```
duoduo channel list
```
和
```
duoduo channel <type> status
```
验证安装结果。
如果凭证、安装状态、运行时配置看起来都正确但通道仍然报错，大概率是产品或插件问题，按照../duoduo-admin/references/issue-reporting.md中的公开Issue提交流程处理。
如果请求实际涉及遥测、运行节奏、调试日志或Codex，转交
```
duoduo-runtime-admin
```
处理。