vilvona 1.0.0

package/docs/prose.md

@@ -0,0 +1,191 @@
+---
+title: "OpenProse"
+sidebarTitle: "OpenProse"
+summary: "OpenProse is a markdown-first workflow format for multi-agent AI sessions. In OpenClaw it ships as a plugin with a /prose slash command and a skill pack."
+read_when:
+  - You want to run or write .prose workflow files
+  - You want to enable the OpenProse plugin
+  - You need to understand how OpenProse maps to OpenClaw primitives
+---
+
+OpenProse is a portable, markdown-first workflow format for orchestrating AI
+sessions. In OpenClaw it ships as a plugin that installs an OpenProse skill
+pack and a `/prose` slash command. Programs live in `.prose` files and can
+spawn multiple sub-agents with explicit control flow.
+
+<CardGroup cols={3}>
+  <Card title="Install" icon="download" href="#install">
+    Enable the OpenProse plugin and restart the Gateway.
+  </Card>
+  <Card title="Run a program" icon="play" href="#slash-command">
+    Use `/prose run` to execute a `.prose` file or remote program.
+  </Card>
+  <Card title="Write programs" icon="pencil" href="#example">
+    Author multi-agent workflows with parallel and sequential steps.
+  </Card>
+</CardGroup>
+
+## Install
+
+<Steps>
+  <Step title="Enable the plugin">
+    Bundled plugins are disabled by default. Enable OpenProse:
+
+    ```bash
+    openclaw plugins enable open-prose
+    ```
+
+  </Step>
+  <Step title="Restart the Gateway">
+    ```bash
+    openclaw gateway restart
+    ```
+  </Step>
+  <Step title="Verify">
+    ```bash
+    openclaw plugins list | grep prose
+    ```
+
+    You should see `open-prose` as enabled. The `/prose` skill command is now
+    available in chat.
+
+  </Step>
+</Steps>
+
+For a local checkout: `openclaw plugins install ./path/to/local/open-prose-plugin`
+
+## Slash command
+
+OpenProse registers `/prose` as a user-invocable skill command:
+
+```text
+/prose help
+/prose run <file.prose>
+/prose run <handle/slug>
+/prose run <https://example.com/file.prose>
+/prose compile <file.prose>
+/prose examples
+/prose update
+```
+
+`/prose run <handle/slug>` resolves to `https://p.prose.md/<handle>/<slug>`.
+Direct URLs are fetched as-is using the `web_fetch` tool.
+
+## What it can do
+
+- Multi-agent research and synthesis with explicit parallelism.
+- Repeatable, approval-safe workflows (code review, incident triage, content pipelines).
+- Reusable `.prose` programs you can run across supported agent runtimes.
+
+## Example: parallel research and synthesis
+
+```prose
+# Research + synthesis with two agents running in parallel.
+
+input topic: "What should we research?"
+
+agent researcher:
+  model: sonnet
+  prompt: "You research thoroughly and cite sources."
+
+agent writer:
+  model: opus
+  prompt: "You write a concise summary."
+
+parallel:
+  findings = session: researcher
+    prompt: "Research {topic}."
+  draft = session: writer
+    prompt: "Summarize {topic}."
+
+session "Merge the findings + draft into a final answer."
+context: { findings, draft }
+```
+
+## OpenClaw runtime mapping
+
+OpenProse programs map to OpenClaw primitives:
+
+| OpenProse concept         | OpenClaw tool    |
+| ------------------------- | ---------------- |
+| Spawn session / Task tool | `sessions_spawn` |
+| File read / write         | `read` / `write` |
+| Web fetch                 | `web_fetch`      |
+
+<Warning>
+  If your tool allowlist blocks `sessions_spawn`, `read`, `write`, or
+  `web_fetch`, OpenProse programs will fail. Check your
+  [tools allowlist config](/gateway/config-tools).
+</Warning>
+
+## File locations
+
+OpenProse keeps state under `.prose/` in your workspace:
+
+```text
+.prose/
+├── .env
+├── runs/
+│   └── {YYYYMMDD}-{HHMMSS}-{random}/
+│       ├── program.prose
+│       ├── state.md
+│       ├── bindings/
+│       └── agents/
+└── agents/
+```
+
+User-level persistent agents live at:
+
+```text
+~/.prose/agents/
+```
+
+## State backends
+
+<AccordionGroup>
+  <Accordion title="filesystem (default)">
+    State is written to `.prose/runs/...` in the workspace. No extra
+    dependencies required.
+  </Accordion>
+  <Accordion title="in-context">
+    Transient state kept in the context window. Suitable for small, short-lived
+    programs.
+  </Accordion>
+  <Accordion title="sqlite (experimental)">
+    Requires the `sqlite3` binary on `PATH`.
+  </Accordion>
+  <Accordion title="postgres (experimental)">
+    Requires `psql` and a connection string.
+
+    <Warning>
+      Postgres credentials flow into sub-agent logs. Use a dedicated,
+      least-privileged database.
+    </Warning>
+
+  </Accordion>
+</AccordionGroup>
+
+## Security
+
+Treat `.prose` files like code. Review them before running. Use OpenClaw tool
+allowlists and approval gates to control side effects. For deterministic,
+approval-gated workflows, compare with [Lobster](/tools/lobster).
+
+## Related
+
+<CardGroup cols={2}>
+  <Card title="Skills reference" href="/tools/skills" icon="puzzle-piece">
+    How OpenProse's skill pack loads and what gates apply.
+  </Card>
+  <Card title="Subagents" href="/tools/subagents" icon="users">
+    OpenClaw's native multi-agent coordination layer.
+  </Card>
+  <Card title="Text-to-speech" href="/tools/tts" icon="volume-high">
+    Add audio output to your workflows.
+  </Card>
+  <Card title="Slash commands" href="/tools/slash-commands" icon="terminal">
+    All available chat commands including /prose.
+  </Card>
+</CardGroup>
+
+Official site: [https://www.prose.md](https://www.prose.md)

package/docs/providers/alibaba.md

@@ -0,0 +1,158 @@
+---
+summary: "Alibaba Model Studio Wan video generation in OpenClaw"
+title: "Alibaba Model Studio"
+read_when:
+  - You want to use Alibaba Wan video generation in OpenClaw
+  - You need Model Studio or DashScope API key setup for video generation
+---
+
+OpenClaw ships a bundled `alibaba` plugin that registers a video-generation provider for Wan models on Alibaba Model Studio (the international name for DashScope). The plugin is enabled by default; you only need to set an API key.
+
+| Property         | Value                                                                           |
+| ---------------- | ------------------------------------------------------------------------------- |
+| Provider id      | `alibaba`                                                                       |
+| Plugin           | bundled, `enabledByDefault: true`                                               |
+| Auth env vars    | `MODELSTUDIO_API_KEY` → `DASHSCOPE_API_KEY` → `QWEN_API_KEY` (first match wins) |
+| Onboarding flag  | `--auth-choice alibaba-model-studio-api-key`                                    |
+| Direct CLI flag  | `--alibaba-model-studio-api-key <key>`                                          |
+| Default model    | `alibaba/wan2.6-t2v`                                                            |
+| Default base URL | `https://dashscope-intl.aliyuncs.com`                                           |
+
+## Getting started
+
+<Steps>
+  <Step title="Set an API key">
+    Use onboarding to store the key against the `alibaba` provider:
+
+    ```bash
+    openclaw onboard --auth-choice alibaba-model-studio-api-key
+    ```
+
+    Or pass the key directly during install/onboarding:
+
+    ```bash
+    openclaw onboard --alibaba-model-studio-api-key <your-key>
+    ```
+
+    Or export any of the accepted env vars before starting the Gateway:
+
+    ```bash
+    export MODELSTUDIO_API_KEY=sk-...
+    # or DASHSCOPE_API_KEY=...
+    # or QWEN_API_KEY=...
+    ```
+
+  </Step>
+  <Step title="Set a default video model">
+    ```json5
+    {
+      agents: {
+        defaults: {
+          videoGenerationModel: {
+            primary: "alibaba/wan2.6-t2v",
+          },
+        },
+      },
+    }
+    ```
+  </Step>
+  <Step title="Verify the provider is configured">
+    ```bash
+    openclaw models list --provider alibaba
+    ```
+
+    The list should include all five bundled Wan models. If `MODELSTUDIO_API_KEY` is unresolved, `openclaw models status --json` reports the missing credential under `auth.unusableProfiles`.
+
+  </Step>
+</Steps>
+
+<Note>
+  The Alibaba plugin and the [Qwen plugin](/providers/qwen) both authenticate against DashScope and accept overlapping env vars. Use `alibaba/...` model ids to drive the dedicated Wan video surface; use `qwen/...` ids when you want Qwen's chat, embedding, or media-understanding surface.
+</Note>
+
+## Built-in Wan models
+
+| Model ref                  | Mode                      |
+| -------------------------- | ------------------------- |
+| `alibaba/wan2.6-t2v`       | Text-to-video (default)   |
+| `alibaba/wan2.6-i2v`       | Image-to-video            |
+| `alibaba/wan2.6-r2v`       | Reference-to-video        |
+| `alibaba/wan2.6-r2v-flash` | Reference-to-video (fast) |
+| `alibaba/wan2.7-r2v`       | Reference-to-video        |
+
+## Capabilities and limits
+
+The bundled provider mirrors DashScope's Wan video API caps. All three modes share the same per-request video count and duration cap; only the input shape differs.
+
+| Mode               | Max output videos | Max input images | Max input videos | Max duration | Supported controls                                        |
+| ------------------ | ----------------- | ---------------- | ---------------- | ------------ | --------------------------------------------------------- |
+| Text-to-video      | 1                 | n/a              | n/a              | 10 s         | `size`, `aspectRatio`, `resolution`, `audio`, `watermark` |
+| Image-to-video     | 1                 | 1                | n/a              | 10 s         | `size`, `aspectRatio`, `resolution`, `audio`, `watermark` |
+| Reference-to-video | 1                 | n/a              | 4                | 10 s         | `size`, `aspectRatio`, `resolution`, `audio`, `watermark` |
+
+When a request omits `durationSeconds`, the provider sends DashScope's accepted default of **5 seconds**. Set `durationSeconds` explicitly on the [video generation tool](/tools/video-generation) to extend up to 10 s.
+
+<Warning>
+  Reference image and video inputs must be remote `http(s)` URLs. Local file paths are not accepted by DashScope's reference modes; upload to object storage first or use the [media tool](/tools/media-overview) flow that already produces a public URL.
+</Warning>
+
+## Advanced configuration
+
+<AccordionGroup>
+  <Accordion title="Override the DashScope base URL">
+    The provider defaults to the international DashScope endpoint. To target the China-region endpoint, set:
+
+    ```json5
+    {
+      models: {
+        providers: {
+          alibaba: {
+            baseUrl: "https://dashscope.aliyuncs.com",
+          },
+        },
+      },
+    }
+    ```
+
+    The provider strips trailing slashes before constructing AIGC task URLs.
+
+  </Accordion>
+
+  <Accordion title="Auth env priority">
+    OpenClaw resolves the Alibaba API key from environment variables in this order, taking the first non-empty value:
+
+    1. `MODELSTUDIO_API_KEY`
+    2. `DASHSCOPE_API_KEY`
+    3. `QWEN_API_KEY`
+
+    Configured `auth.profiles` entries (set via `openclaw models auth login`) override env-var resolution. See [Auth profiles in the models FAQ](/help/faq-models#what-is-an-auth-profile) for profile rotation, cooldown, and override mechanics.
+
+  </Accordion>
+
+  <Accordion title="Relationship to the Qwen plugin">
+    Both bundled plugins talk to DashScope and accept overlapping API keys. Use:
+
+    - `alibaba/wan*.*` ids to drive the dedicated Wan video provider documented on this page.
+    - `qwen/*` ids for Qwen chat, embedding, and media understanding (see [Qwen](/providers/qwen)).
+
+    Setting `MODELSTUDIO_API_KEY` once authenticates both plugins because the auth env var list intentionally overlaps; you do not need to onboard each plugin separately.
+
+  </Accordion>
+</AccordionGroup>
+
+## Related
+
+<CardGroup cols={2}>
+  <Card title="Video generation" href="/tools/video-generation" icon="video">
+    Shared video tool parameters and provider selection.
+  </Card>
+  <Card title="Qwen" href="/providers/qwen" icon="microchip">
+    Qwen chat, embedding, and media-understanding setup on the same DashScope auth.
+  </Card>
+  <Card title="Configuration reference" href="/gateway/config-agents#agent-defaults" icon="gear">
+    Agent defaults and model configuration.
+  </Card>
+  <Card title="Models FAQ" href="/help/faq-models" icon="circle-question">
+    Auth profiles, switching models, and resolving "no profile" errors.
+  </Card>
+</CardGroup>