​

常见问题

​

目录

• 快速开始与首次运行设置
  • 我卡住了，最快的排障方法是什么？
  • 安装和设置 OpenClaw 的推荐方式是什么？
  • 新手引导后如何打开仪表板？
  • 如何在本地和远程环境中验证仪表板（令牌）？
  • 我需要什么运行时？
  • 能在 Raspberry Pi 上运行吗？
  • Raspberry Pi 安装有什么建议？
  • 卡在 “wake up my friend” / 新手引导无法启动，怎么办？
  • 能否将我的设置迁移到新机器（Mac mini）而不重新进行新手引导？
  • 在哪里查看最新版本的更新内容？
  • 无法访问 docs.openclaw.ai（SSL 错误），怎么办？
  • stable 和 beta 有什么区别？
• 如何安装 beta 版本，beta 和 dev 有什么区别？
  • 如何试用最新代码？
  • 安装和新手引导通常需要多长时间？
  • 安装程序卡住了？如何获取更多反馈？
  • Windows 安装提示找不到 git 或无法识别 openclaw
  • 文档没有解答我的问题——如何获得更好的答案？
  • 如何在 Linux 上安装 OpenClaw？
  • 如何在 VPS 上安装 OpenClaw？
  • 云/VPS 安装指南在哪里？
  • 可以让 OpenClaw 自行更新吗？
  • 新手引导向导具体做了什么？
  • 运行 OpenClaw 需要 Claude 或 OpenAI 订阅吗？
  • 能否使用 Claude Max 订阅而不需要 API 密钥？
  • Anthropic “setup-token” 认证如何工作？
  • 在哪里获取 Anthropic setup-token？
  • 是否支持 Claude 订阅认证（Claude Code OAuth）？
  • 为什么我看到 HTTP 429: rate_limit_error（来自 Anthropic）？
  • 支持 AWS Bedrock 吗？
  • Codex 认证如何工作？
  • 是否支持 OpenAI 订阅认证（Codex OAuth）？
  • 如何设置 Gemini CLI OAuth？
  • 本地模型适合日常聊天吗？
  • 如何将托管模型流量限制在特定区域？
  • 我必须购买 Mac Mini 才能安装吗？
  • iMessage 支持需要 Mac mini 吗？
  • 如果我买了 Mac mini 运行 OpenClaw，能连接到我的 MacBook Pro 吗？
  • 可以使用 Bun 吗？
  • Telegram：allowFrom 填什么？
  • 多人能否使用同一个 WhatsApp 号码配合不同的 OpenClaw 实例？
  • 能否同时运行一个”快速聊天”智能体和一个”用 Opus 编程”的智能体？
  • Homebrew 在 Linux 上可用吗？
  • 可编辑（git）安装和 npm 安装有什么区别？
  • 之后可以在 npm 和 git 安装之间切换吗？
  • 应该在笔记本电脑还是 VPS 上运行 Gateway网关？
  • 在专用机器上运行 OpenClaw 有多重要？
  • VPS 的最低要求和推荐操作系统是什么？
  • 可以在虚拟机中运行 OpenClaw 吗？有什么要求？
• 什么是 OpenClaw？
  • 用一段话描述 OpenClaw？
  • 价值主张是什么？
  • 刚设置好，应该先做什么？
  • OpenClaw 日常最常用的五个场景是什么？
  • OpenClaw 能否帮助 SaaS 进行获客、外联、广告和博客？
  • 相比 Claude Code，在 Web 开发方面有什么优势？
• Skills 与自动化
  • 如何自定义 Skills 而不弄脏仓库？
  • 可以从自定义文件夹加载 Skills 吗？
  • 如何为不同任务使用不同模型？
  • 机器人在执行繁重工作时卡住了，如何卸载任务？
  • 定时任务或提醒没有触发，应该检查什么？
  • 如何在 Linux 上安装 Skills？
  • OpenClaw 能否按计划或在后台持续运行任务？
  • 能否从 Linux 运行仅限 Apple/macOS 的 Skills？
  • 有 Notion 或 HeyGen 集成吗？
  • 如何安装用于浏览器接管的 Chrome 扩展？
• 沙箱与记忆
  • 有专门的沙箱文档吗？
  • 如何将主机文件夹绑定到沙箱中？
  • 记忆是如何工作的？
  • 记忆总是遗忘，如何让它持久保存？
  • 记忆是否永久保留？有什么限制？
  • 语义记忆搜索需要 OpenAI API 密钥吗？
• 磁盘上的文件位置
  • OpenClaw 使用的所有数据都保存在本地吗？
  • OpenClaw 将数据存储在哪里？
  • AGENTS.md / SOUL.md / USER.md / MEMORY.md 应该放在哪里？
  • 推荐的备份策略是什么？
  • 如何完全卸载 OpenClaw？
  • 智能体可以在工作区外工作吗？
  • 我处于远程模式——会话存储在哪里？
• 配置基础
  • 配置文件是什么格式？在哪里？
  • 我设置了 gateway.bind: "lan"（或 "tailnet"），现在什么都监听不了 / UI 显示未授权
  • 为什么现在在 localhost 也需要令牌？
  • 更改配置后需要重启吗？
  • 如何启用网络搜索（和网页抓取）？
  • config.apply 清空了我的配置，如何恢复和避免？
  • 如何运行一个中心 Gateway网关配合跨设备的专用工作节点？
  • OpenClaw 浏览器可以无头运行吗？
  • 如何使用 Brave 进行浏览器控制？
• 远程 Gateway网关与节点
  • 命令如何在 Telegram、Gateway网关和节点之间传播？
  • 如果 Gateway网关托管在远程，我的智能体如何访问我的电脑？
  • Tailscale 已连接但收不到回复，怎么办？
  • 两个 OpenClaw 实例（本地 + VPS）可以互相通信吗？
  • 多个智能体需要独立的 VPS 吗？
  • 在个人笔记本电脑上使用节点而不是从 VPS SSH 有什么好处？
  • 节点会运行 Gateway网关服务吗？
  • 有 API / RPC 方式来应用配置吗？
  • 首次安装的最小”合理”配置是什么？
  • 如何在 VPS 上设置 Tailscale 并从 Mac 连接？
  • 如何将 Mac 节点连接到远程 Gateway网关（Tailscale Serve）？
  • 应该在第二台笔记本上安装还是只添加一个节点？
• 环境变量和 .env 加载
  • OpenClaw 如何加载环境变量？
  • “我通过服务启动了 Gateway网关，但环境变量消失了。“怎么办？
  • 我设置了 COPILOT_GITHUB_TOKEN，但 models status 显示”Shell env: off”，为什么？
