Config - FixClaw | OpenClaw 故障排除知识库

[Webchat因delivery-mirror转录条目重复显示助手回复] - Webchat Duplicate Assistant Replies via delivery-mirror Transcript Entry

[OpenClaw 4.5 notifyActiveTaskWaiters TypeError 导致 Discord 网关崩溃] - OpenClaw 4.5 notifyActiveTaskWaiters TypeError crashes Discord gateway

[升级v2026.4.14后专用网络音频转录SSRF拦截错误] - SSRF Block on Private Network Audio Transcription After v2026.4.14 Upgrade

[模型回退重试时原始用户提示被丢弃] - resolveFallbackRetryPrompt Discards Original User Prompt on Model Fallback Retry

Telegram群组斜杠命令升级后失效 - Telegram Group Slash Commands Stop Working After OpenClaw 2026.4.12 → 2026.4.14 Upgrade

[原生 Discord /status 命令显示 'discord/undefined' 且活动频道会话无活动] - Discord Native /status Reports 'discord/undefined' and No Activity for Active Channel Sessions

[MCP插件初始化超时：硬编码30秒导致握手失败] - MCP Plugin Initialize Timeout: Hardcoded 30s Causes Handshake Failure

认证模式静默从OAuth切换至API密钥 - Auth Mode Silently Switched from OAuth to API Key

[关联遍历、显著性加权与基于访问的遗忘] - Memory v2 Enhancement Guide: Associative Traversal, Salience Weighting, and Access-Based Forgetting

[BOOTSTRAP.md 会话重启时覆盖智能体身份] - BOOTSTRAP.md Overwrites Agent Identity on Session Restart

[功能请求：为 sessions_send 添加事件钩子以确保交接可见性] - Feature Request: sessions_send Event Hook for Guaranteed Handoff Visibility

[Google Vertex AI子代理身份验证失败，显示'未找到API密钥'错误] - Google Vertex AI Sub-Agent Authentication Fails with 'No API Key Found' Error

[飞书频道WebSocket模式client.on方法错误] - Feishu Channel WebSocket Mode: client.on is not a function

[Discord 线程绑定子代理生成失败] - Thread-Bound Subagent Spawns Fail with 'no_active_run' on Discord

Discord REST API在代理环境下失败但WebSocket正常 - Discord REST API Fails with Proxy Despite WebSocket Success

[当心跳运行产生 HEARTBEAT_OK 时引导用户消息被吞没] - Steered User Message Swallowed When Heartbeat Run Produces HEARTBEAT_OK

[Bonjour内部看门狗在systemd管理下触发无限网关重启循环] - Bonjour Internal Watchdog Triggers Infinite Gateway Restart Loop Under systemd Management

[图片工具返回 401 无效 Bearer 令牌错误] - Image Tool Returns 401 Invalid Bearer Token Error with Anthropic API

[编码代理技能通知因默认heartbeat.target配置被静默丢弃] - Coding-Agent Skill Notifications Silently Dropped Due to Default heartbeat.target Configuration

[支持云网关BYOK（自带密钥）] - Support BYOK (Bring Your Own Key) for Cloud Gateways

[云网关支持自带密钥] - Support BYOK (Bring Your Own Key) for Cloud Gateways

[为Discord频道配置公会作用域会话] - Implementing Guild-Scoped Sessions for Discord Channels

[Linux系统上不同cacheRetention配置导致提供商冷却] - Model Definitions with CacheRetention Cause Provider Cooldown on Linux

[Google Gemini提供商429速率限制错误] - Google Gemini Provider: 429 Rate Limit Scopes to Entire Provider Instead of Specific Model

消息工具调用延迟至回合结束才发送 - Message Tool Calls Batched Until Turn End Instead of Delivered Immediately

[WhatsApp发信失败与允许名单策略] - WhatsApp Outbound Send Failure with Allowlist Policy

[超时导致的认证轮换过早触发提供商回退] - Timeout-Driven Auth Rotation Prematurely Triggers Provider Fallback

[macOS 浏览器无法通过 Docker 网关访问仪表板] - Dashboard Inaccessible from macOS Browser with Docker Gateway

[Telegram 命令无法在启动时注册] - Telegram: commands.native Not Registering setMyCommands at Startup

