chore(sync): mirror docs from openclaw/openclaw@1b7e16668e

This commit is contained in:
openclaw-docs-sync[bot] 2026-04-06 18:54:04 +00:00
parent aa8cf4adef
commit acd7dc90bd
7 changed files with 126 additions and 7 deletions

View File

@ -1,5 +1,5 @@
{
"repository": "openclaw/openclaw",
"sha": "f9c721d5bf9fb320ddefde95f0944a5b1f743da6",
"syncedAt": "2026-04-06T18:48:27.098Z"
"sha": "1b7e16668e613a8ed01fe8066947e865ea2b7aea",
"syncedAt": "2026-04-06T18:54:03.751Z"
}

View File

@ -1250,6 +1250,7 @@
"pages": [
"providers/alibaba",
"providers/anthropic",
"providers/arcee",
"providers/bedrock",
"providers/bedrock-mantle",
"providers/chutes",
@ -2617,6 +2618,7 @@
"pages": [
"ja-JP/providers/alibaba",
"ja-JP/providers/anthropic",
"ja-JP/providers/arcee",
"ja-JP/providers/bedrock",
"ja-JP/providers/bedrock-mantle",
"ja-JP/providers/chutes",
@ -3369,6 +3371,7 @@
"pages": [
"es/providers/alibaba",
"es/providers/anthropic",
"es/providers/arcee",
"es/providers/bedrock",
"es/providers/bedrock-mantle",
"es/providers/chutes",
@ -4121,6 +4124,7 @@
"pages": [
"pt-BR/providers/alibaba",
"pt-BR/providers/anthropic",
"pt-BR/providers/arcee",
"pt-BR/providers/bedrock",
"pt-BR/providers/bedrock-mantle",
"pt-BR/providers/chutes",
@ -4873,6 +4877,7 @@
"pages": [
"ko/providers/alibaba",
"ko/providers/anthropic",
"ko/providers/arcee",
"ko/providers/bedrock",
"ko/providers/bedrock-mantle",
"ko/providers/chutes",
@ -5625,6 +5630,7 @@
"pages": [
"de/providers/alibaba",
"de/providers/anthropic",
"de/providers/arcee",
"de/providers/bedrock",
"de/providers/bedrock-mantle",
"de/providers/chutes",
@ -6377,6 +6383,7 @@
"pages": [
"fr/providers/alibaba",
"fr/providers/anthropic",
"fr/providers/arcee",
"fr/providers/bedrock",
"fr/providers/bedrock-mantle",
"fr/providers/chutes",
@ -7129,6 +7136,7 @@
"pages": [
"ar/providers/alibaba",
"ar/providers/anthropic",
"ar/providers/arcee",
"ar/providers/bedrock",
"ar/providers/bedrock-mantle",
"ar/providers/chutes",
@ -7881,6 +7889,7 @@
"pages": [
"it/providers/alibaba",
"it/providers/anthropic",
"it/providers/arcee",
"it/providers/bedrock",
"it/providers/bedrock-mantle",
"it/providers/chutes",
@ -8633,6 +8642,7 @@
"pages": [
"tr/providers/alibaba",
"tr/providers/anthropic",
"tr/providers/arcee",
"tr/providers/bedrock",
"tr/providers/bedrock-mantle",
"tr/providers/chutes",
@ -9385,6 +9395,7 @@
"pages": [
"uk/providers/alibaba",
"uk/providers/anthropic",
"uk/providers/arcee",
"uk/providers/bedrock",
"uk/providers/bedrock-mantle",
"uk/providers/chutes",
@ -10137,6 +10148,7 @@
"pages": [
"id/providers/alibaba",
"id/providers/anthropic",
"id/providers/arcee",
"id/providers/bedrock",
"id/providers/bedrock-mantle",
"id/providers/chutes",
@ -10889,6 +10901,7 @@
"pages": [
"pl/providers/alibaba",
"pl/providers/anthropic",
"pl/providers/arcee",
"pl/providers/bedrock",
"pl/providers/bedrock-mantle",
"pl/providers/chutes",

View File

@ -609,8 +609,9 @@ conversation, and it runs after core approval handling finishes.
Provider plugins now have two layers:
- manifest metadata: `providerAuthEnvVars` for cheap env-auth lookup before
runtime load, plus `providerAuthChoices` for cheap onboarding/auth-choice
- manifest metadata: `providerAuthEnvVars` for cheap provider env-auth lookup
before runtime load, `channelEnvVars` for cheap channel env/setup lookup
before runtime load, plus `providerAuthChoices` for cheap onboarding/auth-choice
labels and CLI flag metadata before runtime load
- config-time hooks: `catalog` / legacy `discovery` plus `applyConfigDefaults`
- runtime hooks: `normalizeModelId`, `normalizeTransport`,
@ -645,6 +646,10 @@ one-flag auth wiring without loading provider runtime. Keep provider runtime
`envVars` for operator-facing hints such as onboarding labels or OAuth
client-id/client-secret setup vars.
Use manifest `channelEnvVars` when a channel has env-driven auth or setup that
generic shell-env fallback, config/status checks, or setup prompts should see
without loading channel runtime.
### Hook order and usage
For model/provider plugins, OpenClaw calls hooks in this rough order.

View File

@ -93,6 +93,9 @@ Those belong in your plugin code and `package.json`.
"providerAuthEnvVars": {
"openrouter": ["OPENROUTER_API_KEY"]
},
"channelEnvVars": {
"openrouter-chatops": ["OPENROUTER_CHATOPS_TOKEN"]
},
"providerAuthChoices": [
{
"provider": "openrouter",
@ -142,6 +145,7 @@ Those belong in your plugin code and `package.json`.
| `modelSupport` | No | `object` | Manifest-owned shorthand model-family metadata used to auto-load the plugin before runtime. |
| `cliBackends` | No | `string[]` | CLI inference backend ids owned by this plugin. Used for startup auto-activation from explicit config refs. |
| `providerAuthEnvVars` | No | `Record<string, string[]>` | Cheap provider-auth env metadata that OpenClaw can inspect without loading plugin code. |
| `channelEnvVars` | No | `Record<string, string[]>` | Cheap channel env metadata that OpenClaw can inspect without loading plugin code. Use this for env-driven channel setup or auth surfaces that generic startup/config helpers should see. |
| `providerAuthChoices` | No | `object[]` | Cheap auth-choice metadata for onboarding pickers, preferred-provider resolution, and simple CLI flag wiring. |
| `contracts` | No | `object` | Static bundled capability snapshot for speech, realtime transcription, realtime voice, media-understanding, image-generation, music-generation, video-generation, web-fetch, web search, and tool ownership. |
| `channelConfigs` | No | `Record<string, object>` | Manifest-owned channel config metadata merged into discovery and validation surfaces before runtime loads. |
@ -436,6 +440,9 @@ See [Configuration reference](/gateway/configuration) for the full `plugins.*` s
- `providerAuthEnvVars` is the cheap metadata path for auth probes, env-marker
validation, and similar provider-auth surfaces that should not boot plugin
runtime just to inspect env names.
- `channelEnvVars` is the cheap metadata path for shell-env fallback, setup
prompts, and similar channel surfaces that should not boot plugin runtime
just to inspect env names.
- `providerAuthChoices` is the cheap metadata path for auth-choice pickers,
`--auth-choice` resolution, preferred-provider mapping, and simple onboarding
CLI flag registration before provider runtime loads. For runtime wizard

View File

@ -108,9 +108,15 @@ For setup specifically:
- `openclaw/plugin-sdk/channel-setup` covers the optional-install setup
builders plus a few setup-safe primitives:
`createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`,
`createOptionalChannelSetupWizard`, `DEFAULT_ACCOUNT_ID`,
`createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, and
`splitSetupEntries`
If your channel supports env-driven setup or auth and generic startup/config
flows should know those env names before runtime loads, declare them in the
plugin manifest with `channelEnvVars`. Keep channel runtime `envVars` or local
constants for operator-facing copy only.
`createOptionalChannelSetupWizard`, `DEFAULT_ACCOUNT_ID`,
`createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, and
`splitSetupEntries`
- use the broader `openclaw/plugin-sdk/setup` seam only when you also need the
heavier shared setup/config helpers such as
`moveSingleAccountChannelSectionToDefaultAccount(...)`

87
docs/providers/arcee.md Normal file
View File

@ -0,0 +1,87 @@
---
title: "Arcee AI"
summary: "Arcee AI setup (auth + model selection)"
read_when:
- You want to use Arcee AI with OpenClaw
- You need the API key env var or CLI auth choice
---
# Arcee AI
[Arcee AI](https://arcee.ai) provides access to the Trinity family of mixture-of-experts models through an OpenAI-compatible API. All Trinity models are Apache 2.0 licensed.
Arcee AI models can be accessed directly via the Arcee platform or through [OpenRouter](/providers/openrouter).
- Provider: `arcee`
- Auth: `ARCEEAI_API_KEY` (direct) or `OPENROUTER_API_KEY` (via OpenRouter)
- API: OpenAI-compatible
- Base URL: `https://api.arcee.ai/api/v1` (direct) or `https://openrouter.ai/api/v1` (OpenRouter)
## Quick start
1. Get an API key from [Arcee AI](https://chat.arcee.ai/) or [OpenRouter](https://openrouter.ai/keys).
2. Set the API key (recommended: store it for the Gateway):
```bash
# Direct (Arcee platform)
openclaw onboard --auth-choice arceeai-api-key
# Via OpenRouter
openclaw onboard --auth-choice arceeai-openrouter
```
3. Set a default model:
```json5
{
agents: {
defaults: {
model: { primary: "arcee/trinity-large-thinking" },
},
},
}
```
## Non-interactive example
```bash
# Direct (Arcee platform)
openclaw onboard --non-interactive \
--mode local \
--auth-choice arceeai-api-key \
--arceeai-api-key "$ARCEEAI_API_KEY"
# Via OpenRouter
openclaw onboard --non-interactive \
--mode local \
--auth-choice arceeai-openrouter \
--openrouter-api-key "$OPENROUTER_API_KEY"
```
## Environment note
If the Gateway runs as a daemon (launchd/systemd), make sure `ARCEEAI_API_KEY`
(or `OPENROUTER_API_KEY`) is available to that process (for example, in
`~/.openclaw/.env` or via `env.shellEnv`).
## Built-in catalog
OpenClaw currently ships this bundled Arcee catalog:
| Model ref | Name | Input | Context | Cost (in/out per 1M) | Notes |
| ------------------------------ | ---------------------- | ----- | ------- | -------------------- | ----------------------------------------- |
| `arcee/trinity-large-thinking` | Trinity Large Thinking | text | 256K | $0.25 / $0.90 | Default model; reasoning enabled |
| `arcee/trinity-large-preview` | Trinity Large Preview | text | 128K | $0.25 / $1.00 | General-purpose; 400B params, 13B active |
| `arcee/trinity-mini` | Trinity Mini 26B | text | 128K | $0.045 / $0.15 | Fast and cost-efficient; function calling |
The same model refs work for both direct and OpenRouter setups (for example `arcee/trinity-large-thinking`).
The onboarding preset sets `arcee/trinity-large-thinking` as the default model.
## Supported features
- Streaming
- Tool use / function calling
- Structured output (JSON mode and JSON schema)
- Extended thinking (Trinity Large Thinking)

View File

@ -29,6 +29,7 @@ Looking for chat channel docs (WhatsApp/Telegram/Discord/Slack/Mattermost (plugi
- [Alibaba Model Studio](/providers/alibaba)
- [Amazon Bedrock](/providers/bedrock)
- [Anthropic (API + Claude CLI)](/providers/anthropic)
- [Arcee AI (Trinity models)](/providers/arcee)
- [BytePlus (International)](/concepts/model-providers#byteplus-international)
- [Chutes](/providers/chutes)
- [ComfyUI](/providers/comfy)