OpenClaw 热搜问答

OpenClaw 是一款开源的个人 AI 助手，你可以在自己的设备上本地运行。与 ChatGPT 的主要区别：
1. 自托管：OpenClaw 运行在你的设备上，数据由你掌控，而 ChatGPT 是云端服务。
2. 多渠道：OpenClaw 可以连接 WhatsApp、Telegram、Slack、Discord、微信等 20+ 平台，你在任何常用 App 里都能和 AI 对话；ChatGPT 主要通过官方网页和 App。
3. 可扩展：OpenClaw 支持 Skills 技能系统，社区提供了 100+ 个插件，功能可以无限扩展。
4. 多模型：你可以配置多个 AI 模型提供商，不限于某一家。

OpenClaw 本身完全免费、开源（MIT 协议），没有任何隐藏收费。但你需要注意：
- 使用 OpenAI、Claude 等云端 AI 模型需要购买对应的 API 额度，费用取决于使用量。
- 如果使用 Ollama 等本地模型，则完全免费，只需要你的硬件算力。
- 通信渠道（WhatsApp、Telegram 等）本身是免费的。

OpenClaw 的界面目前主要是英文，但 AI 助手的对话完全支持中文。你用中文发消息，AI 会用中文回复。社区正在推进国际化（i18n）支持（见 GitHub Issue #3460），未来 UI 界面也将提供中文翻译。此外，飞书（Feishu）、微信等中文平台的渠道适配也在持续完善中。

OpenClaw 适合以下用户：
- 注重隐私的用户：所有数据本地处理，不经过第三方服务器。
- 多平台用户：希望在 WhatsApp、Telegram、Slack 等不同平台统一使用 AI 助手。
- 开发者和极客：喜欢自托管、可定制、可扩展的工具。
- 团队用户：需要在 Slack、Discord、Teams 等协作工具中集成 AI 能力。
- 对 ChatGPT 等商业服务有使用限制或审查顾虑的用户。

截至 2026 年 3 月，OpenClaw 在 GitHub 上拥有近 30 万颗 Stars，是全球最受欢迎的开源 AI 项目之一。主要原因：
1. 解决了"AI 助手只能在特定 App 使用"的痛点，让 AI 无处不在。
2. 完全开源、可自托管，符合隐私至上的趋势。
3. 活跃的社区和丰富的 Skills 生态。
4. 支持平台广泛，从 WhatsApp 到 Discord 到飞书全覆盖。

两者定位不同：
- Open WebUI 是一个 AI 聊天网页界面，主要通过浏览器访问，类似自托管版 ChatGPT 界面。
- OpenClaw 是一个 AI 助手平台，核心是将 AI 集成到你已有的通信渠道中（WhatsApp、Telegram 等），不需要打开额外网页。
- 如果你想要一个好看的聊天 UI → 选 Open WebUI。
- 如果你想让 AI 融入日常通讯工具 → 选 OpenClaw。
- 两者也可以搭配使用，互不冲突。

OpenClaw 支持以下平台：
- macOS：原生支持，体验最佳，包括语音交互功能。
- Linux：完整支持，推荐作为服务器部署方案。
- Windows：通过 WSL2（Windows Subsystem for Linux 2）运行，强烈建议不要在原生 Windows 环境直接运行。
运行要求：Node.js >= 22。

安装步骤：
第 1 步：安装 Node.js 22+ curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs 第 2 步：全局安装 OpenClaw npm install -g openclaw@latest 第 3 步：运行引导向导（推荐） openclaw onboard --install-daemon 向导会引导你配置 Gateway、工作区、渠道和初始 Skill。完成后 OpenClaw 就会作为系统服务持续运行。

这是 npm 全局安装的权限问题，常见解决方案：
方案一（推荐）：修改 npm 全局目录 mkdir ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc npm install -g openclaw@latest 方案二：使用 pnpm 或 bun pnpm add -g openclaw@latest # 或 bun add -g openclaw@latest 不建议使用 sudo npm install -g，可能导致后续权限问题。

