大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



OpenClaw 是一款开源的本地 AI 助手，运行在你自己的电脑上，可通过 Web UI、Telegram、WhatsApp、Discord 等多种方式交互，实现文件操作、终端命令执行、浏览器控制等自动化任务。

• macOS 12 (Monterey) 或更高版本
• Node.js 环境（版本 22 或更高）
• 有效的 UniVibe API 密钥

1. 安装 Node.js 环境

OpenClaw 需要 Node.js 22 或更高版本才能运行。

方法一：使用 Homebrew（推荐）

如果你已经安装了 Homebrew，可以使用以下命令：

brew install node@22 

如果还没有安装 Homebrew，可以先安装它：

/bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)” 

方法二：官网下载

1. 访问 https://nodejs.org/
2. 点击 “LTS” 版本进行下载（确保版本 ≥ 22）
3. 下载完成后运行 .pkg 安装程序
4. 按照安装向导完成安装

验证 Node.js 安装

安装完成后，打开终端，输入以下命令：

node –version npm –version 

如果显示版本号（node 版本需 ≥ 22），说明安装成功了！

2. 安装 OpenClaw

打开终端，运行以下命令：

npm install -g openclaw 

这个命令会从 npm 官方仓库下载并安装最新版本的 OpenClaw。

验证 OpenClaw 安装

安装完成后，输入以下命令检查是否安装成功：

openclaw –version 

如果显示版本号，恭喜你！OpenClaw 已经成功安装了。

3. 获取 API 密钥

点击获取

4. 运行安装向导

首次使用 OpenClaw，建议运行安装向导：

openclaw onboard –install-daemon 

向导配置选项说明

向导会逐步引导你完成配置，以下是每个步骤的建议选择：

向导完成后

向导完成后，OpenClaw 会自动启动 Gateway 服务并打开 Web 控制页面。

默认访问地址： http://127.0.0.1:18789

如果页面没有自动打开，可以手动在浏览器中访问上述地址。

💡 提示： 向导会自动创建配置文件，你可以在后续步骤中修改它来接入 UniVibe。

5. 配置 UniVibe 服务

OpenClaw 使用 JSON 配置文件，位于 ~/.openclaw/openclaw.json。

你可以通过修改配置文件或使用 GUI 界面来接入 UniVibe。

方式一：修改配置文件

打开配置文件

# 使用 VS Code 编辑 code ~/.openclaw/openclaw.json

或使用 nano 编辑

nano ~/.openclaw/openclaw.json

或使用 vim 编辑

vim ~/.openclaw/openclaw.json

配置内容

在配置文件中添加或修改以下内容：

