下面是一套在本地调试这个插件的实用流程（已给项目加了 npm run dev，用 tsdown 监听源码并自动重新打包）。

1. 让 OpenClaw 加载你本地的包

任选其一：

A. npm link（适合反复改插件）

cd /Users/jyxc-dz-0100248/Desktop/dev/openclaw-stepfun-service
npm link
# 在装 openclaw 的目录（或你的测试项目）里：
npm link openclaw-stepfun-service

B. 配置里写本地路径（不改 node_modules）

在 OpenClaw 配置里增加 plugins.load.paths，指向插件根目录（含 package.json 和构建后的 index.mjs），例如：

{
  "plugins": {
    "load": {
      "paths": ["/Users/jyxc-dz-0100248/Desktop/dev/openclaw-stepfun-service"]
    },
    "entries": {
      "openclaw-stepfun-service": {
        "enabled": true,
        "config": { "port": 18790, "host": "127.0.0.1" }
      }
    }
  }
}

改完配置后执行 openclaw gateway restart（或停再起 gateway）。

2. 一边改代码一边编译

在项目目录开终端：

npm run dev

保存 index.ts / src/*.ts 时会自动重新生成 index.mjs。
若你用的是 link 或 paths，gateway 进程会在下次加载时读到新文件；改插件代码后需要重启 gateway 才会重新 import 插件（Node 会缓存模块）。

3. 用断点调试（Node Inspector）

启动 gateway 时挂上调试端口，例如：

NODE_OPTIONS='--inspect=9229' openclaw gateway

在 Cursor / VS Code：Run and Debug → Attach to Node Process，端口填 9229；在 index.ts / src/http/server.ts 或 src/router/ 里下断点（需有 source map 或映射到 TS；若只停在打包后的 index.mjs 也可）。

也可用 --inspect-brk 在入口就停住，便于看启动路径。

4. 验证 HTTP 与日志

Gateway 起来后：

curl -s http://127.0.0.1:18790/health
curl -s http://127.0.0.1:18790/api/hello

看 gateway.log（一般在 ~/.openclaw/logs/gateway.log）里是否有 [stepfun-service] 相关日志。

5. 常见问题

| 现象 | 处理 | |------|------| | 改了代码没生效 | 确认 npm run dev 已生成新 index.mjs，并 重启 gateway | | 端口占用 | 改 plugins.entries...config.port 或环境变量 OPENCLAW_STEPFUN_SERVICE_PORT | | 插件未加载 | openclaw doctor 看插件/路径；检查 entries 里 enabled: true 与 load.paths |

如果你希望「只重启插件、不整网关」，OpenClaw 默认没有单独热重载插件，重启 gateway 是最稳的调试方式。