强烈建议通过 WSL2 安装，步骤如下：
1. 打开 PowerShell（管理员），运行 wsl --install 安装 WSL2。
2. 重启后打开 Ubuntu 终端。
3. 在 WSL2 中安装 Node.js 22 和 OpenClaw： curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs npm install -g openclaw@latest openclaw onboard --install-daemon 原生 Windows（非 WSL）可能遇到兼容性问题，官方不推荐。

# 更新到最新稳定版 openclaw update --channel stable # 更新后检查状态 openclaw doctor # 也可以选择其他频道 openclaw update --channel beta # 预发布版 openclaw update --channel dev # 开发版 如果 openclaw update 命令不可用，也可以用 npm 重新安装： npm install -g openclaw@latest

OpenClaw 本身非常轻量，Gateway 运行只需：
- CPU：任意现代处理器即可。
- 内存：Gateway 本身约占 100-200MB，如果同时运行 Ollama 本地模型则需要更多内存（建议 16GB+）。
- 存储：安装约 500MB，日志和数据随使用增长。
- 网络：需要稳定的网络连接来对接通信渠道和云端 AI 模型。
如果只使用云端模型（如 OpenAI），普通笔记本即可流畅运行。

git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install pnpm build 从源码安装适合开发者或需要修改源码的用户。普通用户建议直接用 npm install -g openclaw@latest。

Gateway 是 OpenClaw 的核心控制平面，负责：
- 管理所有通信渠道的连接（WhatsApp、Telegram 等）。
- 路由消息到 AI 助手并返回回复。
- 管理 Skills 技能的加载和执行。
- 处理设备注册和认证。
Gateway 作为后台服务持续运行（通过 launchd 或 systemd），确保你的 AI 助手始终在线。它默认监听端口 18789。

端口 18789 被占用，解决方案：
方案一：找到并关闭占用进程 # 查看占用端口的进程 lsof -i :18789 # 关闭对应进程 kill -9 <PID> 方案二：更换端口 openclaw gateway --port 18790 --verbose 更换端口后需要更新所有渠道和客户端的配置地址。

使用 openclaw onboard --install-daemon 会自动配置系统服务：
- macOS：通过 launchd 注册，开机自动启动。
- Linux：通过 systemd 注册，可用 systemctl status openclaw-gateway 查看状态。
- 如果需要手动管理： # 查看 Gateway 状态 openclaw gateway status # 手动启动 openclaw gateway --port 18789 --verbose # 停止 openclaw gateway stop

这表示你的设备还没有与 Gateway 完成配对。解决方法：
1. 运行 openclaw onboard 重新执行引导向导。
2. 或手动配对设备：openclaw device pair。
3. 检查 ~/.openclaw/openclaw.json 中是否有正确的设备配置。
4. 如果反复出现，尝试删除旧的配对信息后重新配对： openclaw device list openclaw device remove <device-id> openclaw device pair

# 启动时加 --verbose 查看详细日志 openclaw gateway --port 18789 --verbose # 查看日志文件 ls ~/.openclaw/logs/ # 实时查看日志 tail -f ~/.openclaw/logs/gateway.log # 使用 doctor 命令诊断 openclaw doctor openclaw doctor 会检查 Gateway、渠道、模型等配置状态，帮助定位问题。

默认 Gateway 只监听本地（localhost）。如果需要远程访问：
1. 修改 Gateway 绑定地址为 0.0.0.0。
2. 强烈建议通过反向代理（如 Nginx）+ HTTPS + 认证来保护暴露的端口。
3. 或使用 VPN/SSH 隧道安全访问。
直接将 Gateway 暴露到公网是不安全的，可能导致未授权访问。

截至 2026 年 3 月，OpenClaw 支持 20+ 通信渠道：
即时通讯：WhatsApp、Telegram、Signal、iMessage、LINE、Zalo
团队协作：Slack、Discord、Microsoft Teams、Google Chat、Mattermost、Matrix
中文平台：飞书（Feishu）、钉钉（DingTalk，社区贡献中）
其他：IRC、Twitch、Nostr、Nextcloud Talk、Synology Chat、WebChat
语音：macOS/iOS/Android 语音输入输出

WhatsApp 是 OpenClaw 最热门的渠道之一。连接步骤：
1. 在 onboard 向导中选择 WhatsApp 渠道。
2. 扫描终端显示的二维码（类似 WhatsApp Web 的配对方式）。
3. 配对成功后，你的 WhatsApp 就拥有了 AI 助手功能。
注意：WhatsApp 渠道使用的是 Web 协议，需要手机保持联网。每次重启 Gateway 可能需要重新配对。

