docs(feishu): explain legacy dynamic agent cap

vincentkoc · vincentkoc · commit 8749c81acb5c · 2026-06-14T17:14:34.000+08:00
diff --git a/docs/channels/feishu.md b/docs/channels/feishu.md
@@ -417,6 +417,8 @@ This is essential for public bots where you want each user to have their own pri
 
 <Note>
 Dynamic bindings include the normalized Feishu `accountId`, so default and named accounts route each sender to the correct dynamic agent.
+
+If a named account created an unscoped dynamic agent on an older release, that legacy agent still counts toward `maxAgents`. Confirm that it is not used by the default account before removing it, or temporarily increase `maxAgents`; OpenClaw cannot safely infer which account owns ambiguous legacy state.
 </Note>
 
 ### Quick setup
diff --git a/extensions/feishu/src/dynamic-agent.ts b/extensions/feishu/src/dynamic-agent.ts
@@ -110,6 +110,8 @@ export async function maybeCreateDynamicAgent(params: {
   }
   const agentId = resolveDynamicAgentId(accountId, senderOpenId);
   const currentAgentExists = (currentCfg.agents?.list ?? []).some((agent) => agent.id === agentId);
+  // Legacy unscoped agents are indistinguishable from valid default-account state.
+  // Keep maxAgents as a hard cap instead of auto-rebinding or deleting ambiguous user data.
   if (!currentAgentExists && isAtDynamicAgentLimit(currentCfg, currentDynamicCfg)) {
     log(
       `feishu: maxAgents limit (${currentDynamicCfg.maxAgents}) reached, not creating agent for ${senderOpenId}`,

Original file line number	Diff line number	Diff line change
`@@ -110,6 +110,8 @@ export async function maybeCreateDynamicAgent(params: {`
`110`	`110`	`}`
`111`	`111`	`const agentId = resolveDynamicAgentId(accountId, senderOpenId);`
`112`	`112`	`const currentAgentExists = (currentCfg.agents?.list ?? []).some((agent) => agent.id === agentId);`
	`113`	`+ // Legacy unscoped agents are indistinguishable from valid default-account state.`
	`114`	`+ // Keep maxAgents as a hard cap instead of auto-rebinding or deleting ambiguous user data.`
`113`	`115`	`if (!currentAgentExists && isAtDynamicAgentLimit(currentCfg, currentDynamicCfg)) {`
`114`	`116`	`log(`
`115`	`117`	`feishu: maxAgents limit (${currentDynamicCfg.maxAgents}) reached, not creating agent for ${senderOpenId}`,