From cef210520701d2c57fce139eb4832ee56a01f929 Mon Sep 17 00:00:00 2001
From: Ryanba <92616678+Gujiassh@users.noreply.github.com>
Date: Sun, 12 Apr 2026 12:25:56 +0800
Subject: [PATCH] docs: add Qwen integration guide (#232)

Adds Qwen integration guide documenting convert_qwen/install_qwen behavior and project-scoped setup.
---
 integrations/README.md      | 28 +++++++++++++++++++++++-
 integrations/qwen/README.md | 43 +++++++++++++++++++++++++++++++++++++
 2 files changed, 70 insertions(+), 1 deletion(-)
 create mode 100644 integrations/qwen/README.md

diff --git a/integrations/README.md b/integrations/README.md
index 3f93a4d..6023752 100644
--- a/integrations/README.md
+++ b/integrations/README.md
@@ -15,6 +15,7 @@ supported agentic coding tools.
 - **[Aider](#aider)** — `CONVENTIONS.md` in `aider/`
 - **[Windsurf](#windsurf)** — `.windsurfrules` in `windsurf/`
 - **[Kimi Code](#kimi-code)** — YAML agent specs in `kimi/`
+- **[Qwen Code](#qwen-code)** — project-scoped `.md` SubAgents in `.qwen/agents/`
 
 ## Quick Install
 
@@ -31,6 +32,10 @@ supported agentic coding tools.
 # Gemini CLI needs generated integration files on a fresh clone
 ./scripts/convert.sh --tool gemini-cli
 ./scripts/install.sh --tool gemini-cli
+
+# Qwen Code also needs generated SubAgent files on a fresh clone
+./scripts/convert.sh --tool qwen
+./scripts/install.sh --tool qwen
 ```
 
 If you install OpenClaw and the gateway is already running, restart it after installation:
@@ -39,7 +44,8 @@ If you install OpenClaw and the gateway is already running, restart it after ins
 openclaw gateway restart
 ```
 
-For project-scoped tools such as OpenCode, Cursor, Aider, and Windsurf, run
+For project-scoped tools such as OpenCode, Cursor, Aider, Windsurf, and Qwen
+Code, run
 the installer from your target project root as shown in the tool-specific
 sections below.
 
@@ -212,3 +218,23 @@ kimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yaml \
 ```
 
 See [kimi/README.md](kimi/README.md) for details.
+
+---
+
+## Qwen Code
+
+Each agent becomes a project-scoped `.md` SubAgent file in `.qwen/agents/`.
+
+From a fresh clone, generate the Qwen files first:
+
+```bash
+./scripts/convert.sh --tool qwen
+```
+
+Then install them from your project root:
+
+```bash
+cd /your/project && /path/to/agency-agents/scripts/install.sh --tool qwen
+```
+
+See [qwen/README.md](qwen/README.md) for details.
diff --git a/integrations/qwen/README.md b/integrations/qwen/README.md
new file mode 100644
index 0000000..602106b
--- /dev/null
+++ b/integrations/qwen/README.md
@@ -0,0 +1,43 @@
+# Qwen Code Integration
+
+Qwen Code uses project-scoped `.md` SubAgent files in `.qwen/agents/`.
+
+The generated files come from `scripts/convert.sh --tool qwen`, which writes one
+SubAgent Markdown file per agency agent into `integrations/qwen/agents/`.
+
+## Generate
+
+From the repository root:
+
+```bash
+./scripts/convert.sh --tool qwen
+```
+
+## Install
+
+Run the installer from your target project root:
+
+```bash
+cd /your/project && /path/to/agency-agents/scripts/install.sh --tool qwen
+```
+
+This copies the generated SubAgent files into:
+
+```text
+.qwen/agents/
+```
+
+## Refresh in Qwen Code
+
+After installation:
+
+- run `/agents manage` in Qwen Code to refresh the agent list, or
+- restart the current Qwen Code session
+
+## Notes
+
+- Qwen Code is project-scoped, not home-scoped
+- The generated Qwen files use minimal frontmatter: `name`, `description`, and
+  optional `tools`
+- If you update agents in this repo, regenerate the Qwen output before
+  reinstalling