Error - 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

[formatDocsLink函数在守护进程安装期间处理undefined路径参数时导致的属性读取错误] - TypeError: Cannot Read Properties of Undefined in formatDocsLink During Daemon Installation

[升级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

[OpenClaw 2026.4.14 安装程序频道选择步骤崩溃] - Installer Crash: TypeError on 'Select channel (QuickStart)' Step in OpenClaw 2026.4.14

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

[Discord斜杠命令返回'Done.'而非富数据] - Discord Slash Command Returns 'Done.' Instead of Rich Data

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

[Anthropic 529 重试后消息发送至错误话题] - Telegram Forum: Message Sent to Wrong Topic After Anthropic 529 Retry

认证模式静默从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

[OpenRouter/Qwen3流解析失败 — reasoning_details字段未处理] - OpenRouter/Qwen3 Stream Parsing Fails — reasoning_details Field Not Handled

[功能请求：为 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

[外部服务集成的速率限制与服务条款合规性] - Rate Limiting and Terms of Service Compliance for External Service Integrations

[空 Cron 任务名称字段导致控制 UI 无限渲染循环] - Control UI Infinite Render Loop on Empty Cron Job Name Field

[extractCostBreakdown() 类型不匹配导致成本显示 $0] - OpenRouter cost tracking returns $0 due to type mismatch in extractCostBreakdown()

[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

[消息丢失与重复传递修复] - Delivery Reliability — Silent Message Loss & Duplicate Delivery

[OpenClaw 升级期间 npm 安装失败] - npm Install Failure During OpenClaw Upgrade on macOS

[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

[OpenClaw 控制界面闲置后返回 HTTP 401] - Web UI Session Timeout: HTTP 401 After Inactivity in OpenClaw Control UI

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

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

[在Telegram执行审批消息中添加点击复制批准命令] - Adding Tap-to-Copy Approve Commands to Telegram Exec Approval Messages

[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

Discord 频道泄露内部载荷 - Discord Channel Leaking Internal Payloads: EXTERNAL_UNTRUSTED_CONTENT Wrappers in User Messages

[运行时文件缺失导致子代理任务静默排队] - 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

[未知内存嵌入提供程序：ollama] - Unknown memory embedding provider: ollama - Troubleshooting Guide

[ClawHub 作用域 npm 包安装失败并出现 ENOENT 错误] - Scoped npm Packages from ClawHub Fail to Install with ENOENT

[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

[空白注册表静默分支问题] - DevClaw Silently Forks Project Registry State by Creating Empty devclaw/projects.json

[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

[升级至 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

[OpenClaw 2026.3.2 在低内存系统上因内存不足导致安装失败] - OpenClaw 2026.3.2 Installation Fails with Out-of-Memory Error on Low-RAM Systems

[硬编码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