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

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

[WebChat刷新导致内部系统/心跳条目泄露] - WebChat Refresh Leaks Internal System/Heartbeat Entries

[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

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

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

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

[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

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

[在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

[网关重启时Telegram setMyCommands未被调用] - Telegram setMyCommands Not Called on Gateway Restart in OpenClaw 2026.4.14

[主动内存超时：阻塞召回传递超过配置超时] - 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

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

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

[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

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

[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

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

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

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