docs(voyage): clarify API key setup

luoyanglang · luoyanglang · commit 71ae12554e5c · 2026-05-17T11:05:51.000Z
diff --git a/docs/plugins/reference/voyage.md b/docs/plugins/reference/voyage.md
@@ -9,6 +9,54 @@ title: "Voyage plugin"
 
 Adds memory embedding provider support.
 
+## Setup
+
+Voyage is a remote memory embedding provider, so it needs a Voyage API key before
+memory search can use it.
+
+Set the key with either:
+
+- Environment variable: `VOYAGE_API_KEY`
+- Config key: `models.providers.voyage.apiKey`
+
+For an interactive setup, run:
+
+```bash
+openclaw configure --section model
+```
+
+To make memory search use Voyage explicitly, set the memory search provider to
+`voyage` and choose a Voyage embedding model:
+
+```ts
+{
+  agents: {
+    defaults: {
+      memorySearch: {
+        provider: "voyage",
+        model: "voyage-3-large",
+      },
+    },
+  },
+  models: {
+    providers: {
+      voyage: {
+        apiKey: "${VOYAGE_API_KEY}",
+      },
+    },
+  },
+}
+```
+
+Verify the runtime credential and embedding provider path with:
+
+```bash
+openclaw memory status --deep
+```
+
+For the full memory embedding provider matrix and API key resolution order, see
+[Memory config](/reference/memory-config).
+
 ## Distribution
 
 - Package: `@openclaw/voyage-provider`