{ “agents”: {

"defaults": { "model": { "primary": "univibe-gpt/gpt-5.4" } } 

}, “models”: {

"providers": { "univibe-claude": { "baseUrl": "https://api.univibe.cc/anthropic", "apiKey": "你的API密钥", "api": "anthropic-messages", "models": [ { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }, { "id": "claude-opus-4-6", "name": "Claude Opus 4.6" } ] }, "univibe-gpt": { "baseUrl": "https://api.univibe.cc/openai", "apiKey": "你的API密钥", "api": "openai-responses", "models": [ { "id": "gpt-5.4", "name": "GPT-5.4" }, { "id": "gpt-5.3-codex", "name": "GPT-5.3 Codex" } ] }, "univibe-gemini": { "baseUrl": "https://api.univibe.cc/openai/v1", "apiKey": "你的API密钥", "api": "openai-completions", "models": [ { "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }, { "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro" } ] } } 

} }

💡 记得将 你的API密钥 替换为在上方 API Keys 标签页中创建的实际密钥。

注意： 如果配置文件中已有其他内容（如 gateway、skills、wizard 等），请保留它们，只需添加或修改 agents 和 models 部分。

完整配置示例

以下是一个完整的配置文件示例：

{ “agents”: {

"defaults": { "model": { "primary": "univibe-gpt/gpt-5.4" }, "maxConcurrent": 4, "subagents": { "maxConcurrent": 8 }, "compaction": { "mode": "safeguard" }, "workspace": "/Users/你的用户名/.openclaw/workspace" } 

}, “gateway”: {

"mode": "local", "port": 18789, "bind": "loopback" 

}, “models”: {

"providers": { "univibe-claude": { "baseUrl": "https://api.univibe.cc/anthropic", "apiKey": "你的API密钥", "api": "anthropic-messages", "models": [ { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }, { "id": "claude-opus-4-6", "name": "Claude Opus 4.6" }, { "id": "claude-opus-4-5-", "name": "Claude Opus 4.5" }, { "id": "claude-haiku-4-5-", "name": "Claude Haiku 4.5" } ] }, "univibe-gpt": { "baseUrl": "https://api.univibe.cc/openai", "apiKey": "你的API密钥", "api": "openai-responses", "models": [ { "id": "gpt-5.4", "name": "GPT-5.4" }, { "id": "gpt-5.3-codex", "name": "GPT-5.3 Codex" }, { "id": "gpt-5.1-codex-max", "name": "GPT-5.1 Codex Max" } ] }, "univibe-gemini": { "baseUrl": "https://api.univibe.cc/openai/v1", "apiKey": "你的API密钥", "api": "openai-completions", "models": [ { "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }, { "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro" }, { "id": "gemini-3-flash-preview", "name": "Gemini 3 Flash" } ] } } 

} }

方式二：GUI 界面配置

如果你更喜欢图形界面，可以在 Web 控制页面中配置：

1. 打开浏览器访问 http://127.0.0.1:18789
2. 进入 Config → Models → Providers
3. 依次添加以下三个 Provider：

Claude 系列（univibe-claude）

GPT 系列（univibe-gpt）

Gemini 系列（univibe-gemini）

4. 保存后配置立即生效

6. 配置说明

7. 启动服务

配置完成后，启动 Gateway 服务：

openclaw gateway start 

8. 开始使用

方式一：Web UI（推荐）

最简单的使用方式，无需任何外部服务：

openclaw dashboard 

浏览器会打开 http://127.0.0.1:18789/，直接在网页聊天窗口发消息即可。

方式二：Telegram Bot

1. 在 Telegram 搜索 @BotFather
2. 发送 /newbot 创建机器人
3. 获取 Bot Token
4. 在 openclaw onboard 时输入 Token

9. 可用模型（UniVibe）

你可以在配置文件的 models 数组中添加以下模型：

GPT 系列

Claude 系列

Gemini 系列

10. 切换模型

在聊天窗口中使用 /model 命令切换模型：

/model univibe-claude/claude-opus-4-6 

或者修改配置文件中的 agents.defaults.model.primary 字段。

终端命令

聊天命令

安装时提示权限错误

如果遇到权限问题，可以尝试：

sudo npm install -g openclaw 

或者修复 npm 权限：

sudo chown -R \((whoami) \)(npm config get prefix)/{lib/node_modules,bin,share} 

找不到配置文件

配置文件位于 ~/.openclaw/openclaw.json，可以使用以下命令查看：

ls -la ~/.openclaw/ cat ~/.openclaw/openclaw.json 

Gateway 启动失败

1. 检查端口 18789 是否被占用：

lsof -i :18789 

2. 如果端口被占用，可以在配置文件中修改 gateway.port

Node.js 版本过低

OpenClaw 需要 Node.js 22+，检查版本：

node –version 

如果版本低于 22，使用 Homebrew 更新：

brew upgrade node 

Homebrew 安装的 Node.js 找不到

如果使用 brew install node@22 安装，可能需要添加到 PATH：

echo ‘export PATH=“/opt/homebrew/opt/node@22/bin:$PATH”’ >> ~/.zshrc source ~/.zshrc