• 会话与多聊天
  • 如何开始一个新对话？
  • 如果我从不发送 /new，会话会自动重置吗？
  • 能否创建一个 OpenClaw 实例团队——一个 CEO 和多个智能体？
  • 为什么上下文在任务中途被截断了？如何防止？
  • 如何完全重置 OpenClaw 但保留安装？
  • 我遇到了”context too large”错误——如何重置或压缩？
  • 为什么我看到”LLM request rejected: messages.N.content.X.tool_use.input: Field required”？
  • 为什么每 30 分钟收到一次心跳消息？
  • 需要在 WhatsApp 群组中添加”机器人账号”吗？
  • 如何获取 WhatsApp 群组的 JID？
  • 为什么 OpenClaw 不在群组中回复？
  • 群组/线程与私聊共享上下文吗？
  • 可以创建多少个工作区和智能体？
  • 可以同时运行多个机器人或聊天（Slack）吗？应该如何设置？
• 模型：默认值、选择、别名、切换
  • 什么是”默认模型”？
  • 推荐什么模型？
  • 如何在不清空配置的情况下切换模型？
  • 可以使用自托管模型（llama.cpp、vLLM、Ollama）吗？
  • OpenClaw、Flawd 和 Krill 使用什么模型？
  • 如何在运行中切换模型（无需重启）？
  • 能否日常任务用 GPT 5.2，编程用 Codex 5.2？
  • 为什么我看到”Model … is not allowed”然后没有回复？
  • 为什么我看到”Unknown model: minimax/MiniMax-M2.1”？
  • 能否将 MiniMax 设为默认，复杂任务用 OpenAI？
  • opus / sonnet / gpt 是内置快捷方式吗？
  • 如何定义/覆盖模型快捷方式（别名）？
  • 如何添加其他提供商（如 OpenRouter 或 Z.AI）的模型？
• 模型故障转移与”All models failed”
  • 故障转移是如何工作的？
  • 这个错误是什么意思？
  • No credentials found for profile "anthropic:default" 的修复清单
  • 为什么还尝试了 Google Gemini 并且失败了？
• 认证配置文件：概念和管理方式
  • 什么是认证配置文件？
  • 典型的配置文件 ID 有哪些？
  • 可以控制首先尝试哪个认证配置文件吗？
  • OAuth 与 API 密钥：有什么区别？
• Gateway网关：端口、“已在运行”和远程模式
  • Gateway网关使用什么端口？
  • 为什么 openclaw gateway status 显示 Runtime: running 但 RPC probe: failed？
  • 为什么 openclaw gateway status 显示 Config (cli) 和 Config (service) 不同？
  • “another gateway instance is already listening”是什么意思？
  • 如何以远程模式运行 OpenClaw（客户端连接到其他位置的 Gateway网关）？
  • 控制 UI 显示”unauthorized”（或持续重连），怎么办？
  • 我设置了 gateway.bind: "tailnet" 但无法绑定 / 什么都没监听
  • 可以在同一主机上运行多个 Gateway网关吗？
  • “invalid handshake” / code 1008 是什么意思？
• 日志与调试
  • 日志在哪里？
  • 如何启动/停止/重启 Gateway网关服务？
  • 我在 Windows 上关闭了终端——如何重启 OpenClaw？
  • Gateway网关已启动但回复始终不到达，应该检查什么？
  • “Disconnected from gateway: no reason”——怎么办？
  • Telegram setMyCommands 因网络错误失败，应该检查什么？
  • TUI 没有输出，应该检查什么？
  • 如何完全停止然后启动 Gateway网关？
  • 通俗解释：openclaw gateway restart 与 openclaw gateway
  • 出现故障时获取更多详情的最快方法是什么？
• 媒体与附件
  • 我的 Skills 生成了图片/PDF，但什么都没发送
• 安全与访问控制
  • 将 OpenClaw 暴露给入站私信安全吗？
  • 提示注入只对公开机器人有影响吗？
  • 我的机器人应该有自己的邮箱、GitHub 账户或电话号码吗？
  • 我能让它自主管理我的短信吗？这安全吗？
  • 个人助理任务可以使用更便宜的模型吗？
  • 我在 Telegram 中运行了 /start 但没收到配对码
  • WhatsApp：会给我的联系人发消息吗？配对如何工作？
• 聊天命令、中止任务和”停不下来”
  • 如何阻止内部系统消息显示在聊天中？
  • 如何停止/取消正在运行的任务？
  • 如何从 Telegram 发送 Discord 消息？（“Cross-context messaging denied”）
  • 为什么感觉机器人”忽略”了快速连发的消息？

​

出问题后的前 60 秒

1. 快速状态（首先检查）
   复制

   openclaw status
   
   快速本地摘要：操作系统 + 更新、Gateway网关/服务可达性、智能体/会话、提供商配置 + 运行时问题（Gateway网关可达时）。
2. 可粘贴的报告（可安全分享）
   复制

   openclaw status --all
   
   只读诊断，附带日志尾部（令牌已脱敏）。
3. 守护进程 + 端口状态
   复制

   openclaw gateway status
   
   显示 supervisor 运行状态与 RPC 可达性、探测目标 URL，以及服务可能使用的配置。
4. 深度探测
   复制

   openclaw status --deep
   
   运行 Gateway网关健康检查 + 提供商探测（需要可达的 Gateway网关）。参阅健康检查。
5. 跟踪最新日志
   复制

   openclaw logs --follow
   
   如果 RPC 不可用，回退到：
   复制

   tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"
   
   文件日志与服务日志是分开的；参阅日志和故障排除。
6. 运行 doctor（修复）
   复制

   openclaw doctor
   
   修复/迁移配置/状态 + 运行健康检查。参阅 Doctor。
7. Gateway网关快照
   复制

   openclaw health --json
   openclaw health --verbose   # 出错时显示目标 URL + 配置路径
   
   向运行中的 Gateway网关请求完整快照（仅 WS）。参阅健康检查。

​

快速开始与首次运行设置

​

我卡住了，最快的排障方法是什么

• Claude Code：https://www.anthropic.com/claude-code/
• OpenAI Codex：https://openai.com/codex/

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

openclaw status
openclaw models status
openclaw doctor

• openclaw status：Gateway网关/智能体健康状况 + 基本配置的快速快照。
• openclaw models status：检查提供商认证 + 模型可用性。
• openclaw doctor：验证并修复常见的配置/状态问题。

​

安装和设置 OpenClaw 的推荐方式是什么

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build # 首次运行时自动安装 UI 依赖
openclaw onboard

​

新手引导后如何打开仪表板

​

如何在本地和远程环境中验证仪表板令牌