[主动内存超时：阻塞召回传递超过配置超时] - Active Memory Timeout: Blocking Recall Pass Exceeds Configured Timeout

[计费冷却跳过路径绕过isBillingErrorMessage()导致显示通用错误而非计费消息] - Billing Cooldown Skip Path Bypasses isBillingErrorMessage() — Generic Error Shown Instead of Billing Message

[沙盒代理无法访问浏览器 CDP] - Sandboxed Agent Cannot Reach Browser CDP — 127.0.0.1 Hardcoded in ensureSandboxBrowser

[运行时文件缺失导致子代理任务静默排队] - subagent-registry.runtime.js Missing from dist — Subagent Tasks Silently Remain Queued

[WhatsApp自动回复内联MEDIA:/path无法传递媒体] - WhatsApp Auto-Reply Inline MEDIA:/path Fails to Deliver Media

[Ollama 提供程序注册回归导致内存嵌入初始化失败] - Unknown memory embedding provider: ollama — Regression in v2026.4.x

[添加 maxMessageAge 过滤器以丢弃过期的重新投递的 BlueBubbles Webhook] - Adding maxMessageAge Filter to Drop Stale Re-delivered BlueBubbles Webhooks

[Slack 插件使用 SecretRef 令牌时加载失败] - Slack Plugin Fails to Load with SecretRef Tokens: PluginLoadFailureError in agents Commands

CLI内存命令崩溃，未知内存嵌入提供程序ollama - CLI Memory Commands Crash with 'Unknown memory embedding provider: ollama'

[openclaw status 在文件支持的 SecretRef 配置上因插件加载重新读取未解析的原始配置而失败] - openclaw status Fails on File-Backed SecretRef Configs Due to Plugin Loading Re-Reading Unresolved Raw Config

[Ollama API 超时固定为 60 秒，尽管配置了 timeoutSeconds] - Ollama API Timeout Fixed at 60 Seconds Despite timeoutSeconds Configuration

[Firecrawl SecretRef 环境密钥在密钥重载后仍未解决] - Firecrawl SecretRef Environment Key Unresolved After Secrets Reload

[图像工具对配置的Ollama模型返回“未知模型”错误] - image Tool Returns 'Unknown Model' for Configured Ollama Models with Image Input

[x_search 在标准 xAI 认证路径上因未解析的 SecretRef 而失败] - x_search Fails with Unresolved SecretRef on Canonical xAI Auth Path

[Firecrawl API 密钥 SecretRef 返回 401 未授权错误] - Firecrawl API Key SecretRef Returns 401 Unauthorized Despite Resolved Config Status

[通过Azure OpenAI Responses适配器使用gpt-5.2-codex/gpt-5.3-chat时出现HTTP 400错误] - HTTP 400 Errors with gpt-5.2-codex/gpt-5.3-chat via Azure OpenAI Responses Adapter

[Ollama LLM 超时不遵循配置的 timeoutSeconds] - Ollama LLM Timeout Not Honoring Configured timeoutSeconds

[sessions_spawn生成隔离逻辑代理时出现配对必需错误] - sessions_spawn fails with 'pairing required (1008)' when spawning isolated logic agents

[配置环境代理时内存搜索远程嵌入失败并报ENOTFOUND错误] - Memory Search Remote Embeddings Fail with ENOTFOUND When Environment Proxy is Configured

[仪表板模型下拉菜单显示未配置提供商的模型] - Dashboard Model Dropdown Displays Models from Unconfigured Providers

[升级至 v2026.4.12 后 Ollama 提供商不可用] - Ollama Provider Unavailable After Upgrade to v2026.4.12: 'No API provider registered for api: ollama'

[Telegram 媒体下载在 v2026.4.8 升级后通过 HTTP 代理失败] - Telegram Media Download Fails Through HTTP Proxy After v2026.4.8 Upgrade

[Agent SOUL.md 违规：过早请求数据和 requireMention 功能幻觉] - Agent SOUL.md Violations: Premature Data Requests and requireMention Hallucination

[硬编码5MB媒体存储限制在通道限制生效前阻止生成的媒体] - Hardcoded 5MB Media Store Limit Blocks Generated Media Before Channel Limits Apply

openclaw approvals get --gateway 命令因默认超时导致错误报告配置不可用 - openclaw approvals get --gateway Falsely Reports 'Config unavailable' Due to Default Timeout