Skip to content

Commit a1c1a3e

Browse files
authored
Merge branch 'main' into feat/plugins-scope-semantics
2 parents f5fec5b + 93f2da8 commit a1c1a3e

43 files changed

Lines changed: 3573 additions & 1805 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

docs/docs.json

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1244,14 +1244,14 @@
12441244
"group": "Providers",
12451245
"pages": [
12461246
"providers/alibaba",
1247-
"providers/anthropic",
1248-
"providers/arcee",
12491247
"providers/bedrock",
12501248
"providers/bedrock-mantle",
1249+
"providers/anthropic",
1250+
"providers/arcee",
12511251
"providers/chutes",
1252-
"providers/comfy",
12531252
"providers/claude-max-api-proxy",
12541253
"providers/cloudflare-ai-gateway",
1254+
"providers/comfy",
12551255
"providers/deepgram",
12561256
"providers/deepseek",
12571257
"providers/fal",
@@ -1260,8 +1260,8 @@
12601260
"providers/glm",
12611261
"providers/google",
12621262
"providers/groq",
1263-
"providers/inferrs",
12641263
"providers/huggingface",
1264+
"providers/inferrs",
12651265
"providers/kilocode",
12661266
"providers/litellm",
12671267
"providers/minimax",
@@ -1283,9 +1283,9 @@
12831283
"providers/together",
12841284
"providers/venice",
12851285
"providers/vercel-ai-gateway",
1286-
"providers/vydra",
12871286
"providers/vllm",
12881287
"providers/volcengine",
1288+
"providers/vydra",
12891289
"providers/xai",
12901290
"providers/xiaomi",
12911291
"providers/zai"

docs/providers/alibaba.md

Lines changed: 83 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -16,57 +16,101 @@ Alibaba Model Studio / DashScope.
1616
- Also accepted: `DASHSCOPE_API_KEY`, `QWEN_API_KEY`
1717
- API: DashScope / Model Studio async video generation
1818

19-
## Quick start
20-
21-
1. Set an API key:
22-
23-
```bash
24-
openclaw onboard --auth-choice qwen-standard-api-key
25-
```
26-
27-
2. Set a default video model:
28-
29-
```json5
30-
{
31-
agents: {
32-
defaults: {
33-
videoGenerationModel: {
34-
primary: "alibaba/wan2.6-t2v",
19+
## Getting started
20+
21+
<Steps>
22+
<Step title="Set an API key">
23+
```bash
24+
openclaw onboard --auth-choice qwen-standard-api-key
25+
```
26+
</Step>
27+
<Step title="Set a default video model">
28+
```json5
29+
{
30+
agents: {
31+
defaults: {
32+
videoGenerationModel: {
33+
primary: "alibaba/wan2.6-t2v",
34+
},
35+
},
3536
},
36-
},
37-
},
38-
}
39-
```
37+
}
38+
```
39+
</Step>
40+
<Step title="Verify the provider is available">
41+
```bash
42+
openclaw models list --provider alibaba
43+
```
44+
</Step>
45+
</Steps>
46+
47+
<Note>
48+
Any of the accepted auth keys (`MODELSTUDIO_API_KEY`, `DASHSCOPE_API_KEY`, `QWEN_API_KEY`) will work. The `qwen-standard-api-key` onboarding choice configures the shared DashScope credential.
49+
</Note>
4050

4151
## Built-in Wan models
4252

4353
The bundled `alibaba` provider currently registers:
4454

45-
- `alibaba/wan2.6-t2v`
46-
- `alibaba/wan2.6-i2v`
47-
- `alibaba/wan2.6-r2v`
48-
- `alibaba/wan2.6-r2v-flash`
49-
- `alibaba/wan2.7-r2v`
55+
| Model ref | Mode |
56+
| -------------------------- | ------------------------- |
57+
| `alibaba/wan2.6-t2v` | Text-to-video |
58+
| `alibaba/wan2.6-i2v` | Image-to-video |
59+
| `alibaba/wan2.6-r2v` | Reference-to-video |
60+
| `alibaba/wan2.6-r2v-flash` | Reference-to-video (fast) |
61+
| `alibaba/wan2.7-r2v` | Reference-to-video |
5062

5163
## Current limits
5264

