openclaw-stepfun 0.2.2

package/dist/src/websocket/stream.js

@@ -0,0 +1,24 @@
+export const stream = (method, payload) => {
+    // const createRequest = () => { }
+    // const request = method(payload, {
+    // })
+    const callbacks = {};
+    return {
+        start(cb) {
+            callbacks.onStart = cb;
+            return this;
+        },
+        on(cb) {
+            callbacks.onData = cb;
+            return this;
+        },
+        do() {
+            return method(payload, callbacks, false);
+        },
+        error(cb) {
+            callbacks.onError = cb;
+            return this;
+        },
+    };
+};
+//# sourceMappingURL=stream.js.map

package/dist/src/websocket/streamConnect.d.ts

@@ -0,0 +1,40 @@
+import { MethodKind } from "@bufbuild/protobuf";
+import { Empty } from "@bufbuild/protobuf";
+import { AuthBindReq, AuthBindRes, ErrorRes, HeartbeatReq, HeartbeatRes, LogoutReq, StreamMsg } from "../proto/capy/botway/stream_pb.js";
+/**
+ * @generated from service step.raccoon.gateway.Stream
+ */
+export declare const Stream: {
+    typeName: string;
+    methods: {
+        auth: {
+            name: string;
+            I: typeof AuthBindReq;
+            O: typeof AuthBindRes;
+            kind: MethodKind;
+        };
+        logout: {
+            name: string;
+            I: typeof LogoutReq;
+            O: typeof Empty;
+            kind: MethodKind;
+        };
+        heartbeat: {
+            name: string;
+            I: typeof HeartbeatReq;
+            O: typeof HeartbeatRes;
+            kind: MethodKind;
+        };
+        /**
+         * @generated from rpc step.raccoon.gateway.Stream.Process
+         */
+        process: {
+            name: string;
+            I: typeof StreamMsg;
+            O: typeof StreamMsg;
+            kind: MethodKind;
+        };
+    };
+};
+export { ErrorRes, StreamMsg, AuthBindReq, AuthBindRes, HeartbeatReq, HeartbeatRes, LogoutReq, };
+//# sourceMappingURL=streamConnect.d.ts.map

package/dist/src/websocket/streamConnect.js

@@ -0,0 +1,48 @@
+import { MethodKind } from "@bufbuild/protobuf";
+import { Empty } from "@bufbuild/protobuf";
+import { AuthBindReq, AuthBindRes, ErrorRes, HeartbeatReq, HeartbeatRes, LogoutReq, StreamMsg, } from "../proto/capy/botway/stream_pb.js";
+/**
+ * @generated from service step.raccoon.gateway.Stream
+ */
+export const Stream = {
+    typeName: "step.capy.botway.Stream",
+    methods: {
+        auth: {
+            name: "Auth",
+            // biome-ignore lint/style/useNamingConvention: <explanation>
+            I: AuthBindReq,
+            // biome-ignore lint/style/useNamingConvention: <explanation>
+            O: AuthBindRes,
+            kind: MethodKind.Unary,
+        },
+        logout: {
+            name: "Logout",
+            // biome-ignore lint/style/useNamingConvention: <explanation>
+            I: LogoutReq,
+            // biome-ignore lint/style/useNamingConvention: <explanation>
+            O: Empty,
+            kind: MethodKind.Unary,
+        },
+        heartbeat: {
+            name: "Heartbeat",
+            // biome-ignore lint/style/useNamingConvention: <explanation>
+            I: HeartbeatReq,
+            // biome-ignore lint/style/useNamingConvention: <explanation>
+            O: HeartbeatRes,
+            kind: MethodKind.Unary,
+        },
+        /**
+         * @generated from rpc step.raccoon.gateway.Stream.Process
+         */
+        process: {
+            name: "Process",
+            // biome-ignore lint/style/useNamingConvention: <explanation>
+            I: StreamMsg,
+            // biome-ignore lint/style/useNamingConvention: <explanation>
+            O: StreamMsg,
+            kind: MethodKind.BiDiStreaming,
+        },
+    },
+};
+export { ErrorRes, StreamMsg, AuthBindReq, AuthBindRes, HeartbeatReq, HeartbeatRes, LogoutReq, };
+//# sourceMappingURL=streamConnect.js.map