1. 在 Telegram 中找到 @BotFather，创建一个新 Bot，获取 Bot Token。
2. 运行 OpenClaw 渠道配置： openclaw channel add telegram --token YOUR_BOT_TOKEN 3. 配置完成后，发消息给你的 Bot 即可与 AI 助手对话。
Telegram 渠道稳定性最好，推荐新手首选。

飞书渠道支持已内置，步骤：
1. 在飞书开放平台创建自建应用，获取 App ID 和 App Secret。
2. 配置事件订阅地址（指向你的 Gateway 地址）。
3. 在 OpenClaw 中添加飞书渠道： openclaw channel add feishu --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET 4. 在飞书中添加你的应用为好友，即可开始对话。
钉钉（DingTalk）支持正在由社区开发中（见 Issue #26534）。

可以。OpenClaw 支持同时连接多个渠道，所有渠道共享同一个 AI 助手的上下文和能力。比如你可以同时启用 WhatsApp + Telegram + Slack，在任何一个平台发消息都能得到 AI 回复。
每个渠道独立配置、独立管理，互不影响。用 openclaw channel list 查看所有已配置的渠道。

微信的对接相对复杂，因为微信官方没有开放的 Bot API。社区常见方案：
1. 通过第三方微信机器人框架（如 wechaty）桥接到 OpenClaw。
2. 使用企业微信（企微）的开放 API 进行对接。
3. 部分社区 Skills 提供了微信适配功能。
注意：个人微信的非官方自动化可能违反腾讯服务条款，有封号风险，建议评估后使用。

常见排查步骤：
1. 确认 Bot Token 正确且 Bot 已被邀请到目标服务器。
2. 检查 Bot 是否有"发送消息"和"读取消息"权限。
3. 确认 Gateway 正在运行：openclaw gateway status。
4. 查看日志：openclaw gateway --verbose 看是否有报错。
5. 确认 AI 模型配置正确且有可用额度。
6. 尝试重启 Gateway 后再测试。

OpenClaw 支持多种模型提供商：
- OpenAI：GPT-4o、GPT-4、GPT-3.5 等。
- Anthropic：Claude 系列模型。
- 本地模型：通过 Ollama 运行 DeepSeek、Llama、Qwen、Mistral 等开源模型。
- 其他：任何兼容 OpenAI API 格式的服务都可以对接。
支持配置多个模型，设置优先级和故障转移策略，确保助手始终可用。

在 onboard 向导中会提示输入 API Key，也可以手动配置： # 通过命令行配置 openclaw config set model.openai.apiKey sk-xxxxxxxx # 或编辑配置文件 ~/.openclaw/openclaw.json # 在 models 字段中添加 OpenAI 配置 支持 OAuth 和 API Key 两种认证方式。建议使用官方推荐的最新一代模型以获得最佳体验。

1. 先安装并启动 Ollama（参考我们的 Ollama 详细介绍）： ollama serve ollama pull deepseek-r1:7b 2. 在 OpenClaw 中配置 Ollama 作为模型提供商： openclaw config set model.ollama.baseUrl http://localhost:11434 openclaw config set model.ollama.model deepseek-r1:7b 使用本地模型完全免费，但需要足够的 GPU/CPU 算力。推荐 16GB 以上内存。

这是一个已知问题（见 GitHub Issue #32828），可能的解决方案：
1. 检查你的 API Key 是否有足够的额度和速率限制。
2. 尝试更新到最新版 OpenClaw：openclaw update --channel stable。
3. 清除缓存：检查 ~/.openclaw/ 下是否有过期的缓存文件。
4. 如果使用多个模型，确认故障转移配置正确。
5. 查看 Gateway 日志确认实际的 API 响应内容。
该 Issue 目前有 47 条评论，社区正在积极修复中。

OpenClaw 支持配置多个模型提供商，当主模型不可用时自动切换到备用模型：
1. 配置多个模型提供商（如 OpenAI + Ollama）。
2. 设置优先级，主模型故障时自动使用备用模型。
3. 可在 ~/.openclaw/openclaw.json 的 models 配置中定义。
这样即使某个 API 服务中断，你的 AI 助手也不会停止工作。