• 打开 http://127.0.0.1:18789/。
• 如果要求认证，运行 openclaw dashboard 并使用带令牌的链接（?token=...）。
• 令牌与 gateway.auth.token（或 OPENCLAW_GATEWAY_TOKEN）的值相同，UI 在首次加载后会存储它。

• Tailscale Serve（推荐）：保持绑定 loopback，运行 openclaw gateway --tailscale serve，打开 https://<magicdns>/。如果 gateway.auth.allowTailscale 为 true，身份标头满足认证要求（无需令牌）。
• Tailnet 绑定：运行 openclaw gateway --bind tailnet --token "<token>"，打开 http://<tailscale-ip>:18789/，在仪表板设置中粘贴令牌。
• SSH 隧道：ssh -N -L 18789:127.0.0.1:18789 user@host，然后从 openclaw dashboard 打开 http://127.0.0.1:18789/?token=...。

​

我需要什么运行时

​

能在 Raspberry Pi 上运行吗

​

Raspberry Pi 安装有什么建议

• 使用 64 位操作系统并保持 Node >= 22。
• 优先选择可编辑（git）安装，以便查看日志和快速更新。
• 先不启用渠道/Skills，然后逐个添加。
• 如果遇到奇怪的二进制问题，通常是 ARM 兼容性问题。

​

卡在 wake up my friend / 新手引导无法启动，怎么办

1. 重启 Gateway网关：

openclaw gateway restart

2. 检查状态和认证：

openclaw status
openclaw models status
openclaw logs --follow

3. 如果仍然挂起，运行：

openclaw doctor

​

能否将我的设置迁移到新机器（Mac mini）而不重新进行新手引导

1. 在新机器上安装 OpenClaw。
2. 从旧机器复制 $OPENCLAW_STATE_DIR（默认：~/.openclaw）。
3. 复制你的工作区（默认：~/.openclaw/workspace）。
4. 运行 openclaw doctor 并重启 Gateway网关服务。

​

在哪里查看最新版本的更新内容

​

无法访问 docs.openclaw.ai（SSL 错误），怎么办

​

stable 和 beta 有什么区别

• latest = stable
• beta = 用于测试的早期构建

​

如何安装 beta 版本，beta 和 dev 有什么区别

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

​

安装和新手引导通常需要多长时间

• 安装： 2-5 分钟
• 新手引导： 5-15 分钟，取决于配置多少渠道/模型

​

如何试用最新代码

1. Dev 渠道（git checkout）：

openclaw update --channel dev

2. 可编辑安装（从安装程序网站）：

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build

​

安装程序卡住了？如何获取更多反馈

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --verbose

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --beta --verbose

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose

​

Windows 安装提示找不到 git 或无法识别 openclaw

• 安装 Git for Windows 并确保 git 在你的 PATH 中。
• 关闭并重新打开 PowerShell，然后重新运行安装程序。

• 你的 npm 全局 bin 文件夹不在 PATH 中。
• 检查路径：
  复制

  npm config get prefix
  
• 确保 <prefix>\\bin 在 PATH 中（在大多数系统上是 %AppData%\\npm）。
• 更新 PATH 后关闭并重新打开 PowerShell。

​

文档没有解答我的问题——如何获得更好的答案

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

​

如何在 Linux 上安装 OpenClaw

• Linux 快速路径 + 服务安装：Linux。
• 完整指南：入门。
• 安装和更新：安装与更新。

​

如何在 VPS 上安装 OpenClaw

​

云/VPS 安装指南在哪里

• VPS 托管（所有提供商汇总）
• Fly.io
• Hetzner
• exe.dev

​

可以让 OpenClaw 自行更新吗

openclaw update
openclaw update status
openclaw update --channel stable|beta|dev
openclaw update --tag <dist-tag|version>
openclaw update --no-restart

openclaw update --yes --no-restart
openclaw gateway restart

​

新手引导向导具体做了什么

• 模型/认证设置（推荐使用 Anthropic setup-token 进行 Claude 订阅，支持 OpenAI Codex OAuth，API 密钥可选，支持 LM Studio 本地模型）
• 工作区位置 + 引导文件
• Gateway网关设置（绑定/端口/认证/tailscale）
• 渠道（WhatsApp、Telegram、Discord、Mattermost（插件）、Signal、iMessage）
• 守护进程安装（macOS 上的 LaunchAgent；Linux/WSL2 上的 systemd 用户单元）
• 健康检查和Skills选择

​

运行 OpenClaw 需要 Claude 或 OpenAI 订阅吗

​

能否使用 Claude Max 订阅而不需要 API 密钥

​

Anthropic setup-token 认证如何工作

​

在哪里获取 Anthropic setup-token

claude setup-token

​

是否支持 Claude 订阅认证（Claude Pro/Max）

​

为什么我看到 HTTP 429 rate_limit_error（来自 Anthropic）

​

支持 AWS Bedrock 吗

​

Codex 认证如何工作

​

是否支持 OpenAI 订阅认证（Codex OAuth）

​

如何设置 Gemini CLI OAuth

1. 启用插件：openclaw plugins enable google-gemini-cli-auth
2. 登录：openclaw models auth login --provider google-gemini-cli --set-default

​

本地模型适合日常聊天吗

​

如何将托管模型流量限制在特定区域

​

我必须购买 Mac Mini 才能安装吗

​

iMessage 支持需要 Mac mini 吗

• 在 Linux/VPS 上运行 Gateway网关，将 channels.imessage.cliPath 指向在 Mac 上运行 imsg 的 SSH 包装器。
• 如果你想要最简单的单机设置，在 Mac 上运行所有组件。

​

如果我买了 Mac mini 运行 OpenClaw，能连接到我的 MacBook Pro 吗

• Gateway网关在 Mac mini 上（常开）。
• MacBook Pro 运行 macOS 应用或节点主机并配对到 Gateway网关。
• 使用 openclaw nodes status / openclaw nodes list 查看它。

​

可以使用 Bun 吗

​

Telegram：allowFrom 填什么

• 给你的机器人发私信，然后运行 openclaw logs --follow 并读取 from.id。

• 给你的机器人发私信，然后调用 https://api.telegram.org/bot<bot_token>/getUpdates 并读取 message.from.id。

• 给 @userinfobot 或 @getidsbot 发私信。

​

多人能否使用同一个 WhatsApp 号码配合不同的 OpenClaw 实例

​

能否同时运行一个”快速聊天”智能体和一个”用 Opus 编程”的智能体

​

Homebrew 在 Linux 上可用吗

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profile
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
brew install <formula>

​

可编辑（git）安装和 npm 安装有什么区别

• 可编辑（git）安装： 完整源码 checkout，可编辑，最适合贡献者。你在本地运行构建并可以修补代码/文档。
• npm 安装： 全局 CLI 安装，无仓库，最适合”直接运行”。更新来自 npm dist-tags。