package/openclaw.plugin.json

@@ -0,0 +1,23 @@
+{
+  "id": "openclaw-stepfun",
+  "channels": ["stepfun"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "enabled": {
+        "type": "boolean",
+        "description": "Enable Stepfun channel",
+        "default": false
+      },
+      "appId": {
+        "type": "string",
+        "description": "App ID for bot authentication"
+      },
+      "appToken": {
+        "type": "string",
+        "description": "App token for WebSocket connection authentication"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "openclaw-stepfun",
+  "version": "0.2.2",
+  "description": "OpenClaw Stepfun WebSocket gateway channel plugin",
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "stepfun",
+    "websocket",
+    "gateway",
+    "channel"
+  ],
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "scripts/setup.mjs",
+    "scripts/switch-env.mjs",
+    "openclaw.plugin.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "switch:env:dev": "node scripts/switch-env.mjs dev",
+    "switch:env:publish": "node scripts/switch-env.mjs publish"
+  },
+  "dependencies": {
+    "@bufbuild/protobuf": "1.7.2",
+    "@connectrpc/connect": "1.4.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.13",
+    "typescript": "^5.3.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "channel": {
+      "id": "stepfun",
+      "label": "OpenClaw Stepfun",
+      "selectionLabel": "OpenClaw Stepfun Gateway",
+      "docsPath": "/channels/openclaw-stepfun",
+      "docsLabel": "openclaw-stepfun",
+      "blurb": "Stepfun WebSocket gateway integration.",
+      "aliases": [],
+      "order": 80
+    },
+    "install": {
+      "npmSpec": "@openclaw/openclaw-stepfun",
+      "localPath": "extensions/openclaw-stepfun",
+      "defaultChoice": "local"
+    }
+  }
+}

package/scripts/setup.mjs

