OpenClaw 错误信息与故障排除场景汇总

本文档汇总了 OpenClaw 本地安装目录中可能遇到的错误信息、警告、故障排除场景、配置错误示例、日志中的常见错误签名以及各模块的已知问题。

目录

1. 错误代码与错误信息
2. 故障排除场景
3. 配置错误示例
4. 日志中的常见错误签名
5. 各模块的已知问题

---

1. 错误代码与错误信息

1.1 认证与授权错误

错误代码	错误信息	描述	解决方案
AUTH_TOKEN_MISSING	Client did not send a required shared token	客户端未发送必需的共享令牌	在客户端粘贴/设置令牌后重试
AUTH_TOKEN_MISMATCH	Shared token did not match gateway auth token	共享令牌与网关认证令牌不匹配	如果 canRetryWithDeviceToken=true，允许一次可信重试；否则运行令牌漂移恢复检查清单
AUTH_DEVICE_TOKEN_MISMATCH	Cached per-device token is stale or revoked	缓存的每设备令牌已过期或已撤销	使用 devices CLI 轮换/重新批准设备令牌，然后重新连接
PAIRING_REQUIRED	Device identity is known but not approved for this role	设备身份已知但未批准此角色	批准待处理请求：openclaw devices list 然后 openclaw devices approve <requestId>
DEVICE_AUTH_NONCE_REQUIRED	device nonce required	客户端省略了 device.nonce	等待 connect.challenge 后发送带 nonce 的签名
DEVICE_AUTH_NONCE_MISMATCH	device nonce mismatch	客户端使用了过期/错误的 nonce 签名	使用服务器提供的当前 challenge nonce 签名
DEVICE_AUTH_SIGNATURE_INVALID	device signature invalid	签名负载与 v2 负载不匹配	确保签名包含正确的 challenge nonce
DEVICE_AUTH_SIGNATURE_EXPIRED	device signature expired	签名时间戳超出允许的偏差范围	使用当前时间戳重新签名
DEVICE_AUTH_DEVICE_ID_MISMATCH	device identity mismatch	device.id 与公钥指纹不匹配	确保设备 ID 与公钥指纹一致
DEVICE_AUTH_PUBLIC_KEY_INVALID	device public key invalid	公钥格式/规范化失败	检查公钥格式

1.2 节点执行错误

错误代码	描述	解决方案
NODE_BACKGROUND_UNAVAILABLE	节点应用必须在前台运行	将 iOS/Android 应用带到前台
LOCATION_PERMISSION_REQUIRED	缺少位置权限	在系统设置中授予位置权限
LOCATION_DISABLED	位置选择器已关闭	启用位置服务
LOCATION_BACKGROUND_UNAVAILABLE	应用在后台但只允许使用时	将应用带到前台或更改位置权限为"始终"
LOCATION_TIMEOUT	在时间内没有定位	检查 GPS 信号或网络连接
LOCATION_UNAVAILABLE	系统故障/没有提供商	检查系统位置服务状态
CAMERA_PERMISSION_REQUIRED	缺少相机权限	在系统设置中授予相机权限
SCREEN_PERMISSION_REQUIRED	缺少屏幕录制权限	在系统设置中授予屏幕录制权限
SYSTEM_RUN_DENIED: approval required	执行批准待处理	批准待处理的执行请求
SYSTEM_RUN_DENIED: allowlist miss	命令被允许列表阻止	将命令添加到允许列表

1.3 ACP (Agent Client Protocol) 错误

错误代码/信息	描述	解决方案
ACP_BACKEND_MISSING	ACP 后端插件缺失	安装并启用后端插件
ACP_BACKEND_UNAVAILABLE	ACP 后端不可用	检查后端插件状态
ACP_SESSION_INIT_FAILED	ACP 会话初始化失败	检查后端配置和连接
ACP_TURN_FAILED	ACP 回合执行失败	检查后端日志
AcpRuntimeError: Permission prompt unavailable in non-interactive mode	非交互式 ACP 会话中的权限提示	设置 permissionMode=approve-all 或 nonInteractivePermissions=deny
Sandboxed sessions cannot spawn ACP sessions because runtime="acp" runs on the host	沙盒会话无法生成 ACP 会话	从非沙盒会话运行 ACP，或使用 runtime="subagent"
sessions_spawn sandbox="require" is unsupported for runtime="acp"	ACP 不支持 sandbox="require"	使用 runtime="subagent" 或 sandbox="inherit"

1.4 浏览器控制错误