53-
- Up to **1** output video per request
54-
- Up to **1** input image
55-
- Up to **4** input videos
56-
- Up to **10 seconds** duration
57-
- Supports `size`, `aspectRatio`, `resolution`, `audio`, and `watermark`
58-
- Reference image/video mode currently requires **remote http(s) URLs**
65+
| Parameter | Limit |
66+
| --------------------- | --------------------------------------------------------- |
67+
| Output videos | Up to **1** per request |
68+
| Input images | Up to **1** |
69+
| Input videos | Up to **4** |
70+
| Duration | Up to **10 seconds** |
71+
| Supported controls | `size`, `aspectRatio`, `resolution`, `audio`, `watermark` |
72+
| Reference image/video | Remote `http(s)` URLs only |
73+
74+
<Warning>
75+
Reference image/video mode currently requires **remote http(s) URLs**. Local file paths are not supported for reference inputs.
76+
</Warning>
77+
78+
## Advanced configuration
79+
80+
<AccordionGroup>
81+
<Accordion title="Relationship to Qwen">
82+
The bundled `qwen` provider also uses Alibaba-hosted DashScope endpoints for
83+
Wan video generation. Use:
84+
85+
- `qwen/...` when you want the canonical Qwen provider surface
86+
- `alibaba/...` when you want the direct vendor-owned Wan video surface
87+
88+
See the [Qwen provider docs](/providers/qwen) for more detail.
89+
90+
</Accordion>
91+
92+
<Accordion title="Auth key priority">
93+
OpenClaw checks for auth keys in this order:
5994

60-
## Relationship to Qwen
95+
1. `MODELSTUDIO_API_KEY` (preferred)
96+
2. `DASHSCOPE_API_KEY`
97+
3. `QWEN_API_KEY`
6198

62-
The bundled `qwen` provider also uses Alibaba-hosted DashScope endpoints for
63-
Wan video generation. Use:
99+
Any of these will authenticate the `alibaba` provider.
64100

65-
- `qwen/...` when you want the canonical Qwen provider surface
66-
- `alibaba/...` when you want the direct vendor-owned Wan video surface
101+
</Accordion>
102+
</AccordionGroup>
67103

68104
## Related
69105

