docs: add Qwen integration guide (#232)

Adds Qwen integration guide documenting convert_qwen/install_qwen behavior and project-scoped setup.
This commit is contained in:
Ryanba 2026-04-12 12:25:56 +08:00 committed by GitHub
parent 2af3773866
commit cef2105207
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 70 additions and 1 deletions

View File

@ -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.

View File

@ -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