Skills（技能）是 OpenClaw 的插件系统，让 AI 助手获得额外能力。例如：
- 浏览器自动化：让 AI 帮你浏览网页、填表、截图。
- 社交媒体：自动发推文、管理 LinkedIn、发 Instagram 帖子。
- 开发工具：执行代码、管理 Git 仓库、部署应用。
- 金融交易：查看行情、执行交易策略。
社区提供了 100+ 个 Skills，详见我们的 OpenClaw Skills 大全。

# 搜索可用的 Skills openclaw skill search browser # 安装 Skill openclaw skill install @anthropic/browser-automation # 查看已安装的 Skills openclaw skill list # 卸载 Skill openclaw skill uninstall @anthropic/browser-automation 安装后的 Skill 会自动注册到 AI 助手，你可以在对话中直接使用相关功能。

新手推荐安装以下 Skills：
1. 浏览器自动化：让 AI 帮你浏览和操作网页。
2. 记忆管理：让 AI 记住你的偏好和历史对话。
3. 日程管理：与日历集成，管理待办事项。
4. 文件管理：让 AI 操作本地文件。
5. 代码执行：让 AI 编写和运行代码片段。
完整推荐列表请查看 Skills 大全文章，按 15 大分类整理了 100+ 个精选 Skills。

可以。OpenClaw Skills 使用 TypeScript/JavaScript 编写，遵循标准的 Skill 接口：
1. 创建 Skill 项目：openclaw skill create my-skill。
2. 实现 Skill 接口，定义输入/输出和执行逻辑。
3. 本地测试：openclaw skill test my-skill。
4. 发布到社区（可选）：openclaw skill publish。
详细开发文档请参考 docs.openclaw.ai。

排查步骤：
1. 确认 Skill 已正确安装：openclaw skill list 查看状态。
2. 重启 Gateway 使 Skill 生效。
3. 检查 Skill 是否有额外的配置要求（如 API Key、权限等）。
4. 查看日志中是否有 Skill 加载错误：openclaw gateway --verbose。
5. 尝试卸载后重新安装该 Skill。
6. 确认 OpenClaw 版本与 Skill 版本兼容。

支持。OpenClaw 在以下平台提供语音交互功能：
- macOS：原生语音输入和输出，体验最佳。
- iOS：通过 Clawdbot App 支持语音。
- Android：通过 Clawdbot App 支持语音。
你可以像和 Siri、Google Assistant 一样，用语音和 AI 助手对话。语音功能依赖语音识别（STT）和语音合成（TTS）服务。

Canvas 是 OpenClaw 的实时交互画布，AI 可以在画布上渲染富媒体内容：
- 生成图表和数据可视化。
- 展示代码执行结果。
- 创建交互式表单。
- 渲染 HTML/CSS 内容预览。
Canvas 内容可以通过 WebChat 渠道或 Clawdbot App 访问。这让 AI 助手不仅能发文字消息，还能创建丰富的视觉内容。

Clawdbot 是 OpenClaw 的官方客户端 App：
- macOS：目前可用，支持语音和 Canvas。
- iOS：可从 App Store 搜索 "Clawdbot"。
- Android：可从 Google Play 搜索 "Clawdbot"。
- Linux/Windows：桌面客户端正在开发中（见 Issue #75），目前可通过 WebChat 渠道访问。

语音延迟主要来自三个环节：
1. 语音识别（STT）：确保使用快速的 STT 服务，本地 Whisper 比云端更快。
2. AI 模型响应：使用响应更快的模型（如 GPT-4o-mini 比 GPT-4 快）；或使用本地 Ollama 模型。
3. 语音合成（TTS）：使用低延迟的 TTS 服务。
综合优化建议：尽量使用本地模型 + 本地 STT/TTS，可以将往返延迟控制在 1-2 秒以内。

OpenClaw 的安全设计：
- 本地运行：Gateway 和数据存储在你的设备上，不经过 OpenClaw 官方服务器。
- 端到端：消息从通信渠道直达你的本地 Gateway。
- 开源透明：所有代码公开可审计。
- 需注意：如果使用 OpenAI 等云端模型，你的对话内容会发送到模型提供商的服务器。如果想要完全私密，使用 Ollama 本地模型。