错误信息	描述	解决方案
Failed to start Chrome CDP on port 18800	无法启动 Chrome CDP	安装非 snap 版本的 Chrome，或使用 attach-only 模式
browser.executablePath not found	配置的浏览器路径无效	检查 browser.executablePath 配置
Chrome extension relay is running, but no tab is connected	扩展中继未附加到标签页	安装扩展并点击工具栏图标附加
Browser attachOnly is enabled ... not reachable	attach-only 配置文件没有可达目标	确保手动启动的浏览器在正确的端口上运行
Remote CDP for profile "remote" is not reachable	WSL2 无法到达配置的 cdpUrl	验证 Windows Chrome 端点可从 WSL2 访问

1.5 网关错误

错误信息	描述	解决方案
Gateway start blocked: set gateway.mode=local	本地网关模式未启用	在配置中设置 gateway.mode="local"
refusing to bind gateway ... without auth	非回环绑定需要认证	配置 gateway.auth.token 或 gateway.auth.password
another gateway instance is already listening / EADDRINUSE	端口冲突	更改端口或停止现有网关实例
RPC probe: failed	网关可访问但认证失败	检查 URL 和认证配置
control-ui-insecure-auth	UI 来源/安全上下文问题	使用 http://127.0.0.1:18789/ 而非 LAN IP
token_missing	认证配置问题	配置网关令牌
pairing required	设备批准问题	批准设备配对请求

1.6 模型认证错误

错误信息	描述	解决方案
HTTP 429: rate_limit_error: Extra usage is required for long context requests	Anthropic 长上下文需要额外使用权限	禁用 context1m 或使用具有计费的 API 密钥
No credentials found	缺少 Anthropic 令牌配置文件	在网关主机上运行 claude setup-token
This credential is only authorized for use with Claude Code and cannot be used for other API requests	订阅令牌限制	使用 Anthropic API 密钥
Token expiring/expired	令牌即将过期/已过期	重新运行 claude setup-token 并粘贴令牌

1.7 沙盒错误

错误信息	描述	解决方案
sandbox is off and host=sandbox is explicitly configured/requested, exec now fails closed	沙盒关闭但请求了沙盒执行	启用沙盒或使用 host=gateway
network: "host" is blocked	主机网络被阻止	使用 bridge 或自定义网络
network: "container:<id>" is blocked by default	容器命名空间加入被阻止	设置 dangerouslyAllowContainerNamespaceJoin: true（仅限应急）

1.8 工具执行错误

错误信息	描述	解决方案
lobster subprocess timed out	Lobster 工作流超时	增加 timeoutMs 或拆分长管道
lobster output exceeded maxStdoutBytes	输出超过最大字节数	增加 maxStdoutBytes 或减少输出大小
lobster returned invalid JSON	管道返回无效 JSON	确保管道在工具模式下运行并只打印 JSON
lobster failed (code …)	Lobster 进程失败	在终端中运行相同管道检查 stderr
too_many_pdfs	PDF 工具：PDF 过多	减少 PDF 数量
unsupported_pdf_reference	PDF 工具：不支持的引用方案	使用支持的 PDF 引用方案
pages is not supported with native PDF providers	原生 PDF 提供商不支持 pages 参数	移除 pages 参数

1.9 循环检测错误

错误类型	描述	解决方案
warningThreshold 达到	警告级别的重复模式	检查工具调用模式
criticalThreshold 达到	关键级别的重复循环模式	阻止重复的工具调用模式
globalCircuitBreakerThreshold 达到	全局无进度断路器阈值	硬停止任何无进度运行

---

2. 故障排除场景

2.1 网关故障排除

场景：网关服务未运行

症状：

• Runtime: stopped 带有退出提示
• 服务配置不匹配 (Config (cli) vs Config (service))
• 端口/监听器冲突

诊断命令：

openclaw gateway status
openclaw status
openclaw logs --follow
openclaw doctor
openclaw gateway status --deep

常见签名：

• Gateway start blocked: set gateway.mode=local → 本地网关模式未启用
• refusing to bind gateway ... without auth → 非回环绑定没有令牌/密码
• another gateway instance is already listening / EADDRINUSE → 端口冲突

场景：升级后突然出现问题

可能原因：

1. 配置漂移或更严格的默认值
2. 绑定和认证护栏更严格
3. 配对和设备身份状态更改

检查清单：

# 1) 认证和 URL 覆盖行为更改
openclaw gateway status
openclaw config get gateway.mode
openclaw config get gateway.remote.url
openclaw config get gateway.auth.mode

