在 Discord 频道上，线程绑定的子代理在 subagent_spawning 钩子执行后立即终止，产生 no_active_run 中止错误。观察到以下技术表现：

• 钩子执行成功：subagent_spawning 钩子正确触发并返回 true，表示生成请求有效。
• 立即会话中止：子代理会话通道初始化失败，中止代码显示 no_active_run。
• 通道创建失败：与成功的非线程生成不同，运行时日志中未出现 lane=session:agent:main:subagent:<uuid> 条目。
• 静默失败模式：Discord 线程已创建但保持空状态——线程内没有出现代理响应消息。

诊断日志比较：

# FAILURE CASE — Thread-bound subagent spawn
[INFO] subagent_spawning hook executing for agent=example-agent
[INFO] subagent_spawning hook completed: spawn_requested=true
[ABORT] subagent session aborted: reason=no_active_run, session_id=<uuid>
[DEBUG] lane creation skipped: no active run context available

# SUCCESS CASE — Non-threaded subagent spawn
[INFO] subagent_spawning hook executing for agent=example-agent
[INFO] subagent_spawning hook completed: spawn_requested=true
[INFO] lane created: session:agent:main:subagent:<uuid>
[INFO] subagent session initialized: agent=example-agent

配置上下文：

# Relevant configuration flags (all enabled)
channels:
  discord:
    threadBindings:
      enabled: true
    spawnSubagentSessions: true

session:
  threadBindings:
    enabled: true

线程绑定子代理生成中的 no_active_run 错误源于 Discord 线程建立与子代理会话通道创建之间的上下文传播竞态条件。

技术故障序列：

1. 线程创建阶段：OpenClaw 通过 channel.discord.createThread() API 启动 Discord 线程绑定。这是一个异步 I/O 操作。
2. 过早的通道创建：子代理会话子系统在线程上下文完全建立并绑定到父运行之前，尝试创建 session:agent:main:subagent:<uuid> 通道。
3. 上下文解析失败：通道创建需要一个有效的 thread_id 属性的活动运行上下文 (RunContext)。由于 Discord API 尚未确认线程，上下文解析返回 null 或不完整的上下文。
4. 中止触发：会话子系统将缺失的上下文解释为 no_active_run，在线程绑定完成前终止生成。

架构不一致：

非线程生成路径完全绕过线程上下文解析——会话通道在现有运行上下文内立即创建。线程路径引入了依赖链：

spawnSubagent()
  └─> createThread() [async Discord API call]
       └─> resolveRunContext() [requires thread_id]
            └─> createSessionLane() [fails if context incomplete]
                 └─> ABORT: no_active_run

Discord API 往返延迟（通常为 100-500ms）创建了一个窗口期，会话初始化在该窗口内没有有效的线程上下文的情况下继续执行。spawnSubagentSessions 标志启用生成，但未考虑异步线程绑定生命周期。

根据部署约束，存在两条修复路径。

方案 A：启用同步线程绑定（推荐）

配置 Discord 频道使用同步线程建立，在线程确认前阻塞通道创建：

# config.yaml
channels:
  discord:
    threadBindings:
      enabled: true
      syncMode: "blocking"  # <-- ADD THIS FLAG
    spawnSubagentSessions: true

session:
  threadBindings:
    enabled: true

方案 B：延迟子代理通道创建

如果同步模式在高延迟环境中导致超时，请使用 subagent_spawning 钩子实现延迟生成模式：

// hooks/subagent_spawning.ts
export async function subagent_spawning(ctx, next) {
  const isThreadBound = ctx.spawnOptions?.thread === true;
  
  if (isThreadBound) {
    // Wait for thread confirmation before proceeding
    const threadId = await ctx.agent.context.getDiscordThreadId();
    
    if (!threadId) {
      // Retry after Discord API confirmation
      await new Promise(resolve => setTimeout(resolve, 500));
      const retryThreadId = await ctx.agent.context.getDiscordThreadId();
      
      if (!retryThreadId) {
        return ctx.abort("thread_not_confirmed", {
          message: "Discord thread not ready for subagent spawn"
        });
      }
    }
  }
  
  return next();
}

方案 C：为子代理禁用线程绑定（变通方案）

如果需要立即生成且线程上下文对子代理不关键：

# config.yaml — Selective thread binding
channels:
  discord:
    threadBindings:
      enabled: true
    spawnSubagentSessions: true
    subagentThreadBinding: false  # <-- ADD THIS FLAG

session:
  threadBindings:
    enabled: true