提示注入是指恶意用户通过特殊构造的消息，试图让 AI 执行非预期的操作。OpenClaw 的防范措施：
- 官方建议使用最新一代的强模型，它们对提示注入有更好的抵抗力。
- Skills 系统有权限控制，敏感操作需要确认。
- 可以配置消息过滤规则。
- 建议定期更新到最新版以获得安全修复。

API Key 存储在本地配置文件 ~/.openclaw/openclaw.json 中：
- 文件权限默认为当前用户可读写（600）。
- 不会上传到任何远程服务器。
- 建议定期轮换 API Key。
- 如果服务器被入侵，攻击者可能获取该文件，建议做好系统级安全防护。
- 不要将 openclaw.json 提交到 Git 仓库或分享给他人。

OpenClaw 设计为个人单用户 AI 助手，企业使用需要注意：
- 每个实例服务一个用户，多用户需要多实例部署。
- 没有内置的多租户、RBAC 等企业级功能。
- 适合开发者个人使用或小团队内部部署。
- 大规模企业部署建议评估合规和安全需求后决定。
- 企业可以将其部署在内网环境中，通过 Slack/Teams 渠道供团队成员使用。

OpenClaw 的所有数据存储在 ~/.openclaw/ 目录下，备份该目录即可： # 备份 cp -r ~/.openclaw/ ~/openclaw-backup-$(date +%Y%m%d) # 恢复 cp -r ~/openclaw-backup-YYYYMMDD/ ~/.openclaw/ 关键文件：
- openclaw.json：主配置文件（含 API Key，注意保密）。
- workspace/：工作区数据。
- memory/：AI 记忆数据。
- logs/：日志文件（可选备份）。

可以。OpenClaw 内置了 Cron 定时任务功能：
- 定时发送提醒消息。
- 定期执行 Skills（如每天早上发送天气预报）。
- 定期运行数据采集或报告生成任务。
配置方式：在 ~/.openclaw/cron/ 目录下定义定时任务，使用标准 Cron 表达式设定执行时间。

Workspace 是 OpenClaw 的隔离运行环境：
- 每个 Workspace 有独立的配置、Skills 和上下文。
- 可以为不同用途创建不同的 Workspace（如"工作"和"生活"）。
- 默认有一个主 Workspace，也可以有 dev 版的 workspace-dev。
- 在 ~/.openclaw/workspace/ 目录下管理。

OpenClaw 内置了浏览器自动化能力：
1. 确保配置中启用了 browser："browser": { "enabled": true }。
2. 安装浏览器自动化相关 Skills。
3. 配置 Chrome 的远程调试端口（CDP）： # 启动 Chrome 并开启远程调试 google-chrome --remote-debugging-port=18800 4. 在对话中可以让 AI 执行浏览器操作，如打开网页、点击按钮、填写表单、截图等。
OpenClaw 使用 Chrome DevTools Protocol（CDP）与浏览器通信，支持 headless 和有界面两种模式。

OpenClaw 的 agent 命令支持 thinking 参数，控制 AI 的推理深度： # 高深度思考（适合复杂问题） openclaw agent --message "分析这段代码的性能瓶颈" --thinking high # 标准模式（默认） openclaw agent --message "今天天气怎么样" # 低延迟模式（快速回复） openclaw agent --message "你好" --thinking low 高 thinking 模式会让 AI 花更多时间分析和推理，适合需要深度分析的复杂任务。

这是社区中一个热门 Issue（#39651），描述的是 AI 助手只生成文字回复但不执行实际操作的问题。可能原因和解决方案：
1. Skills 未正确加载：检查 openclaw skill list，确认需要的 Skills 已安装且状态正常。
2. 权限不足：某些 Skills 需要额外的权限配置（如浏览器权限、文件系统权限）。
3. 模型能力不足：较弱的模型可能无法正确调用工具，建议升级到更强的模型。
4. 版本回归：某些版本可能存在 bug，尝试更新到最新版：openclaw update --channel stable。
该 Issue 目前有 29 条评论，被标记为 regression（回归 bug），团队正在修复。