​

之后可以在 npm 和 git 安装之间切换吗

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
openclaw doctor
openclaw gateway restart

npm install -g openclaw@latest
openclaw doctor
openclaw gateway restart

​

应该在笔记本电脑还是 VPS 上运行 Gateway网关简短回答：如果你想要 24/7 可靠性，使用 VPS。如果你想要最低摩擦且能接受休眠/重启，在本地运行。

• 优点： 无服务器成本，直接访问本地文件，实时浏览器窗口。
• 缺点： 休眠/网络中断 = 断连，操作系统更新/重启会中断，必须保持唤醒。

• 优点： 常开，网络稳定，无笔记本休眠问题，更容易保持运行。
• 缺点： 通常无头运行（使用截图），仅远程文件访问，更新需要 SSH。

​

在专用机器上运行 OpenClaw 有多重要

• 专用主机（VPS/Mac mini/Pi）： 常开，更少的休眠/重启中断，更干净的权限，更容易保持运行。
• 共享的笔记本/台式机： 完全适合测试和活跃使用，但当机器休眠或更新时预期会有暂停。

​

VPS 的最低要求和推荐操作系统是什么

• 绝对最低： 1 vCPU，1GB RAM，约 500MB 磁盘。
• 推荐： 1-2 vCPU，2GB RAM 或更多以留有余量（日志、媒体、多渠道）。节点工具和浏览器自动化可能消耗较多资源。

​

可以在虚拟机中运行 OpenClaw 吗？有什么要求

• 绝对最低： 1 vCPU，1GB RAM。
• 推荐： 2GB RAM 或更多，如果你运行多个渠道、浏览器自动化或媒体工具。
• 操作系统： Ubuntu LTS 或其他现代 Debian/Ubuntu。

​

什么是 OpenClaw？

​

用一段话描述 OpenClaw

​

价值主张是什么

• 你的设备，你的数据： 在任何你想要的地方运行 Gateway网关（Mac、Linux、VPS），并将工作区 + 会话历史保持在本地。
• 真实渠道，而非 Web 沙箱： WhatsApp/Telegram/Slack/Discord/Signal/iMessage/等，加上支持平台上的移动语音和 Canvas。
• 模型无关： 使用 Anthropic、OpenAI、MiniMax、OpenRouter 等，支持按智能体路由和故障转移。
• 纯本地选项： 运行本地模型，让所有数据都保留在你的设备上。
• 多智能体路由： 按渠道、账户或任务分配不同的智能体，每个都有自己的工作区和默认值。
• 开源且可编辑： 无供应商锁定地检查、扩展和自托管。

​

刚设置好，应该先做什么

• 建一个网站（WordPress、Shopify 或简单的静态站点）。
• 做一个移动应用原型（大纲、界面、API 计划）。
• 整理文件和文件夹（清理、命名、打标签）。
• 连接 Gmail 并自动化摘要或跟进。

​

OpenClaw 日常最常用的五个场景是什么

• 个人简报： 收件箱、日历和你关心的新闻摘要。
• 研究和起草： 快速研究、摘要以及邮件或文档的初稿。
• 提醒和跟进： 定时任务或心跳驱动的提醒和检查清单。
• 浏览器自动化： 填写表单、收集数据和重复性网页任务。
• 跨设备协调： 从手机发送任务，让 Gateway网关在服务器上运行，然后在聊天中获取结果。

​

OpenClaw 能否帮助 SaaS 进行获客、外联、广告和博客

​

相比 Claude Code，在 Web 开发方面有什么优势

• 跨会话的持久记忆 + 工作区
• 多平台访问（WhatsApp、Telegram、TUI、WebChat）
• 工具编排（浏览器、文件、调度、钩子）
• 常开 Gateway网关（在 VPS 上运行，从任何地方交互）
• 用于本地浏览器/屏幕/摄像头/执行的节点

​

Skills 与自动化

​

如何自定义 Skills 而不弄脏仓库

​

可以从自定义文件夹加载 Skills 吗

​

如何为不同任务使用不同模型

• 定时任务：隔离的任务可以为每个任务设置 model 覆盖。
• 子智能体：将任务路由到具有不同默认模型的独立智能体。
• 按需切换：使用 /model 随时切换当前会话模型。

​

机器人在执行繁重工作时卡住了，如何卸载任务

​

定时任务或提醒没有触发，应该检查什么

• 确认 cron 已启用（cron.enabled）且未设置 OPENCLAW_SKIP_CRON。
• 检查 Gateway网关是否 24/7 运行（无休眠/重启）。
• 验证任务的时区设置（--tz 与主机时区）。

openclaw cron run <jobId> --force
openclaw cron runs --id <jobId> --limit 50

​

如何在 Linux 上安装 Skills

npm i -g clawhub

pnpm add -g clawhub

​

OpenClaw 能否按计划或在后台持续运行任务

• 定时任务用于计划或重复任务（跨重启持久化）。
• 心跳用于”主会话”定期检查。
• 隔离任务用于自主智能体发布摘要或投递到聊天。

1. 为二进制文件创建 SSH 包装器（示例：imsg）：
   复制

   #!/usr/bin/env bash
   set -euo pipefail
   exec ssh -T user@mac-host /opt/homebrew/bin/imsg "$@"
   
2. 将包装器放在 Linux 主机的 PATH 上（例如 ~/bin/imsg）。
3. 覆盖 Skills 元数据（工作区或 ~/.openclaw/skills）以允许 Linux：
   复制

   ---
   name: imsg
   description: iMessage/SMS CLI for listing chats, history, watch, and sending.
   metadata: { "openclaw": { "os": ["darwin", "linux"], "requires": { "bins": ["imsg"] } } }
   ---
   
4. 开始新会话以刷新 Skills 快照。

​

有 Notion 或 HeyGen 集成吗

• 自定义 Skills / 插件： 最适合可靠的 API 访问（Notion/HeyGen 都有 API）。
• 浏览器自动化： 无需编码但更慢且更脆弱。

• 每个客户一个 Notion 页面（上下文 + 偏好 + 当前工作）。
• 在会话开始时要求智能体获取该页面。

clawhub install <skill-slug>
clawhub update --all

​

如何安装用于浏览器接管的 Chrome 扩展

openclaw browser extension install
openclaw browser extension path

​

沙箱与记忆

​

有专门的沙箱文档吗

​

如何将主机文件夹绑定到沙箱中

​

记忆是如何工作的

• 每日笔记在 memory/YYYY-MM-DD.md
• 精选的长期笔记在 MEMORY.md（仅限主/私密会话）

​

记忆总是遗忘，如何让它持久保存

​

语义记忆搜索需要 OpenAI API 密钥吗

