工具模板页 · OpenClaw

OpenClaw 从下载到第一次使用

OpenClaw 是一个运行在你自己设备上的个人 AI 助手。它可以接入消息渠道,也可以作为 Agent 帮你处理任务。小白建议:先装 CC Switch 完成 fululai API 一键导入,再按本页安装 OpenClaw。

适合谁?

想要一个能长期运行、能连接消息渠道、能帮你执行任务的个人 AI 助手。

难度提醒

OpenClaw 官方推荐终端安装,需要复制命令。完全不想碰终端的用户,先装 CC Switch,再让客服/教程教程指导。

fululai 的作用

fululai 提供 API Key 和模型能力。CC Switch 负责把这些配置导入 OpenClaw 相关工具链。

使用工具前的准备事项

先准备 fululai API,再启动 OpenClaw

  1. 安装 CC Switch。
  2. 进入 fululai 控制台 → API 密钥。
  3. 创建 API Key。
  4. 点击「导入到 CCS」。
  5. 在 CC Switch 里确认 fululai 供应商已导入并激活。
  6. 再安装 / 启动 OpenClaw。
为什么先做这一步?
因为 OpenClaw / Claude Code / Codex 这类工具的配置方式不同。CC Switch 可以帮你统一管理,避免小白到每个工具里找 API Key、Base URL、模型名。

第一步:先看有没有桌面安装包

OpenClaw GitHub 最新 Release 当前主要看到 macOS 安装包:

文件适合谁说明
OpenClaw-2026.5.7.dmgmacOS 用户推荐,双击安装。
OpenClaw-2026.5.7.zipmacOS 备用如果 dmg 不能用,再试 zip。
dSYM.zip开发者不要下载,这是调试文件。
不要点 Source code
Source code 是源码,不是给小白直接安装的软件。
打开 OpenClaw 最新下载页

第二步:如果没有适合你的安装包,就用终端安装

OpenClaw 官方推荐方式是通过命令安装。

终端是什么?
终端就是电脑里的命令输入框。你不是在写代码,只是在复制一条安装命令,让电脑帮你下载和安装。

macOS 怎么打开终端

按 Command + 空格,输入「终端」或 Terminal,回车打开。

Windows 怎么打开终端

普通方式:按 Windows 键,搜索「PowerShell」或「终端 / Windows Terminal」,回车打开。
OpenClaw 更推荐:README 建议 Windows 通过 WSL2 使用。装过 WSL2 的用户,打开「Ubuntu」应用再复制命令;没装过就先使用普通 PowerShell 方式,或者查看 WSL2 安装教程。

第三步:安装 Node.js

OpenClaw 需要 Node 24,或者 Node 22.16+。

Node.js 是什么?
它是运行 OpenClaw 需要的基础环境。可以理解成 OpenClaw 的“发动机”。

小白方式

去 Node.js 官网下载安装 LTS 或新版。

打开 Node.js 官网

会用命令的方式

如果你已经会 Homebrew / nvm,可以用自己熟悉的方式安装 Node 24。

第四步:安装 OpenClaw

复制下面命令到终端,按回车。

npm install -g openclaw@latest
看见代码不用慌:这不是让你写代码,只是复制安装命令。等待它跑完,如果没有红色报错,通常就是成功。

第五步:启动 OpenClaw 向导

安装完成后,继续复制这条命令:

openclaw onboard --install-daemon
Onboard 是什么?
就是新手配置向导。它会一步步带你设置 gateway、workspace、channels、skills。你按提示走即可。

如果它问模型或供应商,优先选择你通过 CC Switch 导入/激活的 fululai 配置。

第六步:检查是否安装成功

复制下面命令:

openclaw doctor
doctor 是什么?
它不是医生,是“检查工具”。会告诉你 OpenClaw 当前配置哪里正常、哪里有问题。

第七步:复制第一个任务模板测试

配置成功后,先不要做复杂任务,复制这个测试:

请帮我检查当前项目的结构,并用小白能听懂的话告诉我每个文件夹是做什么的。

常见问题

问题原因解决
npm 命令不存在Node.js 没装好先安装 Node.js,再重新打开终端。
openclaw 命令不存在安装没成功,或终端没刷新重新运行 npm install,或关闭终端重新打开。
API 不生效CC Switch 没激活 fululai 或工具未重启回 CC Switch 激活 fululai,然后重启 OpenClaw。
余额不足 / 401fululai Key 或余额问题回 fululai 控制台检查 Key 和余额。