70-
- [Video Generation](/tools/video-generation)
71-
- [Qwen](/providers/qwen)
72-
- [Configuration Reference](/gateway/configuration-reference#agent-defaults)
106+
<CardGroup cols={2}>
107+
<Card title="Video generation" href="/tools/video-generation" icon="video">
108+
Shared video tool parameters and provider selection.
109+
</Card>
110+
<Card title="Qwen" href="/providers/qwen" icon="microchip">
111+
Qwen provider setup and DashScope integration.
112+
</Card>
113+
<Card title="Configuration reference" href="/gateway/configuration-reference#agent-defaults" icon="gear">
114+
Agent defaults and model configuration.
115+
</Card>
116+
</CardGroup>

docs/providers/arcee.md

Lines changed: 117 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -12,58 +12,89 @@ read_when:
1212

1313
Arcee AI models can be accessed directly via the Arcee platform or through [OpenRouter](/providers/openrouter).
1414

15-
- Provider: `arcee`
16-
- Auth: `ARCEEAI_API_KEY` (direct) or `OPENROUTER_API_KEY` (via OpenRouter)
17-
- API: OpenAI-compatible
18-
- Base URL: `https://api.arcee.ai/api/v1` (direct) or `https://openrouter.ai/api/v1` (OpenRouter)
19-
20-
## Quick start
21-
22-
1. Get an API key from [Arcee AI](https://chat.arcee.ai/) or [OpenRouter](https://openrouter.ai/keys).
23-
24-
2. Set the API key (recommended: store it for the Gateway):
25-
26-
```bash
27-
# Direct (Arcee platform)
28-
openclaw onboard --auth-choice arceeai-api-key
29-
30-
# Via OpenRouter
31-
openclaw onboard --auth-choice arceeai-openrouter
32-
```
33-
34-
3. Set a default model:
35-
36-
```json5
37-
{
38-
agents: {
39-
defaults: {
40-
model: { primary: "arcee/trinity-large-thinking" },
41-
},
42-
},
43-
}
44-
```
45-
46-
## Non-interactive example
47-
48-
```bash
49-
# Direct (Arcee platform)
50-
openclaw onboard --non-interactive \
51-
--mode local \
52-
--auth-choice arceeai-api-key \
53-
--arceeai-api-key "$ARCEEAI_API_KEY"
54-
55-
# Via OpenRouter
56-
openclaw onboard --non-interactive \
57-
--mode local \
58-
--auth-choice arceeai-openrouter \
59-
--openrouter-api-key "$OPENROUTER_API_KEY"
60-
```
61-
62-
## Environment note
63-
64-
If the Gateway runs as a daemon (launchd/systemd), make sure `ARCEEAI_API_KEY`
65-
(or `OPENROUTER_API_KEY`) is available to that process (for example, in
66-
`~/.openclaw/.env` or via `env.shellEnv`).
15+
| Property | Value |
16+
| -------- | ------------------------------------------------------------------------------------- |
17+
| Provider | `arcee` |
18+
| Auth | `ARCEEAI_API_KEY` (direct) or `OPENROUTER_API_KEY` (via OpenRouter) |
19+
| API | OpenAI-compatible |
20+
| Base URL | `https://api.arcee.ai/api/v1` (direct) or `https://openrouter.ai/api/v1` (OpenRouter) |
21+
22+
## Getting started
23+
24+
<Tabs>
25+
<Tab title="Direct (Arcee platform)">
26+
<Steps>
27+
<Step title="Get an API key">
28+
Create an API key at [Arcee AI](https://chat.arcee.ai/).
29+
</Step>
30+
<Step title="Run onboarding">
31+
```bash
32+
openclaw onboard --auth-choice arceeai-api-key
33+
```
34+
</Step>
35+
<Step title="Set a default model">
36+
```json5
37+
{
38+
agents: {
39+
defaults: {
40+
model: { primary: "arcee/trinity-large-thinking" },
41+
},
42+
},
43+
}
44+
```
45+
</Step>
46+
</Steps>
47+
</Tab>
48+
49+
<Tab title="Via OpenRouter">
50+
<Steps>
51+
<Step title="Get an API key">
52+
Create an API key at [OpenRouter](https://openrouter.ai/keys).
53+
</Step>
54+
<Step title="Run onboarding">
55+
```bash
56+
openclaw onboard --auth-choice arceeai-openrouter
57+
```
58+
</Step>
59+
<Step title="Set a default model">
60+
```json5
61+
{
62+
agents: {
63+
defaults: {
64+
model: { primary: "arcee/trinity-large-thinking" },
65+
},
66+
},
67+
}
68+
```
69+
70+
The same model refs work for both direct and OpenRouter setups (for example `arcee/trinity-large-thinking`).
71+
</Step>
72+
</Steps>
73+
74+
</Tab>
75+
</Tabs>
76+
77+
## Non-interactive setup
78+
79+
<Tabs>
80+
<Tab title="Direct (Arcee platform)">
81+
```bash
82+
openclaw onboard --non-interactive \
83+
--mode local \
84+
--auth-choice arceeai-api-key \
85+
--arceeai-api-key "$ARCEEAI_API_KEY"
86+
```
87+
</Tab>
88+
89+
<Tab title="Via OpenRouter">
90+
```bash
91+
openclaw onboard --non-interactive \
92+
--mode local \
93+
--auth-choice arceeai-openrouter \
94+
--openrouter-api-key "$OPENROUTER_API_KEY"
95+
```
96+
</Tab>
97+
</Tabs>
6798

6899
## Built-in catalog
69100

@@ -75,13 +106,41 @@ OpenClaw currently ships this bundled Arcee catalog:
75106
| `arcee/trinity-large-preview` | Trinity Large Preview | text | 128K | $0.25 / $1.00 | General-purpose; 400B params, 13B active |
76107
| `arcee/trinity-mini` | Trinity Mini 26B | text | 128K | $0.045 / $0.15 | Fast and cost-efficient; function calling |
77108

78-
The same model refs work for both direct and OpenRouter setups (for example `arcee/trinity-large-thinking`).
79-
109+
<Tip>
80110
The onboarding preset sets `arcee/trinity-large-thinking` as the default model.
111+
</Tip>
81112

82113
## Supported features
83114

84-
- Streaming
85-
- Tool use / function calling
86-
- Structured output (JSON mode and JSON schema)
87-
- Extended thinking (Trinity Large Thinking)
115+
| Feature | Supported |
116+
| --------------------------------------------- | ---------------------------- |
117+
| Streaming | Yes |
118+
| Tool use / function calling | Yes |
119+
| Structured output (JSON mode and JSON schema) | Yes |
120+
| Extended thinking | Yes (Trinity Large Thinking) |
121+
122+
<AccordionGroup>
123+
<Accordion title="Environment note">
124+
If the Gateway runs as a daemon (launchd/systemd), make sure `ARCEEAI_API_KEY`
125+
(or `OPENROUTER_API_KEY`) is available to that process (for example, in
126+
`~/.openclaw/.env` or via `env.shellEnv`).
127+
</Accordion>
128+
129+
<Accordion title="OpenRouter routing">
130+
When using Arcee models via OpenRouter, the same `arcee/*` model refs apply.
131+
OpenClaw handles routing transparently based on your auth choice. See the
132+
[OpenRouter provider docs](/providers/openrouter) for OpenRouter-specific
133+
configuration details.
134+
</Accordion>
135+
</AccordionGroup>
136+
137+
## Related
138+
139+
<CardGroup cols={2}>
140+
<Card title="OpenRouter" href="/providers/openrouter" icon="shuffle">
141+
Access Arcee models and many others through a single API key.
142+
</Card>
143+
<Card title="Model selection" href="/concepts/model-providers" icon="layers">
144+
Choosing providers, model refs, and failover behavior.
145+
</Card>
146+
</CardGroup>

0 commit comments

Comments
 (0)