​

记忆是否永久保留？有什么限制

​

磁盘上的文件位置

​

OpenClaw 使用的所有数据都保存在本地吗

• 默认本地： 会话、记忆文件、配置和工作区位于 Gateway网关主机上（~/.openclaw + 你的工作区目录）。
• 必然远程： 你发送给模型提供商（Anthropic/OpenAI/等）的消息会发送到它们的 API，聊天平台（WhatsApp/Telegram/Slack/等）在它们的服务器上存储消息数据。
• 你控制范围： 使用本地模型可以将提示保留在你的机器上，但渠道流量仍然通过渠道的服务器。

​

OpenClaw 将数据存储在哪里

​

AGENTS.md / SOUL.md / USER.md / MEMORY.md 应该放在哪里

• 工作区（按智能体）：AGENTS.md、SOUL.md、IDENTITY.md、USER.md、 MEMORY.md（或 memory.md）、memory/YYYY-MM-DD.md、可选的 HEARTBEAT.md。
• 状态目录（~/.openclaw）：配置、凭据、认证配置文件、会话、日志和共享 Skills（~/.openclaw/skills）。

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}

​

推荐的备份策略是什么

​

如何完全卸载 OpenClaw

​

智能体可以在工作区外工作吗

{
  agents: {
    defaults: {
      workspace: "~/Projects/my-repo",
    },
  },
}

​

我处于远程模式——会话存储在哪里

​

配置基础

​

配置文件是什么格式？在哪里

$OPENCLAW_CONFIG_PATH

​

我设置了 gateway.bind: “lan”（或 “tailnet”），现在什么都监听不了 / UI 显示未授权

{
  gateway: {
    bind: "lan",
    auth: {
      mode: "token",
      token: "replace-me",
    },
  },
}

• gateway.remote.token 仅用于远程 CLI 调用；它不启用本地 Gateway网关认证。
• 控制 UI 通过 connect.params.auth.token（存储在应用/UI 设置中）进行认证。避免将令牌放在 URL 中。

​

为什么现在在 localhost 也需要令牌

​

更改配置后需要重启吗

• gateway.reload.mode: "hybrid"（默认）：安全更改热应用，关键更改重启
• 也支持 hot、restart、off

​

如何启用网络搜索（和网页抓取）

{
  tools: {
    web: {
      search: {
        enabled: true,
        apiKey: "BRAVE_API_KEY_HERE",
        maxResults: 5,
      },
      fetch: {
        enabled: true,
      },
    },
  },
}

• 如果你使用允许列表，添加 web_search/web_fetch 或 group:web。
• web_fetch 默认启用（除非明确禁用）。
• 守护进程从 ~/.openclaw/.env（或服务环境）读取环境变量。

​

config.apply 清空了我的配置，如何恢复和避免

• 从备份恢复（git 或复制的 ~/.openclaw/openclaw.json）。
• 如果没有备份，重新运行 openclaw doctor 并重新配置渠道/模型。
• 如果这是意外情况，提交 bug 并附上你最后已知的配置或任何备份。
• 本地编码智能体通常可以从日志或历史中重建工作配置。

• 对小更改使用 openclaw config set。
• 对交互式编辑使用 openclaw configure。

​

如何运行一个中心 Gateway网关配合跨设备的专用工作节点

• Gateway网关（中心）： 拥有渠道（Signal/WhatsApp）、路由和会话。
• 节点（设备）： Mac/iOS/Android 作为外围设备连接，暴露本地工具（system.run、canvas、camera）。
• 智能体（工作者）： 用于特殊角色的独立大脑/工作区（例如”Hetzner 运维”、“个人数据”）。
• 子智能体： 需要并行处理时从主智能体生成后台工作。
• TUI： 连接到 Gateway网关并切换智能体/会话。

​

OpenClaw 浏览器可以无头运行吗

{
  browser: { headless: true },
  agents: {
    defaults: {
      sandbox: { browser: { headless: true } },
    },
  },
}

• 没有可见的浏览器窗口（如果需要视觉效果使用截图）。
• 某些网站在无头模式下对自动化更严格（验证码、反机器人）。例如，X/Twitter 经常阻止无头会话。

​

如何使用 Brave 进行浏览器控制

​

远程 Gateway网关与节点

​

命令如何在 Telegram、Gateway网关和节点之间传播

​

如果 Gateway网关托管在远程，我的智能体如何访问我的电脑

1. 在常开主机（VPS/家庭服务器）上运行 Gateway网关。
2. 将 Gateway网关主机和你的电脑放在同一个 tailnet 上。
3. 确保 Gateway网关 WS 可达（tailnet 绑定或 SSH 隧道）。
4. 在本地打开 macOS 应用并以远程 over SSH 模式连接（或直接 tailnet），使其可以注册为节点。
5. 在 Gateway网关上批准节点：
   复制

   openclaw nodes pending
   openclaw nodes approve <requestId>
   

​

Tailscale 已连接但收不到回复，怎么办

• Gateway网关正在运行：openclaw gateway status
• Gateway网关健康：openclaw status
• 渠道健康：openclaw channels status

• 如果你使用 Tailscale Serve，确保 gateway.auth.allowTailscale 设置正确。
• 如果你通过 SSH 隧道连接，确认本地隧道已启动并指向正确端口。
• 确认你的允许列表（私信或群组）包含你的账户。

​

两个 OpenClaw 实例（本地 + VPS）可以互相通信吗

openclaw agent --message "Hello from local bot" --deliver --channel telegram --reply-to <chat-id>

​

多个智能体需要独立的 VPS 吗

​

在个人笔记本电脑上使用节点而不是从 VPS SSH 有什么好处

• 无需入站 SSH。 节点向 Gateway网关 WebSocket 发起出站连接并使用设备配对。
• 更安全的执行控制。 system.run 受该笔记本上节点允许列表/审批的限制。
• 更多设备工具。 节点除了 system.run 还暴露 canvas、camera 和 screen。
• 本地浏览器自动化。 将 Gateway网关保持在 VPS 上，但在本地运行 Chrome 并通过 Chrome 扩展 + 笔记本上的节点主机中继控制。

​

应该在第二台笔记本上安装还是只添加一个节点

​

节点会运行 Gateway网关服务吗

​

有 API / RPC 方式来应用配置吗

​

首次安装的最小”合理”配置是什么

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

​

如何在 VPS 上设置 Tailscale 并从 Mac 连接

1. 在 VPS 上安装并登录
   复制

   curl -fsSL https://tailscale.com/install.sh | sh
   sudo tailscale up
   
2. 在 Mac 上安装并登录
   • 使用 Tailscale 应用并登录到同一个 tailnet。
