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 --versionopenclaw 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 1000openclaw 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"

下一步建议

FAQ

本页常见问题

因为很多问题并不需要一整篇文章才能回答,但又会被反复问到,集中整理更适合反复回查。