ElizaOS plugins
Orkid plugins for ElizaOS agents — gasless swaps and persistent memory.
Orkid publishes two ElizaOS plugins under the @orkid-labs npm scope. Install them directly from npm — elizaOS retired its community plugin registry (elizaOS/eliza#32219), so direct package install + plugins[] wiring is the supported path.
Starter template
Forkable agent starter — Dockerfile + character config wiring both plugins:
github.com/orkid-labs/eliza-trader-starter. Clone it, add env vars, and the
agent quotes and dry-runs against the keyless sandbox immediately.
@orkid-labs/plugin-orkid
Gasless swap engine integration — an agent can quote, execute, dry-run, confirm, and track swaps across Base, Ethereum, and Arbitrum.
bun add @orkid-labs/plugin-orkid
# or
npm install @orkid-labs/plugin-orkidRegister it in your agent character:
import { orkidPlugin } from '@orkid-labs/plugin-orkid'
const character = {
// ...
plugins: [orkidPlugin],
}Configuration
| Variable | Required | Description |
|---|---|---|
ORKID_API_KEY | Yes | 40-char hex API key — required for partner volume tracking. Instant key at orkidlabs.xyz/partner; higher tiers via api@orkidlabs.com. |
ORKID_API_URL | No | API base URL. Defaults to https://orkidlabs.xyz; use https://sandbox.orkidlabs.com for dry-run-only test mode. |
ORKID_USER_ADDRESS | No | Default wallet address for swaps. |
Actions
| Action | Description |
|---|---|
ORKID_GET_QUOTE | Quote a swap — calls /api/v1/route (non-billable) |
ORKID_EXECUTE_SWAP | Execute a swap — calls /api/v1/solve (billable, counts toward rebates) |
ORKID_DRY_RUN_SWAP | Solve with dryRun: true — returns calldata without submitting |
ORKID_CONFIRM_TX | Confirm a user-pays-gas transaction via /api/v1/confirm |
ORKID_LIST_TOKENS | List supported tokens per chain |
ORKID_GET_USAGE | Account usage and volume stats |
ORKID_MARKET_DATA | Provider — injects live market context into agent state |
@orkid-labs/plugin-mempalace
Persistent agent memory via the MemPalace MCP server — store, search, and recall context across sessions. Agents get durable long-term memory instead of per-session state.
bun add @orkid-labs/plugin-mempalace
# or
npm install @orkid-labs/plugin-mempalaceimport { mempalacePlugin } from '@orkid-labs/plugin-mempalace'
const character = {
// ...
plugins: [mempalacePlugin],
}Configuration
| Variable | Required | Description |
|---|---|---|
MEMPALACE_MCP_URL | One of the two | URL of a running MemPalace MCP server (HTTP transport — takes precedence) |
MEMPALACE_MCP_CMD | One of the two | Command to spawn the MemPalace MCP server over stdio, e.g. mempalace-mcp |
MEMPALACE_DIR | No | MemPalace data directory for the stdio server |
Actions and provider
| Action | Description |
|---|---|
STORE_PALACE_MEMORY | Store a memory into the palace |
RECALL_PALACE_MEMORY | Search and recall stored memories |
CALL_MEMPALACE_TOOL | Invoke an arbitrary MemPalace MCP tool |
MEMPALACE_CONTEXT | Provider — injects relevant stored context into agent state |
Do not store secrets, credentials, or API keys in MemPalace.