3. 启用 MagicDNS（推荐）
   • 在 Tailscale 管理控制台中启用 MagicDNS，这样 VPS 有一个稳定的名称。
4. 使用 tailnet 主机名
   • SSH：ssh [email protected]
   • Gateway网关 WS：ws://your-vps.tailnet-xxxx.ts.net:18789

openclaw gateway --tailscale serve

​

如何将 Mac 节点连接到远程 Gateway网关（Tailscale Serve）

1. 确保 VPS + Mac 在同一个 tailnet 上。
2. 使用 macOS 应用的远程模式（SSH 目标可以是 tailnet 主机名）。应用会隧道 Gateway网关端口并作为节点连接。
3. 在 Gateway网关上批准节点：
   复制

   openclaw nodes pending
   openclaw nodes approve <requestId>
   

​

环境变量和 .env 加载

​

OpenClaw 如何加载环境变量

• 当前工作目录下的 .env
• ~/.openclaw/.env（即 $OPENCLAW_STATE_DIR/.env）的全局回退 .env

{
  env: {
    OPENROUTER_API_KEY: "sk-or-...",
    vars: { GROQ_API_KEY: "gsk-..." },
  },
}

​

我通过服务启动了 Gateway网关，但环境变量消失了，怎么办

1. 将缺失的密钥放在 ~/.openclaw/.env 中，这样即使服务不继承你的 shell 环境也能被获取。
2. 启用 shell 导入（可选的便利功能）：

{
  env: {
    shellEnv: {
      enabled: true,
      timeoutMs: 15000,
    },
  },
}

​

我设置了 COPILOT_GITHUB_TOKEN，但 models status 显示”Shell env: off”，为什么

1. 将令牌放在 ~/.openclaw/.env 中：
   复制

   COPILOT_GITHUB_TOKEN=...
   
2. 或启用 shell 导入（env.shellEnv.enabled: true）。
3. 或将其添加到配置的 env 块中（仅在缺失时应用）。

openclaw models status

​

会话与多聊天

​

如何开始一个新对话

​

如果我从不发送 /new，会话会自动重置吗

{
  session: {
    idleMinutes: 240,
  },
}

​

能否创建一个 OpenClaw 实例团队——一个 CEO 和多个智能体

​

为什么上下文在任务中途被截断了？如何防止

• 要求机器人总结当前状态并写入文件。
• 在长任务之前使用 /compact，切换话题时使用 /new。
• 将重要上下文保存在工作区中，要求机器人读取。
• 对长时间或并行工作使用子智能体，这样主聊天保持较小。
• 如果这种情况经常发生，选择具有更大上下文窗口的模型。

​

如何完全重置 OpenClaw 但保留安装

openclaw reset

openclaw reset --scope full --yes --non-interactive

openclaw onboard --install-daemon

• 新手引导向导在看到现有配置时也提供重置选项。参阅向导。
• 如果你使用了配置文件（--profile / OPENCLAW_PROFILE），重置每个状态目录（默认为 ~/.openclaw-<profile>）。
• 开发重置：openclaw gateway --dev --reset（仅限开发；清除开发配置 + 凭据 + 会话 + 工作区）。

​

我遇到了 context too large 错误——如何重置或压缩

• 压缩（保留对话但总结较早的轮次）：
  复制

  /compact
  
  或 /compact <instructions> 来引导总结。
• 重置（为同一聊天键开始新的会话 ID）：
  复制

  /new
  /reset
  

• 启用或调整会话修剪（agents.defaults.contextPruning）以裁剪旧的工具输出。
• 使用具有更大上下文窗口的模型。

​

为什么我看到 LLM request rejected: messages.N.content.X.tool_use.input: Field required

​

为什么每 30 分钟收到一次心跳消息

{
  agents: {
    defaults: {
      heartbeat: {
        every: "2h", // 或 "0m" 禁用
      },
    },
  },
}

​

需要在 WhatsApp 群组中添加”机器人账号”吗

{
  channels: {
    whatsapp: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

​

如何获取 WhatsApp 群组的 JID

openclaw logs --follow --json

openclaw directory groups list --channel whatsapp

​

为什么 OpenClaw 不在群组中回复

• 提及限制已开启（默认）。你必须 @提及机器人（或匹配 mentionPatterns）。
• 你配置了 channels.whatsapp.groups 但没有 "*" 且该群组未加入允许列表。

​

群组/线程与私聊共享上下文吗

​

可以创建多少个工作区和智能体

• 磁盘增长： 会话 + 记录位于 ~/.openclaw/agents/<agentId>/sessions/ 下。
• 令牌成本： 更多智能体意味着更多并发模型使用。
• 运维开销： 按智能体的认证配置文件、工作区和渠道路由。

• 每个智能体保持一个活跃工作区（agents.defaults.workspace）。
• 如果磁盘增长，修剪旧会话（删除 JSONL 或存储条目）。
• 使用 openclaw doctor 发现无用的工作区和配置文件不匹配。

​

可以同时运行多个机器人或聊天（Slack）吗？应该如何设置

• 常开 Gateway网关主机（VPS/Mac mini）。
• 每个角色一个智能体（绑定）。
• Slack 渠道绑定到这些智能体。
• 需要时通过扩展中继（或节点）使用本地浏览器。

​

模型：默认值、选择、别名、切换

​

什么是”默认模型”

agents.defaults.model.primary

​

推荐什么模型

​

可以使用自托管模型（llama.cpp、vLLM、Ollama）吗

​

如何在不清空配置的情况下切换模型

• 聊天中的 /model（快速，按会话）
• openclaw models set ...（只更新模型配置）
• openclaw configure --section models（交互式）
• 编辑 ~/.openclaw/openclaw.json 中的 agents.defaults.model

​

OpenClaw、Flawd 和 Krill 使用什么模型

• OpenClaw + Flawd： Anthropic Opus（anthropic/claude-opus-4-5）——参阅 Anthropic。
• Krill： MiniMax M2.1（minimax/MiniMax-M2.1）——参阅 MiniMax。

​

如何在运行中切换模型（无需重启）

/model sonnet
/model haiku
/model opus
/model gpt
/model gpt-mini
/model gemini
/model gemini-flash

/model 3

/model opus@anthropic:default
/model opus@anthropic:work

/model anthropic/claude-opus-4-5

​

能否日常任务用 GPT 5.2，编程用 Codex 5.2

• 快速切换（按会话）： 日常任务用 /model gpt-5.2，编程用 /model gpt-5.2-codex。
• 默认 + 切换： 将 agents.defaults.model.primary 设置为 openai-codex/gpt-5.2，然后编程时切换到 openai-codex/gpt-5.2-codex（或反过来）。
• 子智能体： 将编程任务路由到具有不同默认模型的子智能体。

​

为什么我看到”Model … is not allowed”然后没有回复

Model "provider/model" is not allowed. Use /model to list available models.

​

为什么我看到”Unknown model: minimax/MiniMax-M2.1”

1. 升级到 2026.1.12（或从源码 main 运行），然后重启 Gateway网关。
2. 确保 MiniMax 已配置（向导或 JSON），或者 MiniMax API 密钥存在于环境/认证配置文件中以便提供商可以被注入。
3. 使用精确的模型 ID（区分大小写）：minimax/MiniMax-M2.1 或 minimax/MiniMax-M2.1-lightning。
4. 运行：
   复制

   openclaw models list
   
   并从列表中选择（或在聊天中使用 /model list）。

​

能否将 MiniMax 设为默认，复杂任务用 OpenAI

{
  env: { MINIMAX_API_KEY: "sk-...", OPENAI_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "minimax/MiniMax-M2.1" },
      models: {
        "minimax/MiniMax-M2.1": { alias: "minimax" },
        "openai/gpt-5.2": { alias: "gpt" },
      },
    },
  },
}