# 2) 绑定和认证护栏
openclaw config get gateway.bind
openclaw config get gateway.auth.token
openclaw gateway status
openclaw logs --follow

# 3) 配对和设备身份状态
openclaw devices list
openclaw pairing list --channel <channel> [--account <id>]
openclaw logs --follow
openclaw doctor

2.2 浏览器控制故障排除

场景：Linux 上 Chrome CDP 启动失败

错误：

{"error":"Error: Failed to start Chrome CDP on port 18800 for profile \"openclaw\"."}

根本原因：
Ubuntu 默认 Chromium 是 snap 包，AppArmor 限制干扰 OpenClaw 生成和监控浏览器进程。

解决方案 1：安装 Google Chrome（推荐）

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt --fix-broken install -y

配置：

{
  "browser": {
    "enabled": true,
    "executablePath": "/usr/bin/google-chrome-stable",
    "headless": true,
    "noSandbox": true
  }
}

解决方案 2：使用 Snap Chromium 的 Attach-Only 模式

{
  "browser": {
    "enabled": true,
    "attachOnly": true,
    "headless": true,
    "noSandbox": true
  }
}

手动启动 Chromium：

chromium-browser --headless --no-sandbox --disable-gpu \
  --remote-debugging-port=18800 \
  --user-data-dir=$HOME/.openclaw/browser/openclaw/user-data \
  about:blank &

场景：WSL2 + Windows + 远程 Chrome CDP

架构：

• WSL2 运行网关
• Chrome 在 Windows 上运行
• 浏览器控制必须跨越 WSL2/Windows 边界

分层验证：

1. 验证 Windows 上的 Chrome CDP

chrome.exe --remote-debugging-port=9222
curl http://127.0.0.1:9222/json/version
curl http://127.0.0.1:9222/json/list

2. 验证 WSL2 可以到达 Windows 端点

curl http://WINDOWS_HOST_OR_IP:9222/json/version
curl http://WINDOWS_HOST_OR_IP:9222/json/list

3. 配置正确的浏览器配置文件

{
  browser: {
    enabled: true,
    defaultProfile: "remote",
    profiles: {
      remote: {
        cdpUrl: "http://WINDOWS_HOST_OR_IP:9222",
        attachOnly: true,
        color: "#00AA00",
      },
    },
  },
}

常见误导性错误：

• control-ui-insecure-auth → UI 来源/安全上下文问题，不是 CDP 传输问题
• token_missing → 认证配置问题
• pairing required → 设备批准问题
• Remote CDP for profile "remote" is not reachable → WSL2 无法到达配置的 cdpUrl
• gateway timeout after 1500ms → 通常是 CDP 可达性或慢/不可达的远程端点

2.3 通道连接故障排除

场景：通道已连接但消息不流动

诊断命令：

openclaw channels status --probe
openclaw pairing list --channel <channel> [--account <id>]
openclaw status --deep
openclaw logs --follow
openclaw config get channels

常见签名：

• mention required → 消息被群组提及策略忽略
• pairing / pending approval traces → 发送者未获批准
• missing_scope, not_in_channel, Forbidden, 401/403 → 通道认证/权限问题

场景：WhatsApp 健康检查

诊断命令：

openclaw status
openclaw status --all
openclaw status --deep
openclaw health --json

日志检查：

tail /tmp/openclaw/openclaw-*.log | grep -E 'web-heartbeat|web-reconnect|web-auto-reply|web-inbound'

磁盘凭证检查：

ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json
ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json

重新链接流程：

openclaw channels logout
openclaw channels login --verbose

2.4 Cron 和心跳交付故障排除

诊断命令：

openclaw cron status
openclaw cron list
openclaw cron runs --id <jobId> --limit 20
openclaw system heartbeat last
openclaw logs --follow

常见签名：

• cron: scheduler disabled; jobs will not run automatically → cron 已禁用
• cron: timer tick failed → 调度器 tick 失败；检查文件/日志/运行时错误
• heartbeat skipped with reason=quiet-hours → 在活动小时窗口之外
• heartbeat: unknown accountId → 心跳交付目标的账户 ID 无效
• heartbeat skipped with reason=dm-blocked → 心跳目标解析为 DM 样式目的地，而 agents.defaults.heartbeat.directPolicy 设置为 block

2.5 节点配对工具故障排除

诊断命令：

openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
openclaw logs --follow
openclaw status

常见签名：

