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

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

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

技能依赖自动检测与用户透明通知 - Skill Dependency Auto-Detection and User-Transparent Notifications

[模型回退重试时原始用户提示被丢弃] - 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

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

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

[OpenAI OAuth 登录需要 TTY] - OpenAI OAuth Login Requires TTY: Non-Interactive Authentication Failure

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

[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

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

[当心跳运行产生 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

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

[危险执行模块导致插件安装被拦截] - Plugin Installation Blocked: 'dangerous-exec' Critical Security Finding

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

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

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

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

[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

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

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

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

[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

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

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

[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