/model gpt

• 智能体 A 默认：MiniMax
• 智能体 B 默认：OpenAI
• 按智能体路由或使用 /agent 切换

​

opus / sonnet / gpt 是内置快捷方式吗

• opus → anthropic/claude-opus-4-5
• sonnet → anthropic/claude-sonnet-4-5
• gpt → openai/gpt-5.2
• gpt-mini → openai/gpt-5-mini
• gemini → google/gemini-3-pro-preview
• gemini-flash → google/gemini-3-flash-preview

​

如何定义/覆盖模型快捷方式（别名）

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-5" },
      models: {
        "anthropic/claude-opus-4-5": { alias: "opus" },
        "anthropic/claude-sonnet-4-5": { alias: "sonnet" },
        "anthropic/claude-haiku-4-5": { alias: "haiku" },
      },
    },
  },
}

​

如何添加其他提供商（如 OpenRouter 或 Z.AI）的模型

{
  agents: {
    defaults: {
      model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
      models: { "openrouter/anthropic/claude-sonnet-4-5": {} },
    },
  },
  env: { OPENROUTER_API_KEY: "sk-or-..." },
}

{
  agents: {
    defaults: {
      model: { primary: "zai/glm-4.7" },
      models: { "zai/glm-4.7": {} },
    },
  },
  env: { ZAI_API_KEY: "..." },
}

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

• 运行 openclaw agents add <id> 并在向导中配置认证。
• 或从主智能体的 agentDir 复制 auth-profiles.json 到新智能体的 agentDir。

​

模型故障转移与”All models failed”

​

故障转移是如何工作的

1. 同一提供商内的认证配置文件轮换。
2. 模型回退到 agents.defaults.model.fallbacks 中的下一个模型。

​

这个错误是什么意思

No credentials found for profile "anthropic:default"

​

No credentials found for profile “anthropic:default” 的修复清单