• NODE_BACKGROUND_UNAVAILABLE → 节点应用必须在前台
• *_PERMISSION_REQUIRED / LOCATION_PERMISSION_REQUIRED → 缺少操作系统权限
• SYSTEM_RUN_DENIED: approval required → 执行批准待处理
• SYSTEM_RUN_DENIED: allowlist miss → 命令被允许列表阻止

---

3. 配置错误示例

3.1 网关配置错误

错误：非回环绑定没有认证

{
  "gateway": {
    "bind": "lan",
    "auth": {
      "mode": "none"
    }
  }
}

错误： refusing to bind gateway ... without auth
修复： 配置令牌或密码，或绑定到回环

错误：同时配置令牌和密码但未设置模式

{
  "gateway": {
    "auth": {
      "token": "...",
      "password": "..."
    }
  }
}

错误： 启动和服务安装/修复流程失败
修复： 显式设置 gateway.auth.mode 为 token 或 password

错误：Docker 桥接网络下的回环绑定

{
  "gateway": {
    "bind": "loopback",
    "port": 18789
  }
}

问题： 使用 Docker 桥接网络 (-p 18789:18789) 时，流量到达 eth0，网关不可达
修复： 使用 --network host，或设置 bind: "lan" 或 bind: "custom" 与 customBindHost: "0.0.0.0"

3.2 通道配置错误

错误：多账户通道缺少默认账户

{
  "channels": {
    "telegram": {
      "accounts": {
        "personal": { "botToken": "..." },
        "biz": { "botToken": "..." }
      }
    }
  }
}

警告： 回退路由可能选择意外账户
修复： 设置 channels.telegram.defaultAccount 或 channels.telegram.accounts.default

错误：Open DM 策略安全风险

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "open",
      "allowFrom": ["*"]
    }
  }
}

警告： Doctor 会发出安全警告
建议： 使用 pairing 或 allowlist 策略

3.3 沙盒配置错误

错误：setupCommand 没有网络

{
  "agents": {
    "defaults": {
      "sandbox": {
        "docker": {
          "network": "none",
          "setupCommand": "apt-get update && apt-get install -y git"
        }
      }
    }
  }
}

问题： 包安装失败，因为没有网络
修复： 设置 docker.network: "bridge" 或烘焙自定义镜像

错误：readOnlyRoot 为 true 时尝试写入

{
  "agents": {
    "defaults": {
      "sandbox": {
        "docker": {
          "readOnlyRoot": true,
          "setupCommand": "apt-get update"
        }
      }
    }
  }
}

问题： 包安装失败，因为根文件系统只读
修复： 设置 readOnlyRoot: false 或烘焙自定义镜像

3.4 模型配置错误

错误：Anthropic 长上下文没有额外使用权限

{
  "agents": {
    "defaults": {
      "models": {
        "anthropic/claude-opus-4-6": {
          "params": {
            "context1m": true
          }
        }
      }
    }
  }
}

错误： HTTP 429: rate_limit_error: Extra usage is required for long context requests
修复选项：

1. 禁用 context1m 以回退到正常上下文窗口
2. 使用具有计费的 Anthropic API 密钥
3. 配置回退模型

3.5 工具配置错误

错误：循环检测阈值排序错误

{
  "tools": {
    "loopDetection": {
      "warningThreshold": 20,
      "criticalThreshold": 10,
      "globalCircuitBreakerThreshold": 15
    }
  }
}

错误： 验证失败
修复： 保持 warningThreshold < criticalThreshold < globalCircuitBreakerThreshold

---

4. 日志中的常见错误签名

4.1 网关日志签名

