@rpalegacy/opencode 0.1.0

package/README.md

@@ -0,0 +1,91 @@
+# @rpalegacy/opencode
+
+OpenClaw provider package for [opencode](https://opencode.ai).
+
+Exposes Claude (claude-local) models — Claude Opus 4.6, Claude Sonnet 4.6, and Claude Haiku 4 — via the OpenClaw local proxy at `localhost:3456`.
+
+## Requirements
+
+- [OpenClaw](https://docs.openclaw.ai) running with `openclaw-claude-proxy` active
+- `OPENCLAW_API_KEY` environment variable set (get it from your OpenClaw config)
+- Node.js >= 18
+
+## Setup
+
+### 1. Install OpenClaw's Claude proxy
+
+```bash
+# Install the openclaw-claude-proxy if you haven't already
+npm install -g openclaw-claude-proxy
+openclaw-claude-proxy
+```
+
+The proxy runs at `http://localhost:3456` and handles OAuth with your Claude Pro subscription.
+
+### 2. Configure opencode
+
+Add to your `opencode.json`:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "openclaw": {
+      "npm": "@rpalegacy/opencode",
+      "env": ["OPENCLAW_API_KEY"]
+    }
+  }
+}
+```
+
+Or use the `/connect` command in opencode's TUI and enter:
+- **Provider ID**: `openclaw`
+- **Base URL**: `http://localhost:3456/v1`
+- **API Key**: `OPENCLAW_API_KEY` (or set the env var directly)
+
+### 3. Use it
+
+```bash
+# Set your API key
+export OPENCLAW_API_KEY="sk-ant-..."
+
+# Run opencode with the OpenClaw provider
+opencode --provider openclaw --model claude-opus-4-6
+
+# Or in opencode's TUI
+/models   # then select a Claude model
+```
+
+## Available Models
+
+| Model | Context | Reasoning | Tool Call | Vision | Cost |
+|-------|---------|-----------|-----------|--------|------|
+| Claude Opus 4.6 | 200K | ✅ | ✅ | ✅ | Free* |
+| Claude Sonnet 4.6 | 200K | ✅ | ✅ | ✅ | Free* |
+| Claude Haiku 4 | 200K | ✅ | ✅ | ✅ | Free* |
+
+*Free via your Claude Pro subscription through the local proxy.带宽
+
+## How it works
+
+`@rpalegacy/opencode` wraps the `@ai-sdk/openai-compatible` provider and configures it to point at OpenClaw's local proxy (`localhost:3456`). The proxy handles:
+
+- OAuth authentication with your Claude Pro account
+- Model routing (claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4)
+- API compatibility (converts between OpenAI-compatible and Anthropic APIs)
+
+## Troubleshooting
+
+**"Model not found" errors**
+- Make sure `openclaw-claude-proxy` is running
+- Verify `http://localhost:3456` is accessible
+- Check that `OPENCLAW_API_KEY` is set correctly
+
+**Authentication errors**
+- The proxy uses OAuth with your Claude Pro account
+- Make sure your Claude Pro subscription is active
+- Try restarting the proxy: `pkill -f openclaw-claude-proxy && openclaw-claude-proxy`
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @openclaw/opencode
+ *
+ * OpenClaw provider package for opencode.
+ * Exposes Claude (claude-local) models via the OpenClaw proxy at localhost:3456.
+ *
+ * Usage in opencode config (opencode.json):
+ * {
+ *   "provider": {
+ *     "openclaw": {
+ *       "npm": "@openclaw/opencode",
+ *       "env": ["OPENCLAW_API_KEY"]
+ *     }
+ *   }
+ * }
+ *
+ * Then run: OPENCLAW_API_KEY=<key> opencode --provider openclaw
+ */
+import { type OpenAICompatibleProviderSettings } from "@ai-sdk/openai-compatible";
+export interface OpenClawOptions extends Partial<OpenAICompatibleProviderSettings> {
+    /**
+     * Override the base URL for the OpenClaw proxy.
+     * Defaults to http://localhost:3456/v1
+     */
+    baseURL?: string;
+    /**
+     * Override the API key. Defaults to OPENCLAW_API_KEY env var.
+     */
+    apiKey?: string;
+}
+export interface OpenClawModel {
+    id: string;
+    name: string;
+    /** Context window size */
+    contextWindow: number;
+    /** Max output tokens (0 = unknown/unlimited) */
+    maxOutputTokens: number;
+    /** Supports reasoning (extended thinking) */
+    reasoning: boolean;
+    /** Supports tool calling */
+    toolCall: boolean;
+    /** Supports image input */
+    vision: boolean;
+    /** Input cost per 1M tokens (0 = free) */
+    inputCost: number;
+    /** Output cost per 1M tokens (0 = free) */
+    outputCost: number;
+}
+/**
+ * All OpenClaw models registered by this provider.
+ * Updated to reflect claude-local models from the RPAA-365 schema.
+ */
+export declare const OPENCLAW_MODELS: Record<string, OpenClawModel>;
+/**
+ * Provider ID used in opencode config.
+ */
+export declare const PROVIDER_ID = "openclaw";
+/**
+ * Provider display name.
+ */
+export declare const PROVIDER_NAME = "OpenClaw";
+/**
+ * Required environment variables.
+ */
+export declare const PROVIDER_ENV: string[];
+/**
+ * Default proxy base URL.
+ */
+export declare const DEFAULT_BASE_URL = "http://localhost:3456/v1";
+/**
+ * Create the OpenClaw provider for opencode.
+ *
+ * This function is the main export that opencode will call.
+ * opencode looks for an export starting with "create".
+ *
+ * @param name - Provider name (opencode passes the provider ID from config)
+ * @param options - Provider options from opencode config
+ */
+export declare function createOpenClaw(name?: string, options?: OpenClawOptions): import("@ai-sdk/openai-compatible").OpenAICompatibleProvider<string, string, string, string>;
+/**
+ * Alias for createOpenClaw — opencode uses the first export starting with "create".
+ */
+export declare const create: typeof createOpenClaw;
+/**
+ * Convenience: default export matches the opencode provider package convention.
+ */
+export default createOpenClaw;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAA0B,KAAK,gCAAgC,EAAE,MAAM,2BAA2B,CAAC;AAK1G,MAAM,WAAW,eAAgB,SAAQ,OAAO,CAAC,gCAAgC,CAAC;IAChF;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,4BAA4B;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,2BAA2B;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAkCzD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,aAAa,CAAC;AAEtC;;GAEG;AACH,eAAO,MAAM,aAAa,aAAa,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,YAAY,UAAuB,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,gBAAgB,6BAA6B,CAAC;AAE3D;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,IAAI,GAAE,MAAoB,EAC1B,OAAO,GAAE,eAAoB,gGAc9B;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,uBAAiB,CAAC;AAErC;;GAEG;AACH,eAAe,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,104 @@
+/**
+ * @openclaw/opencode
+ *
+ * OpenClaw provider package for opencode.
+ * Exposes Claude (claude-local) models via the OpenClaw proxy at localhost:3456.
+ *
+ * Usage in opencode config (opencode.json):
+ * {
+ *   "provider": {
+ *     "openclaw": {
+ *       "npm": "@openclaw/opencode",
+ *       "env": ["OPENCLAW_API_KEY"]
+ *     }
+ *   }
+ * }
+ *
+ * Then run: OPENCLAW_API_KEY=<key> opencode --provider openclaw
+ */
+import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
+/**
+ * All OpenClaw models registered by this provider.
+ * Updated to reflect claude-local models from the RPAA-365 schema.
+ */
+export const OPENCLAW_MODELS = {
+    "claude-opus-4-6": {
+        id: "claude-opus-4-6",
+        name: "Claude Opus 4.6",
+        contextWindow: 200000,
+        maxOutputTokens: 8192,
+        reasoning: true,
+        toolCall: true,
+        vision: true,
+        inputCost: 0, // free via claude-local proxy
+        outputCost: 0,
+    },
+    "claude-sonnet-4-6": {
+        id: "claude-sonnet-4-6",
+        name: "Claude Sonnet 4.6",
+        contextWindow: 200000,
+        maxOutputTokens: 8192,
+        reasoning: true,
+        toolCall: true,
+        vision: true,
+        inputCost: 0,
+        outputCost: 0,
+    },
+    "claude-haiku-4": {
+        id: "claude-haiku-4",
+        name: "Claude Haiku 4",
+        contextWindow: 200000,
+        maxOutputTokens: 8192,
+        reasoning: true,
+        toolCall: true,
+        vision: true,
+        inputCost: 0,
+        outputCost: 0,
+    },
+};
+/**
+ * Provider ID used in opencode config.
+ */
+export const PROVIDER_ID = "openclaw";
+/**
+ * Provider display name.
+ */
+export const PROVIDER_NAME = "OpenClaw";
+/**
+ * Required environment variables.
+ */
+export const PROVIDER_ENV = ["OPENCLAW_API_KEY"];
+/**
+ * Default proxy base URL.
+ */
+export const DEFAULT_BASE_URL = "http://localhost:3456/v1";
+/**
+ * Create the OpenClaw provider for opencode.
+ *
+ * This function is the main export that opencode will call.
+ * opencode looks for an export starting with "create".
+ *
+ * @param name - Provider name (opencode passes the provider ID from config)
+ * @param options - Provider options from opencode config
+ */
+export function createOpenClaw(name = PROVIDER_ID, options = {}) {
+    const baseURL = options.baseURL ?? DEFAULT_BASE_URL;
+    const apiKey = options.apiKey ?? process.env.OPENCLAW_API_KEY ?? "not-set";
+    const provider = createOpenAICompatible({
+        name,
+        baseURL,
+        apiKey,
+        // Pass through any additional options
+        ...options,
+    });
+    return provider;
+}
+/**
+ * Alias for createOpenClaw — opencode uses the first export starting with "create".
+ */
+export const create = createOpenClaw;
+/**
+ * Convenience: default export matches the opencode provider package convention.
+ */
+export default createOpenClaw;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,sBAAsB,EAAyC,MAAM,2BAA2B,CAAC;AAqC1G;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAkC;IAC5D,iBAAiB,EAAE;QACjB,EAAE,EAAE,iBAAiB;QACrB,IAAI,EAAE,iBAAiB;QACvB,aAAa,EAAE,MAAM;QACrB,eAAe,EAAE,IAAI;QACrB,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,CAAC,EAAE,8BAA8B;QAC5C,UAAU,EAAE,CAAC;KACd;IACD,mBAAmB,EAAE;QACnB,EAAE,EAAE,mBAAmB;QACvB,IAAI,EAAE,mBAAmB;QACzB,aAAa,EAAE,MAAM;QACrB,eAAe,EAAE,IAAI;QACrB,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;KACd;IACD,gBAAgB,EAAE;QAChB,EAAE,EAAE,gBAAgB;QACpB,IAAI,EAAE,gBAAgB;QACtB,aAAa,EAAE,MAAM;QACrB,eAAe,EAAE,IAAI;QACrB,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;KACd;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;AAExC;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAEjD;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AAE3D;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAe,WAAW,EAC1B,UAA2B,EAAE;IAE7B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,SAAS,CAAC;IAE3E,MAAM,QAAQ,GAAG,sBAAsB,CAAC;QACtC,IAAI;QACJ,OAAO;QACP,MAAM;QACN,sCAAsC;QACtC,GAAG,OAAO;KACX,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,cAAc,CAAC;AAErC;;GAEG;AACH,eAAe,cAAc,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@rpalegacy/opencode",
+  "version": "0.1.0",
+  "description": "OpenClaw provider for opencode — exposes Claude (claude-local) models via the OpenClaw proxy",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@ai-sdk/openai-compatible": "^1.0.0",
+    "ai": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "ai": "^3.0.0"
+  },
+  "keywords": [
+    "opencode",
+    "openclaw",
+    "claude",
+    "anthropic",
+    "ai-sdk"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MIT"
+}