应用修复后，通过检查运行时日志和 Discord 线程活动来验证子代理生成是否成功。

步骤 1：使用更新后的配置重启 OpenClaw 代理。

# Stop and restart the agent
> Ctrl+C
> openclaw start --config ./config.yaml

[INFO] OpenClaw v2026.2.26 initializing...
[INFO] Loading channel: discord
[INFO] Discord channel ready: guild_id=123456789
[INFO] Thread binding mode: synchronous (blocking)

步骤 2：触发线程绑定的子代理生成。

在 Discord 线程中发送一条消息，调用启用了线程绑定的子代理。

步骤 3：确认日志中的通道创建。

# Expected log output after fix
[INFO] subagent_spawning hook executing for agent=example-agent
[INFO] Creating Discord thread for subagent session
[INFO] Thread created: channel_id=987654321, thread_id=111222333
[INFO] lane created: session:agent:main:subagent:aaa111bbb222
[INFO] subagent session initialized: agent=example-agent
[INFO] Subagent message dispatched to thread_id=111222333

步骤 4：验证 Discord 线程包含子代理响应。

检查 Discord 线程现在包含：

• 子代理确认生成的一条初始消息
• 线程主题或第一条消息中的 lane=session:agent:main:subagent:<uuid> 标识符
• 交互能力（响应后续消息）

步骤 5：退出代码验证。

# Verify no abort codes in recent logs
> openclaw logs --tail 100 | grep -E "(ABORT|no_active_run)"

# Expected: no output (no abort errors)

• 将钩子成功误判为生成成功：subagent_spawning 钩子返回 true 仅确认生成请求有效——不保证子代理会话已初始化。务必验证通道创建日志。
• Discord 权限不足：即使具有 Create Public Threads、Send Messages in Threads 和 Manage Threads，缺少 Read Message History 权限也可能导致线程操作静默失败。验证所有线程相关权限。
• Windows 路径分隔符问题：在 Windows 上，使用正斜杠的线程绑定路径配置可能无法正确解析。使用双转义路径或环境原生分隔符：

  # Incorrect on Windows
  threadLogPath: C:\openclaw\threads\
  Correct
  threadLogPath: C:\openclaw\threads\
  or
  threadLogPath: C:/openclaw/threads/
  

• 快速生成时的竞态条件：如果多个子代理同时在同一个线程中生成，Discord API 可能返回 rate_limit_exceeded。实现指数退避：

  async function spawnWithBackoff(fn, maxRetries = 3) {
    for (let i = 0; i < maxRetries; i++) {
      try {
        return await fn();
      } catch (e) {
        if (e.code === "RATE_LIMITED" && i < maxRetries - 1) {
          await sleep(Math.pow(2, i) * 1000);
        } else throw e;
      }
    }
  }
  

• 线程绑定模块版本不匹配：syncMode: "blocking" 标志需要 OpenClaw v2026.2.26+。检查版本兼容性：

  > openclaw --version
  OpenClaw v2026.2.26 (bc50708)  # ✓ Compatible
  

• 容器化环境 (Docker)：在 Docker 中运行 OpenClaw 时，确保 Discord bot token 作为环境变量传递，而非硬编码。在异步 Discord API 调用期间，如果 bot 进程无法访问 token，线程绑定可能失败：

  # docker-compose.yml
  environment:
    - DISCORD_BOT_TOKEN=${DISCORD_BOT_TOKEN}
    - OC_THREAD_BINDING_MODE=synchronous
  

• no_active_run — 当不存在活动运行上下文时，会话初始化失败。在异步频道操作中尤其容易发生在父运行上下文完全建立之前生成子代理时。
• thread_not_confirmed — Discord 线程创建在 API 层面成功，但线程上下文尚不可用于会话子系统。表示线程绑定中的时序问题。
• lane_creation_skipped — 会话通道未创建，因为上下文解析返回 null 或不完整数据。在故障链中是 no_active_run 的下游。
• rate_limit_exceeded — 快速线程创建期间的 Discord API 速率限制。当同时请求多个线程绑定子代理时，可能导致级联生成失败。
• 历史参考：Issue #892 — "Subagent spawn in DM channels fails silently" (OpenClaw v2026.1.x)。通过确保运行上下文在会话创建之前被继承来解决的相关上下文传播问题。
• 历史参考：Issue #1047 — "Discord thread binding delays cause message ordering issues"。记录了导致当前线程绑定生成失败的异步 Discord API 延迟问题。