@@ -0,0 +1,381 @@
+#!/usr/bin/env node
+/**
+ * OpenClaw Stepfun Plugin 安装配置脚本
+ * 在插件安装时交互式获取 appId、appToken
+ * 并自动配置 provider 和模型
+ */
+
+import * as readline from "readline";
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+
+// OpenClaw 配置文件路径
+const OPENCLAW_CONFIG_DIR = join(homedir(), ".openclaw");
+const OPENCLAW_CONFIG_FILE = join(OPENCLAW_CONFIG_DIR, "openclaw.json");
+
+// 平台配置
+const PLATFORMS = {
+  openrouter: {
+    name: "OpenRouter (限时免费)",
+    description: "通过 OpenRouter 接入，目前限时免费使用",
+    model: "openrouter/stepfun/step-3.5-flash:free",
+  },
+  stepfun: {
+    name: "StepFun 官方平台",
+    description: "直接使用 StepFun 官方 API",
+    model: "stepfun/step-3.5-flash",
+    // StepFun 自定义 provider 配置
+    provider: {
+      baseUrl: "https://api.stepfun.com/v1",
+      auth: "api-key",
+      api: "openai-completions"
+    },
+  },
+};
+
+/**
+ * 异步提问
+ */
+function question(prompt) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  return new Promise((resolve) => {
+    rl.question(prompt, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+/**
+ * 隐藏输入的提问（用于敏感信息）
+ */
+function questionHidden(prompt) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+
+    // 保存原始的 _writeToOutput
+    const originalWrite = rl._writeToOutput;
+
+    rl._writeToOutput = function (str) {
+      // 只显示 prompt，隐藏用户输入
+      if (str === prompt) {
+        originalWrite.call(rl, str);
+      } else if (str.includes("\n") || str.includes("\r")) {
+        // 回车时换行
+        originalWrite.call(rl, "\n");
+      } else {
+        // 用 * 替代输入字符
+        originalWrite.call(rl, "*");
+      }
+    };
+
+    rl.question(prompt, (answer) => {
+      rl._writeToOutput = originalWrite;
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+/**
+ * 读取现有配置
+ */
+function loadConfig() {
+  try {
+    if (existsSync(OPENCLAW_CONFIG_FILE)) {
+      const content = readFileSync(OPENCLAW_CONFIG_FILE, "utf-8");
+      return JSON.parse(content);
+    }
+  } catch (err) {
+    console.warn("⚠️  无法读取现有配置:", err.message);
+  }
+  return {};
+}
+
+/**
+ * 保存配置
+ */
+function saveConfig(config) {
+  try {
+    // 确保配置目录存在
+    if (!existsSync(OPENCLAW_CONFIG_DIR)) {
+      mkdirSync(OPENCLAW_CONFIG_DIR, { recursive: true });
+    }
+
+    writeFileSync(OPENCLAW_CONFIG_FILE, JSON.stringify(config, null, 2), "utf-8");
+    return true;
+  } catch (err) {
+    console.error("✗ 保存配置失败:", err.message);
+    return false;
+  }
+}
+
+/**
+ * 配置环境变量（仅 OpenRouter 需要）
+ */
+function configureEnv(config, platform, apiKey) {
+  if (platform === "openrouter") {
+    if (!config.env) {
+      config.env = {};
+    }
+    config.env.OPENROUTER_API_KEY = apiKey;
+  }
+  return config;
+}
+
+/**
+ * 配置 Provider（写入顶层 models.providers）
+ */
+function configureProvider(config, platform, apiKey) {
+  // 初始化 models 对象
+  if (!config.models) {
+    config.models = {};
+  }
+  if (!config.models.providers) {
+    config.models.providers = {};
+  }
+
+  // 设置 merge 模式
+  config.models.mode = "merge";
+
+  if (platform === "stepfun") {
+    // StepFun: 将 provider 配置写入 models.providers.stepfun
+    const platformConfig = PLATFORMS[platform];
+    config.models.providers.stepfun = {
+      ...platformConfig.provider,
+      apiKey,
+      "models": [
+          {
+            "id": "step-3.5-flash",
+            "name": "Step 3.5 Flash",
+            "contextWindow": 256000,
+            "maxTokens": 8192,
+            "reasoning": true,
+            "input": [
+              "text"
+            ],
+            "cost": {
+              "input": 0,
+              "output": 0,
+              "cacheRead": 0,
+              "cacheWrite": 0
+            }
+          }
+        ]
+    };
+  }
+  // OpenRouter 使用内置 provider，不需要额外配置
+
+  return config;
+}
+
+/**
+ * 配置模型
+ */
+function configureModel(config, platform) {
+  const platformConfig = PLATFORMS[platform];
+  const modelId = platformConfig.model;
+
+  // 初始化 agents.defaults 对象
+  if (!config.agents) {
+    config.agents = {};
+  }
+  if (!config.agents.defaults) {
+    config.agents.defaults = {};
+  }
+
+  // 设置主模型
+  if (!config.agents.defaults.model) {
+    config.agents.defaults.model = {};
+  }
+  config.agents.defaults.model.primary = modelId;
+
+  // 添加模型到可用模型列表
+  if (!config.agents.defaults.models) {
+    config.agents.defaults.models = {};
+  }
+
+  // 只设置简单的模型配置（可选添加 alias）
+  config.agents.defaults.models[modelId] = {};
+
+  return config;
+}
+
+/**
+ * 配置插件
+ */
+function configurePlugin(config, enabled) {
+  // 初始化 plugins.entries 对象
+  if (!config.plugins) {
+    config.plugins = {};
+  }
+  if (!config.plugins.entries) {
+    config.plugins.entries = {};
+  }
+
+  config.plugins.entries.stepfun = {
+    enabled,
+  };
+
+  return config;
+}
+
+/**
+ * 配置渠道
+ */
+function configureChannel(config, platform, appId, appToken, enabled) {
+  // 初始化 channels 对象
+  if (!config.channels) {
+    config.channels = {};
+  }
+
+  const existingStepfun = config.channels.stepfun || {};
+
+  config.channels.stepfun = {
+    ...existingStepfun,
+    platform,
+    appId,
+    appToken,
+    enabled,
+  };
+
+  return config;
+}
+
+/**
+ * 主函数
+ */
+async function main() {
+  console.log("\n╭─────────────────────────────────────────╮");
+  console.log("│   OpenClaw Stepfun Plugin 配置向导     │");
+  console.log("╰─────────────────────────────────────────╯\n");
+
+  // 检查是否在 TTY 环境中（交互式终端）
+  if (!process.stdin.isTTY) {
+    console.log("⚠️  非交互式环境，跳过配置向导");
+    console.log("   请手动编辑配置文件:", OPENCLAW_CONFIG_FILE);
+    console.log("   或运行: npm run setup\n");
+    process.exit(0);
+  }
+
+  try {
+    // 加载现有配置
+    let config = loadConfig();
+    const existingStepfun = config.channels?.stepfun || {};
+
+    // 显示当前配置状态
+    if (existingStepfun.appId) {
+      console.log("📋 检测到现有配置:");
+      console.log(`   平台: ${existingStepfun.platform === "stepfun" ? "StepFun 官方" : "OpenRouter"}`);
+      console.log(`   App ID: ${existingStepfun.appId}`);
+      console.log(`   App Token: ${existingStepfun.appToken ? "******(已设置)" : "(未设置)"}`);
+      console.log("");
+
+      const overwrite = await question("是否覆盖现有配置? (y/N): ");
+      if (overwrite.toLowerCase() !== "y") {
+        console.log("\n✓ 保留现有配置\n");
+        process.exit(0);
+      }
+      console.log("");
+    }
+
+    // 选择平台
+    console.log("请选择接入平台:\n");
+    console.log("  [1] OpenRouter (限时免费)");
+    console.log("      通过 OpenRouter 接入，目前限时免费使用\n");
+    console.log("  [2] StepFun 官方平台");
+    console.log("      直接使用 StepFun 官方 API\n");
+
+    const platformChoice = await question("请输入选项 (1/2) [默认: 1]: ");
+    const platform = platformChoice === "2" ? "stepfun" : "openrouter";
+    const platformConfig = PLATFORMS[platform];
+
+    console.log(`\n✓ 已选择: ${platformConfig.name}\n`);
+
+    // 获取 API Key（选择平台后立即填入）
+    const apiKeyPrompt = platform === "openrouter"
+      ? "请输入 OpenRouter API Key: "
+      : "请输入 StepFun API Key: ";
+    const apiKey = await questionHidden(apiKeyPrompt);
+    if (!apiKey) {
+      console.log("\n✗ API Key 不能为空\n");
+      process.exit(1);
+    }
+    console.log("✓ API Key 已设置\n");
+
+    // 获取网关配置信息
+    console.log("请输入网关应用配置信息:\n");
+
+    // 获取 appId
+    const appId = await question("App ID: ");
+    if (!appId) {
+      console.log("\n✗ App ID 不能为空\n");
+      process.exit(1);
+    }
+
+    // 获取 appToken（隐藏输入）
+    const appToken = await questionHidden("App Token: ");
+    if (!appToken) {
+      console.log("\n✗ App Token 不能为空\n");
+      process.exit(1);
+    }
+
+    // 询问是否启用
+    const enableStr = await question("是否立即启用此渠道? (Y/n): ");
+    const enabled = enableStr.toLowerCase() !== "n";
+
+    // 应用所有配置
+    console.log("\n正在配置...");
+
+    // 1. 配置 Provider（写入 models.providers）
+    config = configureProvider(config, platform, apiKey);
+    console.log("  ✓ Provider 配置完成");
+
+    // 2. 配置模型
+    config = configureModel(config, platform);
+    console.log(`  ✓ 模型已设置为: ${platformConfig.model}`);
+
+    // 3. 配置环境变量（仅 OpenRouter 需要）
+    config = configureEnv(config, platform, apiKey);
+    console.log("  ✓ 环境变量配置完成");
+
+    // 4. 配置插件
+    config = configurePlugin(config, enabled);
+    console.log("  ✓ 插件配置完成");
+
+    // 5. 配置渠道
+    config = configureChannel(config, platform, appId, appToken, enabled);
+    console.log("  ✓ 渠道配置完成");
+
+    // 保存配置
+    if (saveConfig(config)) {
+      console.log("\n╭─────────────────────────────────────────╮");
+      console.log("│           ✓ 配置保存成功!               │");
+      console.log("╰─────────────────────────────────────────╯");
+      console.log(`\n📁 配置文件: ${OPENCLAW_CONFIG_FILE}`);
+      console.log(`🤖 主模型: ${platformConfig.model}`);
+      console.log(`🔌 渠道状态: ${enabled ? "已启用" : "未启用"}`);
+      console.log("\n使用以下命令启动 OpenClaw:");
+      console.log("   openclaw start\n");
+    } else {
+      process.exit(1);
+    }
+  } catch (err) {
+    console.error("\n✗ 配置失败:", err.message);
+    process.exit(1);
+  }
+}
+
+// 运行主函数
+main().catch((err) => {
+  console.error("✗ 发生错误:", err);
+  process.exit(1);
+});

package/scripts/switch-env.mjs

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+/**
+ * 切换开发和发布环境配置
+ * Usage: node switch-env.mjs [dev|publish]
+ */
+
+import { copyFileSync, existsSync, rmSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const rootDir = join(__dirname, "..");
+
+const env = process.argv[2];
+
+if (!env || (env !== "dev" && env !== "publish")) {
+  console.error("Usage: node switch-env.mjs [dev|publish]");
+  process.exit(1);
+}
+
+const isDev = env === "dev";
+
+console.log(`Switching to ${env} environment...`);
+
+// 1. 切换 package.json
+const sourcePackage = join(rootDir, `package.${env}.json`);
+const targetPackage = join(rootDir, "package.json");
+
+if (!existsSync(sourcePackage)) {
+  console.error(`Error: ${sourcePackage} not found`);
+  process.exit(1);
+}
+
+copyFileSync(sourcePackage, targetPackage);
+console.log(`✓ package.json → ${isDev ? "dev" : "publish"} mode`);
+
+// 2. 切换 tsconfig.json
+const sourceTsConfig = join(rootDir, `tsconfig.${env}.json`);
+const targetTsConfig = join(rootDir, "tsconfig.json");
+
+if (!existsSync(sourceTsConfig)) {
+  console.error(`Error: ${sourceTsConfig} not found`);
+  process.exit(1);
+}
+
+copyFileSync(sourceTsConfig, targetTsConfig);
+console.log(`✓ tsconfig.json → ${isDev ? "dev" : "publish"} mode`);
+
+// 3. 处理 pnpmfile（开发环境需要跳过 openclaw 依赖解析）
+const pnpmfile = join(rootDir, ".pnpmfile.cjs");
+const pnpmfileBackup = join(rootDir, ".pnpmfile.cjs.bak");
+
+if (isDev) {
+  // 开发模式：启用 pnpmfile
+  if (existsSync(pnpmfileBackup)) {
+    copyFileSync(pnpmfileBackup, pnpmfile);
+    console.log("✓ Enabled pnpmfile (skip openclaw dependency resolution)");
+  }
+} else {
+  // 发布模式：禁用 pnpmfile
+  if (existsSync(pnpmfile)) {
+    copyFileSync(pnpmfile, pnpmfileBackup);
+    rmSync(pnpmfile);
+    console.log("✓ Disabled pnpmfile for publish");
+  }
+}
+
+// 4. 处理类型存根文件
+const stubFile = join(rootDir, "src", "types", "openclaw-stub.d.ts");
+const stubBackup = join(rootDir, "src", "types", "openclaw-stub.d.ts.bak");
+
+if (isDev) {
+  // 开发模式：禁用类型存根（重命名为备份）
+  if (existsSync(stubFile)) {
+    copyFileSync(stubFile, stubBackup);
+    rmSync(stubFile);
+    console.log("✓ Disabled type stub (using actual openclaw types)");
+  }
+} else {
+  // 发布模式：启用类型存根
+  if (existsSync(stubBackup)) {
+    copyFileSync(stubBackup, stubFile);
+    console.log("✓ Enabled type stub for publish");
+  } else if (!existsSync(stubFile)) {
+    console.warn("⚠ Warning: Type stub file not found. Run 'pnpm run switch:env:publish' to generate it.");
+  }
+}
+
+console.log("\n✅ Environment switched successfully!");
+console.log(`\nNext steps:`);
+if (isDev) {
+  console.log("  1. Run 'pnpm install' to link local openclaw");
+  console.log("  2. Start development");
+} else {
+  console.log("  1. Run 'pnpm install' to clean up local dependencies");
+  console.log("  2. Run 'pnpm build' to verify everything works");
+  console.log("  3. Run 'pnpm publish' to publish to npm");
+}