• 确认认证配置文件的位置（新路径 vs 旧路径）
  • 当前：~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • 旧版：~/.openclaw/agent/*（通过 openclaw doctor 迁移）
• 确认环境变量被 Gateway网关加载
  • 如果你在 shell 中设置了 ANTHROPIC_API_KEY 但通过 systemd/launchd 运行 Gateway网关，它可能不会继承。将其放在 ~/.openclaw/.env 中或启用 env.shellEnv。
• 确保你编辑的是正确的智能体
  • 多智能体设置意味着可能有多个 auth-profiles.json 文件。
• 完整性检查模型/认证状态
  • 使用 openclaw models status 查看已配置的模型以及提供商是否已认证。

• 使用 setup-token
  • 运行 claude setup-token，然后用 openclaw models auth setup-token --provider anthropic 粘贴。
  • 如果令牌在另一台机器上创建，使用 openclaw models auth paste-token --provider anthropic。
• 如果你想使用 API 密钥
  • 在 Gateway网关主机上将 ANTHROPIC_API_KEY 放入 ~/.openclaw/.env。
  • 清除任何强制缺失配置文件的固定顺序：
    复制

    openclaw models auth order clear --provider anthropic
    
• 确认你在 Gateway网关主机上运行命令
  • 在远程模式下，认证配置文件位于 Gateway网关机器上，而不是你的笔记本上。

​

为什么还尝试了 Google Gemini 并且失败了

​

认证配置文件：概念和管理方式

​

什么是认证配置文件

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

​

典型的配置文件 ID 有哪些

• anthropic:default（没有邮箱身份时常见）
• anthropic:<email>（用于 OAuth 身份）
• 你自定义的 ID（例如 anthropic:work）

​

可以控制首先尝试哪个认证配置文件吗

# 默认为配置的默认智能体（省略 --agent）
openclaw models auth order get --provider anthropic

# 将轮换锁定到单个配置文件（只尝试这一个）
openclaw models auth order set --provider anthropic anthropic:default

# 或设置明确的顺序（提供商内回退）
openclaw models auth order set --provider anthropic anthropic:work anthropic:default

# 清除覆盖（回退到配置 auth.order / 轮换）
openclaw models auth order clear --provider anthropic

openclaw models auth order set --provider anthropic --agent main anthropic:default

​

OAuth 与 API 密钥：有什么区别

• OAuth 通常利用订阅访问（如适用）。
• API 密钥 使用按令牌付费的计费。

​

Gateway网关：端口、“已在运行”和远程模式

​

Gateway网关使用什么端口

--port > OPENCLAW_GATEWAY_PORT > gateway.port > 默认 18789

​

为什么 openclaw gateway status 显示 Runtime: running 但 RPC probe: failed

• Probe target:（探测实际使用的 URL）
• Listening:（端口上实际绑定的内容）
• Last gateway error:（进程存活但端口未监听时的常见根因）

​

为什么 openclaw gateway status 显示 Config (cli) 和 Config (service) 不同

openclaw gateway install --force

​

“another gateway instance is already listening”是什么意思

​

如何以远程模式运行 OpenClaw（客户端连接到其他位置的 Gateway网关）

{
  gateway: {
    mode: "remote",
    remote: {
      url: "ws://gateway.tailnet:18789",
      token: "your-token",
      password: "your-password",
    },
  },
}

• openclaw gateway 仅在 gateway.mode 为 local 时启动（或你传递覆盖标志）。
• macOS 应用监视配置文件，当这些值更改时实时切换模式。

​

控制 UI 显示”unauthorized”或持续重连，怎么办

• 控制 UI 将令牌存储在浏览器 localStorage 键 openclaw.control.settings.v1 中。
• UI 可以导入一次 ?token=...（和/或 ?password=...），然后从 URL 中剥离。

• 最快：openclaw dashboard（打印 + 复制带令牌的链接，尝试打开；如果无头则显示 SSH 提示）。
• 如果你还没有令牌：openclaw doctor --generate-gateway-token。
• 如果是远程，先建隧道：ssh -N -L 18789:127.0.0.1:18789 user@host 然后打开 http://127.0.0.1:18789/?token=...。
• 在 Gateway网关主机上设置 gateway.auth.token（或 OPENCLAW_GATEWAY_TOKEN）。
• 在控制 UI 设置中粘贴相同的令牌（或使用一次性 ?token=... 链接刷新）。
• 仍然卡住？运行 openclaw status --all 并按故障排除操作。参阅仪表板了解认证详情。

​

我设置了 gateway.bind: “tailnet” 但无法绑定 / 什么都没监听

• 在该主机上启动 Tailscale（使其拥有 100.x 地址），或
• 切换到 gateway.bind: "loopback" / "lan"。

​

可以在同一主机上运行多个 Gateway网关吗

• OPENCLAW_CONFIG_PATH（每实例配置）
• OPENCLAW_STATE_DIR（每实例状态）
• agents.defaults.workspace（工作区隔离）
• gateway.port（唯一端口）

• 每实例使用 openclaw --profile <name> …（自动创建 ~/.openclaw-<name>）。
• 在每个配置文件配置中设置唯一的 gateway.port（或手动运行时传 --port）。
• 安装每配置文件的服务：openclaw --profile <name> gateway install。

​

“invalid handshake” / code 1008 是什么意思

• 你在浏览器中打开了 HTTP URL（http://...）而不是 WS 客户端。
• 你使用了错误的端口或路径。
• 代理或隧道剥离了认证头或发送了非 Gateway网关请求。

1. 使用 WS URL：ws://<host>:18789（或 wss://... 如果 HTTPS）。
2. 不要在普通浏览器标签页中打开 WS 端口。
3. 如果认证已启用，在 connect 帧中包含令牌/密码。

openclaw tui --url ws://<host>:18789 --token <token>

​

日志与调试

​

日志在哪里

/tmp/openclaw/openclaw-YYYY-MM-DD.log

openclaw logs --follow

• macOS：$OPENCLAW_STATE_DIR/logs/gateway.log 和 gateway.err.log（默认：~/.openclaw/logs/...；配置文件使用 ~/.openclaw-<profile>/logs/...）
• Linux：journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager
• Windows：schtasks /Query /TN "OpenClaw Gateway网关 (<profile>)" /V /FO LIST

​

如何启动/停止/重启 Gateway网关服务

openclaw gateway status
openclaw gateway restart

​

我在 Windows 上关闭了终端——如何重启 OpenClaw

wsl
openclaw gateway status
openclaw gateway restart

openclaw gateway run

openclaw gateway status
openclaw gateway restart

openclaw gateway run

​

Gateway网关已启动但回复始终不到达，应该检查什么

openclaw status
openclaw models status
openclaw channels status
openclaw logs --follow

• 模型认证未在 Gateway网关主机上加载（检查 models status）。
• 渠道配对/允许列表阻止回复（检查渠道配置 + 日志）。
• WebChat/仪表板打开但没有正确的令牌。

​

“Disconnected from gateway: no reason”——怎么办

1. Gateway网关在运行吗？openclaw gateway status
2. Gateway网关健康吗？openclaw status
3. UI 有正确的令牌吗？openclaw dashboard
4. 如果是远程，隧道/Tailscale 链接正常吗？

openclaw logs --follow

​

Telegram setMyCommands 因网络错误失败，应该检查什么

openclaw channels status
openclaw channels logs --channel telegram

​

TUI 没有输出，应该检查什么

openclaw status
openclaw models status
openclaw logs --follow

​

如何完全停止然后启动 Gateway网关如果你安装了服务：

openclaw gateway stop
openclaw gateway start

openclaw gateway run

​

通俗解释：openclaw gateway restart 与 openclaw gateway

• openclaw gateway restart：重启后台服务（launchd/systemd）。
• openclaw gateway：在这个终端会话中前台运行 Gateway网关。

​

出现故障时获取更多详情的最快方法是什么

​

媒体与附件

​

我的 Skills 生成了图片/PDF，但什么都没发送

openclaw message send --target +15555550123 --message "Here you go" --media /path/to/file.png

• 目标渠道支持出站媒体且未被允许列表阻止。
• 文件在提供商的大小限制内（图片会调整到最大 2048px）。

​

安全与访问控制

​

将 OpenClaw 暴露给入站私信安全吗

• 支持私信的渠道上的默认行为是配对：
  • 未知发送者会收到配对码；机器人不处理他们的消息。
  • 批准方式：openclaw pairing approve <channel> <code>
  • 每个渠道的待处理请求上限为 3 个；如果没收到代码，检查 openclaw pairing list <channel>。
• 公开开放私信需要明确选择加入（dmPolicy: "open" 且允许列表 "*"）。

​

提示注入只对公开机器人有影响吗

• 使用只读或禁用工具的”阅读器”智能体来总结不可信内容
• 对启用工具的智能体关闭 web_search / web_fetch / browser
• 沙箱隔离和严格的工具允许列表

​

我的机器人应该有自己的邮箱、GitHub 账户或电话号码吗

​

我能让它自主管理我的短信吗？这安全吗

• 将私信保持在配对模式或严格的允许列表中。
• 如果你希望它代表你发消息，使用独立的号码或账户。
• 让它起草，然后发送前批准。

​

个人助理任务可以使用更便宜的模型吗

​

我在 Telegram 中运行了 /start 但没收到配对码

openclaw pairing list telegram

​

WhatsApp：会给我的联系人发消息吗？配对如何工作

openclaw pairing approve whatsapp <code>

openclaw pairing list whatsapp

​

聊天命令、中止任务和”停不下来”

​

如何阻止内部系统消息显示在聊天中

/verbose off
/reasoning off

​

如何停止/取消正在运行的任务

stop
abort
esc
wait
exit
interrupt

process action:kill sessionId:XXX

​

如何从 Telegram 发送 Discord 消息？（“Cross-context messaging denied”）

{
  agents: {
    defaults: {
      tools: {
        message: {
          crossContext: {
            allowAcrossProviders: true,
            marker: { enabled: true, prefix: "[from {channel}] " },
          },
        },
      },
    },
  },
}

​

为什么感觉机器人”忽略”了快速连发的消息

• steer - 新消息重定向当前任务
• followup - 逐条处理消息
• collect - 批量消息并回复一次（默认）
• steer-backlog - 立即转向，然后处理积压
• interrupt - 中止当前运行并重新开始

​

从截图/聊天记录中准确回答问题