TOPIC / RESOURCE
OpenClaw 常见问题:安装、模型、渠道、技能、成本和安全怎么先想
这页把最常见的问题按安装、模型、渠道、技能、成本和安全六大主题分组整理,不求做到最全面的知识库,只求你能在装之前、配之前、扩之前先快速判断下一步该怎么走。每个问题都给出可直接参考的判断思路,帮你少走弯路、有效减少反复试错带来的时间和精力成本。
适合谁
- 不想为一个高频问题反复翻多篇文章
- 希望按安装、模型、渠道、技能、成本和安全快速回查
- 需要一页把最常见判断问题先收住
安装
-
第一次安装用什么命令?
macOS / Linux 推荐一键脚本:curl -fsSL https://openclaw.ai/install.sh | bash。Windows 用iwr -useb https://openclaw.ai/install.ps1 | iex。也可以npm install -g openclaw@latest再执行openclaw onboard --install-daemon。 -
Node 版本要求是多少?
Node.js ≥ 22,推荐 Node 24。用node -v确认。 -
安装完第一步做什么?
运行openclaw onboard --install-daemon,完成模型、API Key、消息平台、权限四项初始化。然后用openclaw --version和openclaw gateway status确认服务正常。 -
Docker 还是脚本安装更好?
第一次上手推荐一键脚本或 npm,更快。Docker 路线适合需要隔离环境或生产部署的场景。 -
怎么验证安装成功?
openclaw --version
openclaw gateway status
openclaw dashboard
openclaw doctor
Dashboard 默认地址是 http://127.0.0.1:18789/。
模型
-
第一次一定要最强模型吗?
不需要。先选稳定路线,再谈最强模型。 -
成本为什么会突然升高?
更常见的原因是上下文变长、工具调用变多和 fallback 触发。先用openclaw config set ai.dailyLimit 1000和openclaw config set ai.monthlyBudget 50设上限。 -
可以用本地模型吗?
可以,但更适合作为路线选择,不适合作为复杂任务的默认最优解。 -
怎么配置模型?
openclaw config set model.provider deepseek
openclaw config set model.api_key sk-***
openclaw config set model.name deepseek-chat
openclaw doctor
技术门槛
-
OpenClaw 的技术要求到底高不高?
它确实更适合能接受命令行、环境变量和 API Key 的人,但第一批真正需要的,不是"会很多技术",而是能把安装、初始化、渠道和技能的顺序跑顺。 -
Windows 可以直接用吗?
可以。用 PowerShell 运行iwr -useb https://openclaw.ai/install.ps1 | iex安装。更推荐配合 WSL 走 Linux 路线。
渠道
-
OpenClaw 支持多少个渠道?
12 个:WhatsApp、Telegram、Discord、Slack、飞书、钉钉、Signal、iMessage、Microsoft Teams、Google Chat、Matrix、WebChat。通过openclaw channels add向导配置。 -
第一个渠道先接什么?
先接你真的会看的入口,比如团队聊天工具,而不是先追最多集成。 -
飞书接入后第一步做什么?
先做最小消息闭环,再做一次正式初始化。飞书有官方插件@openclaw/feishu,通过openclaw plugins install @openclaw/feishu安装。
Skills
- 技能怎么安装?
openclaw skills install @clawhub/web-search
openclaw skills install @clawhub/browser
openclaw skills install @clawhub/summarize
openclaw skills list
-
ClawHub 上有多少技能?
目前 5,700+ 社区技能,每天新增 40-60 个,带 verified badge 的经过官方审核。 -
第一批技能装多少个合适?
通常 3 到 5 个基础技能更稳,覆盖搜索、浏览器和摘要三类能力就够了。 -
是不是技能越多越强?
不是。技能越多,权限越散,排障越难。
成本
-
成本控制是不是后面再看?
不是。模型路线一旦选错,后面所有链路都会被成本影响。 -
fallback 值不值得开?
值得,但不能开得太宽。它本质上是兜底,不是免费保险。 -
一个很粗的成本量级大概是多少?
轻度测试通常是低成本的;一旦跑定时任务、浏览器控制和长上下文,成本会迅速上来。先设日限额、月预算,再观察一周真实使用量。 -
怎么最省钱?
先缩模型路线、缩上下文、缩技能数量、缩 fallback 范围,再去优化更细的参数。
安全
-
OpenClaw 的安全模型是什么?
三层权限模型:Docker 网络隔离 → Sandbox 工具过滤 → Agent 工具权限。通过openclaw security audit --deep做深度审计。 -
为什么不能默认信任第三方 skill?
因为来源、权限、维护状态和依赖链都可能引入额外风险。优先选 ClawHub 上带 verified badge 的技能。 -
公网暴露是不是最常见的坑?
是其中一个,但同样常见的还有认证没开好、权限太宽和技能来源不清楚。Gateway 绑定127.0.0.1,生产环境关闭 Control UI。
调试与运维
- 遇到问题先做什么?
openclaw doctor
openclaw doctor --repair
openclaw gateway restart
openclaw logs --follow
openclaw config list
不要一上来就删目录或重装。
-
可以跑在服务器上吗?
可以,但服务器路线不只是"搬到云上",还多了系统更新、防火墙、认证和暴露面的问题。 -
怎么备份配置?
最简单就是先备份~/.openclaw,更稳的是再用 Git 做版本化备份。
cp -r ~/.openclaw ~/.openclaw-backup
cd ~/.openclaw
git init
git add .
git commit -m "Initial backup"
下一步建议
- 安装部署
- 模型选择
- 实战练习路线
- 排障入口
- 术语表
- 查看 OpenClaw 官方文档 → docs.openclaw.ai
- 遇到问题 → GitHub Issues
FAQ
本页常见问题
因为很多问题并不需要一整篇文章才能回答,但又会被反复问到,集中整理更适合反复回查。