OpenClaw 搭建指南

Part 1

你需要什么网络环境？

为什么国内需要处理网络问题？

OpenClaw 调用的 Claude 模型来自 Anthropic（美国公司），它的 API 地址是 api.anthropic.com，在国内无法直接访问。你需要一个稳定的代理工具，让 Mac mini 的网络流量能走到这个地址。

对代理工具的核心要求

稳定，不频繁断线 — AI 对话是长连接，断一次就要重来
支持 TCP 长连接 — 不能只能刷网页，要能跑 API 请求
延迟低（尽量 < 300ms） — 响应速度影响体验
支持"全局模式"或"规则模式" — 让终端/命令行流量也走代理

方案	适合人群	优点	参考费用
商业机场推荐	大多数人	开箱即用，稳定，多节点可选，有客户端	30-100元/月
自建 VPS 进阶	有技术基础	最稳定，自己掌控，数据私密	50-200元/月（服务器费）
免费 VPN 不推荐	—	—	免费，但不稳定且有风险

使用商业机场的注意事项

选择支持 Clash / Surge / Mihomo 协议的客户端（macOS 端常用 Surge 或 ClashX Pro）
节点建议选 日本、香港、新加坡（延迟低，和 Anthropic 连通好）
安装好客户端后，开启 "系统代理"，才能让 Mac 的所有应用走代理
在终端（Terminal）中确认代理生效：
curl -s https://api.anthropic.com/v1/models # 不报连接错误就表示网络通了

建议：搜索"Clash 订阅机场 2025"，选择口碑好、跑了超过 1 年的服务商，月费 50 元左右档位基本能满足需求。

Part 2

OpenClaw 安装步骤

开始之前，确保你的代理已经开启，能访问 GitHub 和 Anthropic 的网站。

安装 Node.js（JavaScript 运行环境）

OpenClaw 基于 Node.js 运行。打开 Terminal（终端），粘贴以下命令安装 Node.js 版本管理工具 nvm，再安装 Node.js 24：

        # 第一步：安装 nvm

        curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

        # 安装完后，重新加载终端配置

        source ~/.zshrc

        # 第二步：安装 Node.js 24

        nvm install 24

        nvm use 24

        # 验证安装成功（应该显示 v24.x.x）

        node --version

如果 Terminal 提示"command not found: nvm"，关掉终端窗口重新打开，再试一次。

一键安装 OpenClaw

Node.js 装好后，运行官方安装脚本：

curl -fsSL https://openclaw.ai/install.sh | bash

脚本会自动下载 OpenClaw，安装完后你的终端里就有了 openclaw 命令。验证一下：

openclaw --version

显示版本号就表示安装成功！

获取 Claude API Key

你需要一个 Anthropic 的 API Key，让 OpenClaw 能调用 Claude 模型。

打开 https://console.anthropic.com（需要代理）
注册或登录账号
左侧菜单点击 "API Keys"
点击 "Create Key"，复制那串 sk-ant-... 开头的字符串
保存好，待会儿要用

另一个选项：如果你有 Claude 的付费订阅，可以用订阅账号生成 setup-token，不需要单独买 API Key。安装 Claude Code CLI（npm install -g @anthropic-ai/claude-code），然后运行 claude setup-token 生成。

运行引导配置向导

运行下面这条命令，OpenClaw 会一步步问你配置项：

openclaw onboard --install-daemon

向导会问你：

模型选择 → 选 "Anthropic API key"，粘贴刚才的 sk-ant-...
Workspace 目录 → 直接回车用默认路径 ~/.openclaw/workspace
Gateway 端口 → 默认 18789，直接回车
渠道配置 → 暂时可以跳过，后面单独配置
安装系统服务 → 选 Yes（这样 OpenClaw 开机自动启动）

验证 Gateway 运行状态

配置完成后，检查服务是否正常跑起来了：

openclaw gateway status

如果显示 running，说明 Gateway 已经在运行了。

然后打开浏览器控制界面：

openclaw dashboard

浏览器会自动打开 http://127.0.0.1:18789，你就能直接和 AI 对话了。

能在浏览器里看到聊天界面，恭喜你，OpenClaw 已经跑起来了！

（可选）连接 Telegram — 用手机随时对话

OpenClaw 支持通过 Telegram 跟 AI 聊天，这样不用开电脑也能随时发指令。

在 Telegram 里找 @BotFather，发送 /newbot 创建一个机器人
BotFather 会给你一个 Bot Token（格式：123456:ABCDEF...），复制下来
运行配置命令：
openclaw configure
在配置向导里选择 Telegram，粘贴 Bot Token，完成绑定
配置完成后，在 Telegram 里找到你的 bot，发一条消息，AI 就会回复你

Telegram 是最推荐的日常使用渠道，手机随身，随时对话。

初始化工作空间（让 AI 认识你）

OpenClaw 的 AI 有一个专属工作空间，你可以在里面告诉 AI 你是谁、你希望它怎么帮你：

        # 进入工作空间

        cd ~/.openclaw/workspace

        # 看看里面有什么

        ls

你会看到几个文件，比如 SOUL.md（AI 的性格）、USER.md（关于你的信息）等。用任意文本编辑器打开它们，按照里面的说明填写你的信息，AI 下次启动就能"认识"你了。

常见问题

遇到问题怎么办？

运行 `openclaw` 提示"command not found"

说明 npm 全局路径没加到 PATH。运行：

      echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc

      source ~/.zshrc

API 报 401 错误或连接超时

401 错误：API Key 不对，重新检查，别多了空格
连接超时：代理没开，或者节点不稳定，换个节点试试

诊断命令（全面检查配置）：

openclaw doctor

Gateway 没启动怎么办？

      # 查看状态

      openclaw gateway status

      # 手动启动

      openclaw gateway start

想更新到最新版本

npm install -g openclaw@latest

完成！你现在有了：

一个在 Mac mini 上 24 小时运行的 AI 助手，可以通过浏览器或 Telegram 随时对话。接下来可以把 SOUL.md / USER.md 完善，AI 会越来越"认识"你。