Skip to content

OpenClaw 安装与配置指南

通过 npm 安装 OpenClaw 命令行工具,并使用 CC Switch 接入自定义 API 供应商。

⚠️ 前置条件 必须先安装好 PythonNode.js,然后才能进行 OpenClaw 的安装。


目录


第一步:设置 PowerShell 执行策略

管理员身份运行 PowerShell,依次执行以下两条命令:

powershell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
powershell
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

这两条命令的作用是允许当前用户运行本地和下载的脚本,否则 npm 全局安装的命令可能无法执行。


第二步:安装 OpenClaw

bash
npm install -g openclaw@latest

这一步即是下载安装 OpenClaw 本体。


第三步:验证与初始化

3.1 验证安装

下载完成后打开终端,输入:

bash
openclaw --version

能正常输出版本号即表示安装成功。

3.2 初始化配置

在终端中输入:

bash
openclaw onboard

按引导完成初始化,过程中会有两个关键选择:

提示含义建议选择
I understand this is powerful and inherently risky. Continue?提示使用 OpenClaw 会有一定风险,询问是否继续Yes
Onboarding mode选择引导模式QuickStart(快速开始模式)

OpenClaw onboard 引导界面:风险确认选 Yes,引导模式选 QuickStart

🔐 官方推荐的安全基线:

  • 配对 / 允许列表 + mention 门控
  • 沙箱 + 最小权限工具
  • 密钥不要放在 agent 可读取的文件系统中
  • 带工具或不可信收件源的 bot 使用能力最强的模型
  • 定期做安全审计

第四步:配置 CC Switch

一切完成后,去 CC Switch 中添加我们的配置。

4.1 选择 OpenClaw 图标

打开 CC Switch,在顶部图标栏中选中 OpenClaw 对应的图标(下图箭头所指),再点击供应商条目右侧的编辑按钮进入配置页。

CC Switch 顶部图标栏中选择 OpenClaw 对应的图标

4.2 填写供应商信息

在「编辑供应商」页面按下表填写:

字段填写内容说明
接口格式OpenAI Compatible选择 AI 服务的 API 接口格式
API Key你的密钥由服务方提供
Base URLhttps://www.fastaitoken.com自定义 API 端点地址
额外选项键名 setCacheKey,值 true开启缓存键

编辑供应商页面:填写接口格式、API Key、Base URL 与额外选项

填写完成后:

  1. 点击右侧 获取模型列表,自动拉取可用模型。
  2. 在「模型配置」区域选择 模型 ID 并填写 显示名称
  3. 点击右下角 保存

4.3 启用供应商

回到供应商列表,找到刚创建的条目(例如 fastaitoken),点击绿色的 + 添加 按钮完成启用。

供应商列表中点击绿色的添加按钮启用配置


第五步:启动使用

最后打开 OpenClaw,选择模型即可开始使用。


常见问题

问题排查方向
openclaw 命令找不到确认 Node.js 已加入 PATH;重开终端后重试
PowerShell 报脚本被禁止运行回到第一步,确认两条 Set-ExecutionPolicy 命令都执行成功
npm 安装缓慢或失败检查网络,或切换 npm 镜像源后重试
OpenClaw 中看不到模型确认 CC Switch 已保存并点击了 + 添加 启用供应商