Appearance
OpenClaw 安装与配置指南
通过 npm 安装 OpenClaw 命令行工具,并使用 CC Switch 接入自定义 API 供应商。
⚠️ 前置条件 必须先安装好 Python 和 Node.js,然后才能进行 OpenClaw 的安装。
目录
第一步:设置 PowerShell 执行策略
以管理员身份运行 PowerShell,依次执行以下两条命令:
powershell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUserpowershell
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(快速开始模式) |

🔐 官方推荐的安全基线:
- 配对 / 允许列表 + mention 门控
- 沙箱 + 最小权限工具
- 密钥不要放在 agent 可读取的文件系统中
- 带工具或不可信收件源的 bot 使用能力最强的模型
- 定期做安全审计
第四步:配置 CC Switch
一切完成后,去 CC Switch 中添加我们的配置。
4.1 选择 OpenClaw 图标
打开 CC Switch,在顶部图标栏中选中 OpenClaw 对应的图标(下图箭头所指),再点击供应商条目右侧的编辑按钮进入配置页。

4.2 填写供应商信息
在「编辑供应商」页面按下表填写:
| 字段 | 填写内容 | 说明 |
|---|---|---|
| 接口格式 | OpenAI Compatible | 选择 AI 服务的 API 接口格式 |
| API Key | 你的密钥 | 由服务方提供 |
| Base URL | https://www.fastaitoken.com | 自定义 API 端点地址 |
| 额外选项 | 键名 setCacheKey,值 true | 开启缓存键 |

填写完成后:
- 点击右侧 获取模型列表,自动拉取可用模型。
- 在「模型配置」区域选择 模型 ID 并填写 显示名称。
- 点击右下角 保存。
4.3 启用供应商
回到供应商列表,找到刚创建的条目(例如 fastaitoken),点击绿色的 + 添加 按钮完成启用。

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