签名	含义	操作
drop guild message (mention required	群组消息被忽略，直到提及	检查 requireMention 和 mentionPatterns 配置
pairing request	发送者需要批准	批准待处理的配对请求
blocked / allowlist	发送者/频道被策略过滤	检查允许列表配置
device identity required	设备认证未满足	确保设备完成认证流程
device nonce required / device nonce mismatch	客户端未完成基于挑战的设备认证流程	更新客户端以等待 connect.challenge 并签名
device signature invalid / device signature expired	客户端为当前握手签名了错误的负载	使用正确的 challenge nonce 重新签名
gateway connect failed:	错误的主机/端口/url 目标	检查网关 URL 配置

4.2 WhatsApp 日志签名

签名	含义	操作
web-heartbeat	Web 通道心跳	正常操作
web-reconnect	Web 通道重新连接	检查连接稳定性
web-auto-reply	自动回复触发	正常操作
web-inbound	入站消息	正常操作
logged out 或状态 409-515	需要重新链接	运行 openclaw channels logout && openclaw channels login

4.3 浏览器日志签名

签名	含义	操作
Failed to start Chrome CDP on port	浏览器进程启动失败	检查浏览器安装和配置
browser.executablePath not found	配置的浏览器路径无效	更正 browser.executablePath
Chrome extension relay is running, but no tab is connected	扩展中继未附加	安装扩展并附加到标签页

4.4 ACP 日志签名

签名	含义	操作
ACP runtime backend is not configured	后端插件缺失或禁用	安装并启用后端插件
ACP is disabled by policy (acp.enabled=false)	ACP 全局禁用	设置 acp.enabled=true
ACP dispatch is disabled by policy (acp.dispatch.enabled=false)	从普通线程消息分派被禁用	设置 acp.dispatch.enabled=true
AcpRuntimeError	ACP 运行时错误	检查权限配置

---

5. 各模块的已知问题

5.1 Node + tsx 崩溃

问题： 使用 Node 和 tsx 运行 OpenClaw 在启动时失败：

[openclaw] Failed to start CLI: TypeError: __name is not a function
    at createSubsystemLogger (.../src/logging/subsystem.ts:203:25)

环境：

• Node: v25.x (在 v25.3.0 上观察到)
• tsx: 4.21.0
• OS: macOS

原因： tsx 使用 esbuild 转换 TS/ESM。esbuild 的 keepNames 发出 __name 辅助函数并用 __name(...) 包装函数定义。崩溃表明 __name 存在但在运行时不是函数。

解决方法：

• 使用 Bun 进行开发脚本（当前临时回退）
• 使用 Node + tsc watch，然后运行编译输出：

  pnpm exec tsc --watch --preserveWatchOutput
  node --watch openclaw.mjs status
  

5.2 浏览器控制限制

已知限制：

• wait --load networkidle 尚不支持
• CSS 选择器不支持用于操作
• Refs 在导航之间不稳定；如果失败，重新运行 snapshot 并使用新的 ref

5.3 ACP 会话限制

当前限制：

• ACP 会话目前在主机运行时上运行，不在 OpenClaw 沙盒内
• 沙盒会话无法生成 ACP 会话
• sessions_spawn 与 runtime: "acp" 不支持 sandbox: "require"

5.4 工具循环检测限制

默认状态： 工具循环检测默认禁用

潜在问题：

• 严格的设置可能阻止合法的重复调用
• 阈值必须正确排序：warningThreshold < criticalThreshold < globalCircuitBreakerThreshold

5.5 沙盒限制

已知问题：

• 沙盒 exec 不继承主机 process.env
• 默认 docker.network 是 "none"（无出口），所以包安装将失败
• network: "host" 被阻止
• network: "container:<id>" 默认被阻止

5.6 多账户通道限制

潜在问题：

• 如果没有设置显式默认，回退路由可能选择意外账户
• 每个账户的环境令牌仅适用于默认账户

5.7 插件系统限制

已知问题：

• 插件错误可能使网关崩溃或不稳定
• 未知插件 ID 在 entries, allow, deny, 或 slots 中是错误
• 如果插件被禁用，其配置被保留并发出警告

---

附录：环境变量参考

网关环境变量

变量	描述
OPENCLAW_GATEWAY_TOKEN	网关认证令牌
OPENCLAW_GATEWAY_PASSWORD	网关认证密码
OPENCLAW_GATEWAY_URL	网关 URL 覆盖
OPENCLAW_GATEWAY_PORT	网关端口覆盖
OPENCLAW_ALLOW_INSECURE_PRIVATE_WS	允许到受信任私有网络 IP 的明文 ws://
OPENCLAW_CONFIG_PATH	每实例配置文件
OPENCLAW_STATE_DIR	每实例状态目录
OPENCLAW_APNS_RELAY_BASE_URL	APNs 中继基础 URL
OPENCLAW_APNS_RELAY_TIMEOUT_MS	APNs 中继超时
OPENCLAW_APNS_RELAY_ALLOW_HTTP	允许 HTTP 中继 URL（仅开发）
OPENCLAW_SKIP_GMAIL_WATCHER	跳过 Gmail 观察器自动启动
OPENCLAW_SKIP_CANVAS_HOST	跳过 Canvas 主机
OPENCLAW_HIDE_BANNER	隐藏 CLI 横幅
OPENCLAW_LOAD_SHELL_ENV	加载 shell 环境
OPENCLAW_MDNS_HOSTNAME	mDNS 主机名覆盖
OPENCLAW_SSH_PORT	SSH 端口覆盖
OPENCLAW_TAILNET_DNS	Tailnet DNS 提示
OPENCLAW_CLI_PATH	CLI 路径覆盖

浏览器环境变量

变量	描述
OPENCLAW_BROWSER_EXECUTABLE_PATH	浏览器可执行路径
BROWSER_EXECUTABLE_PATH	浏览器可执行路径（旧版）
PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH	Playwright Chromium 路径
OPENCLAW_BROWSER_DISABLE_GRAPHICS_FLAGS	禁用图形标志（0 启用 WebGL）
OPENCLAW_BROWSER_DISABLE_EXTENSIONS	禁用扩展标志（0 启用扩展）
OPENCLAW_BROWSER_RENDERER_PROCESS_LIMIT	渲染器进程限制
OPENCLAW_BROWSER_CDP_PORT	CDP 端口

模型提供商环境变量

变量	描述
ANTHROPIC_API_KEY	Anthropic API 密钥
OPENAI_API_KEY	OpenAI API 密钥
OPENROUTER_API_KEY	OpenRouter API 密钥
GOOGLE_API_KEY	Google API 密钥
GROQ_API_KEY	Groq API 密钥
ELEVENLABS_API_KEY	ElevenLabs API 密钥
XI_API_KEY	ElevenLabs API 密钥（旧版）
PERPLEXITY_API_KEY	Perplexity API 密钥
FIRECRAWL_API_KEY	Firecrawl API 密钥
MOONSHOT_API_KEY	Moonshot API 密钥
ZAI_API_KEY	Z.AI API 密钥
MINIMAX_API_KEY	MiniMax API 密钥
CEREBRAS_API_KEY	Cerebras API 密钥
SYNTHETIC_API_KEY	Synthetic API 密钥
OPENCODE_API_KEY	OpenCode API 密钥
OPENCODE_ZEN_API_KEY	OpenCode Zen API 密钥
KIMI_API_KEY	Kimi API 密钥

通道环境变量

变量	描述
TELEGRAM_BOT_TOKEN	Telegram 机器人令牌
DISCORD_BOT_TOKEN	Discord 机器人令牌
DISCORD_APP_TOKEN	Discord 应用令牌
SLACK_BOT_TOKEN	Slack 机器人令牌
SLACK_APP_TOKEN	Slack 应用令牌
GOOGLE_CHAT_SERVICE_ACCOUNT	Google Chat 服务账户
GOOGLE_CHAT_SERVICE_ACCOUNT_FILE	Google Chat 服务账户文件
MSTEAMS_APP_ID	MS Teams 应用 ID
MSTEAMS_APP_PASSWORD	MS Teams 应用密码
MSTEAMS_TENANT_ID	MS Teams 租户 ID
IRC_NICKSERV_PASSWORD	IRC NickServ 密码

执行环境变量

变量	描述
PI_BASH_YIELD_MS	默认 yield（毫秒）
PI_BASH_MAX_OUTPUT_CHARS	内存输出上限（字符）
OPENCLAW_BASH_PENDING_MAX_OUTPUT_CHARS	每个流的待处理 stdout/stderr 上限
PI_BASH_JOB_TTL_MS	已完成会话的 TTL（毫秒）
SHELL	首选 shell
OPENCLAW_SHELL	设置为 exec 表示 exec 工具上下文

ClawHub 环境变量

变量	描述
CLAWHUB_SITE	覆盖站点 URL
CLAWHUB_REGISTRY	覆盖注册中心 API URL
CLAWHUB_CONFIG_PATH	覆盖 CLI 存储令牌/配置的位置
CLAWHUB_WORKDIR	覆盖默认工作目录

Docker 环境变量

变量	描述
OPENCLAW_DOCKER_SOCKET	Docker 套接字位置
OPENCLAW_SANDBOX	启用沙盒（1/true/yes/on）
OPENCLAW_DOCKER_APT_PACKAGES	构建期间安装额外的 apt 包
OPENCLAW_EXTRA_MOUNTS	添加额外的主机绑定挂载
OPENCLAW_HOME_VOLUME	在命名卷中持久化 /home/node

---

希望这篇教程能帮到想要上手 OpenClaw 的朋友，要是觉得内容不错，不妨支持转发一下～

大家如果有任何问题，都可以加入 OpenClaw 交流群探讨提问，后续我会在群里更方便地分享更多好玩的 AI 工具，企业微信和 QQ 的对接教程做好后，也会第一时间在群里同步。加群时请备注：OpenClaw 交流群。