撰于 阅读 133

OpenClaw on macOS 完整安装与配置指南

OpenClaw on macOS 完整安装与配置指南

本指南将引导您在 macOS 系统上完成 OpenClaw 的基础环境配置、核心组件安装、平台接入（QQ 机器人）以及浏览器拓展的集成。

image-20260313213441006

一、 基础环境准备

OpenClaw 依赖于 Node.js 环境及包管理工具。我们将使用 macOS 的包管理器 Homebrew 来安装这些依赖。

1. 安装 Homebrew

如果您尚未安装 Homebrew，请打开终端（Terminal）并执行以下命令：

/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

2. 安装 Node.js, npm 和 Git

使用 Homebrew 一键安装所需的底层依赖：

brew install node

注：安装完成后，可以通过 node -v 和 npm -v 检查是否安装成功。

二、 核心组件安装与初始化

1. 安装 OpenClaw

使用 npm 全局安装 OpenClaw CLI 工具：

npm config set registry https://registry.npmmirror.com
npm config set strict-ssl false
npm install -g openclaw

2. 初始化 OpenClaw

执行向导命令，完成 OpenClaw 的基础内容设置：

openclaw onboard --install-daemon

如果需要接入 deepseek，可以先不配置模型，使用下面的命令配置

openclaw config set 'models.providers.deepseek' --json '{
  "baseUrl": "https://api.deepseek.com/v1",
  "apiKey": "sk-*****",
  "api": "openai-completions",
  "models": [
    { "id": "deepseek-chat", "name": "DeepSeek Chat" },
    { "id": "deepseek-reasoner", "name": "DeepSeek Reasoner" }
  ]
}'

openclaw config set models.mode merge

openclaw models set deepseek/deepseek-chat

openclaw gateway restart

3. 检查网关运行情况

初始化完成后，需要确认 OpenClaw 网关是否正常启动。您可以查看终端输出的日志或使用状态检查命令（如 openclaw status，具体取决于版本支持）。

常见故障排除 (Troubleshooting)：

  • 端口冲突： 如果提示 Port already in use，请检查是否有其他服务占用了 OpenClaw 的默认端口，并尝试修改配置文件中的端口号或杀掉冲突进程。
  • Node 版本过低： 如果遇到语法错误，请确保您的 Node.js 版本符合 OpenClaw 的最低要求（通常建议 v18 或以上）。
  • 网络问题： 国内网络环境下，若 npm 安装或初始化拉取资源过慢，建议配置 npm 淘宝镜像：npm config set registry https://registry.npmmirror.com。

三、 接入 QQ 机器人 (QQ Bot)

通过在官方网站安装官方插件，将 OpenClaw 接入 QQ 平台。

1. 安装 QQ 插件

openclaw plugins install @tencent-connect/openclaw-qqbot@latest

2. 绑定 QQ Bot

添加 QQ 频道并配置您的 Bot Token：

openclaw channels add --channel qqbot --token "19*****25:qcB******VHo"

3. QQ 对话测试

在您的 QQ 客户端中向该机器人发送测试消息，确认 OpenClaw 能够正常接收并响应。

四、 安装 Clawhub 与技能扩展

Clawhub 是管理 OpenClaw 技能库的工具，可以让您的 OpenClaw 具备更多特定功能。

在国内可以选择安装腾讯的镜像工具 skillhub

1. 安装 Clawhub

npm install -g clawhub
# for CN
curl -fsSL https://skillhub-1251783334.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2. 验证 Clawhub 是否成功安装

clawhub search humanizer
# for CN
skillhub search humanizer

3. 安装本地化技能

使用 Clawhub 安装 humanize-zh 技能，优化中文语境下的拟人化表达：

clawhub install humanizer tell-jokes agent-browser
# for CN
skillhub install humanizer tell-jokes agent-browser

六、 最终效果测试

完成上述所有步骤后，建议进行一次全链路的综合测试：

  1. 确认后台网关持续稳定运行。
  2. 在浏览器中打开几个特定的网页。
  3. 通过 QQ 机器人向 OpenClaw 发送指令（例如让其总结当前浏览器标签页的内容，或使用 humanizer 的特定语气进行闲聊）。
  4. 验证各个组件是否协同工作正常。