常见问题 - OpenClaw官网中文版

📦产品基础

OpenClaw 是什么？它和 ChatGPT 有什么区别？

OpenClaw 是一个开源的 AI 助手框架，核心区别在于：ChatGPT 是一个聊天界面，只能回答问题；而 OpenClaw 是一个 AI 代理平台，能够真正执行任务——调用外部服务、操作文件、发送消息、执行代码等。此外，OpenClaw 完全开源免费，支持接入任意 AI 模型（包括国产模型），并可以本地私有化部署。

OpenClaw 中文版和官方原版有什么区别？

OpenClaw 中文版（openclaw-cn）是由中文社区维护的本地化版本，与官方原版每小时自动同步更新，功能完全一致。主要额外提供：内置钉钉、飞书、企业微信、QQ 平台支持；针对国内网络环境（DNS、连接超时等）的专项优化；全界面中文化；以及针对国内用户整理的中文文档和教程。

OpenClaw 支持哪些操作系统？

支持 Windows 10/11、macOS 12 及以上版本、Ubuntu 20.04+、Debian 11+ 等主流 Linux 发行版。基于 Node.js 运行，理论上支持所有能运行 Node.js v18+ 的系统。

OpenClaw 有移动端 App 吗？

OpenClaw 本身没有独立的移动端 App，但你可以通过接入钉钉、飞书、企业微信等移动端 App 来使用 OpenClaw 的功能。在这些 App 中 @机器人，即可通过移动端享受 AI 助手服务。

⚙️安装配置

安装时提示 EACCES 权限错误怎么办？

Windows 用户：以管理员身份运行 PowerShell（右键 → 以管理员身份运行），然后重新执行安装命令。

macOS/Linux 用户：在命令前加 sudo，即 sudo npm install -g openclaw-cn。如果不想使用 sudo，可以参考 npm 官方文档配置全局包目录。

npm 下载速度太慢，安装失败怎么处理？

切换到淘宝 npm 镜像可以大幅提升国内下载速度：

npm config set registry https://registry.npmmirror.com

设置后重新运行安装命令。如果需要恢复官方源：npm config set registry https://registry.npmjs.org

运行 openclaw 命令提示 command not found？

这是因为 npm 全局包的安装路径未加入系统 PATH。

运行 npm bin -g 查看全局安装路径，然后将该路径添加到系统环境变量中。

Windows：在「系统属性 → 环境变量 → Path」中添加该路径。
macOS/Linux：在 ~/.bashrc 或 ~/.zshrc 中添加 export PATH="$PATH:$(npm bin -g)"。

🤖模型接入

在中国大陆如何使用 Claude API？

Claude API 的服务器在境外，国内直连可能不稳定。推荐两种方案：

1. 使用 API 中转服务：国内有不少提供 Anthropic API 中转的服务商，在 config.yml 中配置 base_url 指向中转地址即可。

2. 改用国内模型：DeepSeek、通义千问等国产模型在国内直连稳定，且价格便宜，功能接近 Claude。推荐新手优先使用 DeepSeek V3。

可以同时接入多个 AI 模型吗？

可以。OpenClaw 支持在 config.yml 中配置多个模型，并通过指令切换。例如，日常任务用 DeepSeek（便宜），复杂代码分析时切换到 Claude（更强）。在对话中发送 /model deepseek 或 /model claude 即可切换。

支持完全离线使用本地模型吗？

支持。配合 Ollama 在本地运行 DeepSeek、Qwen、Llama 等开源模型，即可实现完全离线的 AI 助手，所有数据不出本机。配置方法：安装 Ollama 并拉取模型后，在 config.yml 中设置 provider: ollama 和 base_url: http://localhost:11434。

📱平台接入

配置钉钉后机器人无响应怎么排查？

按以下步骤排查：

1. 确认 OpenClaw 服务正在运行：openclaw status
2. 确认 Webhook URL 完整复制，末尾没有多余空格
3. 如安全类型选择了「加签」，确认 config.yml 中填写了对应 secret
4. 查看 OpenClaw 日志：openclaw logs，查找报错信息
5. 确认在钉钉群中正确 @了机器人名称

一个 OpenClaw 实例可以同时接入多个平台吗？

可以。在 config.yml 的 platforms 部分同时配置多个平台即可，OpenClaw 会同时监听所有配置的平台。一个实例可以同时接入钉钉、飞书、微信、CLI 等多个渠道，它们共享同一个 AI 模型配置。

🔒数据安全

我的对话内容会被收集吗？

OpenClaw 本身是开源软件，不收集任何用户数据，源代码完全透明可查。

需要注意的是：如果你使用云端 AI 模型（如 Claude、GPT-4、DeepSeek），你的对话内容会按照各模型服务商的隐私政策处理——这与直接使用它们的官方产品一样。如果需要最高级别的数据安全，请使用完全本地的开源模型（通过 Ollama 运行），数据不出本机。

企业内网可以部署 OpenClaw 吗？数据会出网吗？

完全可以。OpenClaw 支持在完全隔离的内网环境中运行。配合本地模型（Ollama + DeepSeek/Qwen），整个系统不需要任何外部网络连接，所有数据保留在内网中。这是金融、医疗、政务等对数据合规要求严格的行业的推荐部署方案。

💰费用相关

OpenClaw 是免费的吗？有什么收费项目？

OpenClaw 软件本身完全免费，永久开源，没有任何订阅费或使用费。

唯一的费用来源是你选择的 AI 模型 API 调用费用，这是你直接支付给 AI 模型服务商（如 DeepSeek、Anthropic、OpenAI 等）的，与 OpenClaw 无关。如果使用完全本地的开源模型（Ollama），则连 API 费用都没有，真正零成本。

使用 DeepSeek API 大概需要多少费用？

DeepSeek V3 API 定价极低，约为 0.14 元/百万 tokens（输入），0.28 元/百万 tokens（输出）。日常使用（每天 100-200 次对话）每月费用通常不超过 5-10 元人民币。相比 ChatGPT Plus 的 140 元/月，性价比极高。可以在 DeepSeek 官网注册并充值，新用户还有免费额度赠送。