技术分享

OpenClaw 全攻略：从零开始搭建你的私有 AI 智能助手

想要拥有一个像 Claude Code 一样强大，但完全属于你自己的 AI 助手吗？OpenClaw 是目前最接近这一目标的开源方案。它不仅能写代码，还能管理你的服务器、对接企业微信、甚至在多个主机之间进行 Agent 协作。

今天我将手把手带你完成 OpenClaw 的全量安装与配置，让你的 AI 助手正式“入驻”你的数字生活。

1. 准备工作

在开始之前，你需要准备以下资源：

1.1 硬件资源 (必须)

  • 海外 VPS：推荐预装 Ubuntu 24.04，带独立固定 IP。
    • 推荐链接：狐蒂云 (SZH DY)
    • 国内可选：阿里云/腾讯云的轻量应用服务器（但由于网络原因，建议首选海外）。

1.2 模型资源 (必须)

  • Google Gemini：如果有 VISA 卡，绑定 Google AI Studio 可获 300 美元赠金，免费试用 Gemini 所有模型。
  • 阿里百炼 (国内推荐)：支持 OpenAI 兼容格式，推荐购买 Coding Plan。

1.3 可选增强资源

  • 域名：购买一个便宜的域名（如 .top 或 .xyz），在 Namecheap 仅需几块钱。增加一条 A 记录指向你的 VPS IP。
  • Brave Search API (推荐)：免费申请，每月 1000 次免费额度，让助手拥有联网搜索能力。
  • Tavily Search API (备选/国内推荐)：官网注册。Tavily 是专为 AI Agent 设计的搜索引擎。注：若在中国国内环境下无法访问 Brave Search，强烈推荐使用 Tavily。
  • 企业微信：作为助手的交互终端。

2. 系统环境配置与安全加固

拿到 VPS 后，第一件事是增强安全性。

2.1 修改 SSH 端口

使用 root 登录，编辑配置：

1
sudo vi /etc/ssh/sshd_config

找到 #Port 22，取消注释并修改为自定义端口（建议 10000–65535 之间），例如 2288。
同时确保 PubkeyAuthentication yes 已开启。

重启 SSH 服务：

1
2
3
systemctl stop ssh.socket
systemctl disable ssh.socket
systemctl restart sshd

2.2 创建非 root 用户

根据你使用的 Linux 发行版，管理员用户组的名称有所不同：

对于 Ubuntu / Debian 系列：

1
2
useradd -m -G sudo -s /bin/bash zeaho
passwd zeaho

对于 OpenCloudOS / RHEL / CentOS 系列：

1
2
useradd -m -G wheel -s /bin/bash zeaho
passwd zeaho

创建完成后，切换到新用户：

1
su -l zeaho

3. 安装 OpenClaw

3.1 安装 Node.js v24 (LTS)

OpenClaw 对 Node 版本有要求，建议安装最新的 v24：

1
2
3
4
5
6
7
# 如果有旧版，请先删除
sudo apt-get remove -y nodejs npm
sudo apt-get autoremove -y

# 安装 v24
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

3.2 一键安装 OpenClaw

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

安装后会自动进入配置页面，此时按照提示填入你的模型 API 信息（以阿里百炼为例）：

  • API 地址: https://coding.dashscope.aliyuncs.com/v1
  • API Key: sk-sp-xxxxxxxxxx
  • 模型名称: qwen3.5-plus

3.3 配置环境变量

为了让终端识别 openclaw 命令，修改 ~/.bashrc：

1
2
echo 'export PATH="/home/wutao/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

4. 配置 Dashboard 控制台 (Web 访问)

为了方便在浏览器里管理助手，我们需要配置反向代理。

4.1 安装 Caddy

1
2
sudo apt update && sudo apt upgrade -y
sudo apt install caddy -y

4.2 配置域名反代 (Caddy)

如果你有域名，编辑 /etc/caddy/Caddyfile：

1
2
3
xxx.yourdomain.com {
    reverse_proxy localhost:18789
}

保存后重载：sudo systemctl reload caddy。

如果你没有域名，可以直接通过 IP 访问（注意：Caddy 默认不会为 IP 提供自动 HTTPS），或者在 Caddyfile 中配置：

1
2
3
:80 {
    reverse_proxy localhost:18789
}

然后在浏览器访问 http://你的服务器IP。如果你想在 IP 上强制使用特定的非标准端口，可以改为 :8888 等。

4.3 修改 OpenClaw 配置文件

编辑 ~/.openclaw/openclaw.json，在 gateway 字段增加 controlUi 权限，并完善模型参数：

1
2
3
4
5
6
7
8
9
10
"gateway": {
  "port": 18789,
  "controlUi": {
    "allowedOrigins": ["https://xxx.yourdomain.com"]
  },
  "auth": {
    "mode": "token",
    "token": "你的密钥"
  }
}

在 models 部分，补充 input 和 contextWindow：

1
2
3
4
5
6
7
8
"models": [
  {
    "id": "qwen3.5-plus",
    "input": ["text", "image"],
    "contextWindow": 1000000,
    "maxTokens": 65536
  }
]

完成后重启服务：openclaw gateway restart。

4.4 联网搜索配置 (可选)

为了让 OpenClaw 能够上网查资料，你需要在 openclaw.json 中配置搜索提供商。

方案 A：Brave Search (默认)

1
2
3
4
5
6
7
8
"tools": {
  "web": {
    "search": {
      "provider": "brave",
      "apiKey": "你的BraveAPI密钥"
    }
  }
}

方案 B：Tavily Search (针对 Agent 优化)
如果你在访问 Brave 时遇到网络困难，或者希望获得更干净的搜索结果，可以使用 Tavily：

1
2
3
4
5
6
7
8
"tools": {
  "web": {
    "search": {
      "provider": "tavily",
      "apiKey": "你的TavilyAPI密钥"
    }
  }
}

5. 进阶：关联企业微信

关联企业微信能让 OpenClaw 像真人一样在通讯软件里随时响应。在配置之前，你需要先为 OpenClaw 安装 WeCom 插件。

5.0 安装 WeCom 插件

在服务器终端执行以下指令（参考 GitHub 讨论帖 #8524）：

1
2
3
4
5
6
7
8
# 1. 安装插件
openclaw plugins install @yanhaidao/wecom

# 2. 启用插件
openclaw plugins enable wecom

# 3. 初始化配置项（这会在你的 openclaw.json 中生成对应的 channels 结构）
openclaw config --section channels

5.1 关联 Bot (群机器人/基础模式)

这是最简单的接入方式，适用于群聊场景。

  1. 创建机器人：在企业微信群里，右键选择“添加群机器人”，起名并保存。
  2. 配置回调 (重要)：在机器人管理界面，点击“设置” -> “接收消息配置”。
    • URL：填入 https://你的域名/wecom/bot。
    • Token 和 EncodingAESKey：点击“随机获取”并保存。
  3. 配置 OpenClaw：在 ~/.openclaw/openclaw.json 的 channels 中配置：
1
2
3
4
5
6
7
8
9
"wecom": {
  "enabled": true,
  "bot": {
    "token": "刚才生成的Token",
    "encodingAESKey": "刚才生成的EncodingAESKey",
    "streamPlaceholderContent": "正在思考...",
    "welcomeText": "你好！我是 AI 助手"
  }
}

注：如果你只需要简单的 Webhook 推送，不需要对话，则只需配置 webhook 地址即可。

5.2 关联 Agent (自建应用模式，推荐)

这是最强大的模式，支持主动推送和完美的双向对话。

  1. 创建应用：点击“应用管理” -> “自建” -> “创建应用”。
  2. 获取字段：
    • corpId：在“我的企业”最下方查看。
    • corpSecret 和 agentId：在新建的应用详情页查看。
  3. 配置接收消息：在应用详情页点击“设置 API 接收”。
    • URL：填入 https://你的域名/wecom/agent。
    • token 和 encodingAESKey：点击“随机获取”。
  4. 配置 OpenClaw：
1
2
3
4
5
6
7
8
9
10
11
"wecom": {
  "enabled": true,
  "agent": {
    "corpId": "wwda...",
    "corpSecret": "...",
    "agentId": 100002,
    "token": "...",
    "encodingAESKey": "...",
    "welcomeText": "欢迎使用智能助手"
  }
}

关键点补遗：

  • 字段对齐：请务必检查是 corpSecret 而不是 secret，是 encodingAESKey 而不是 aesKey。
  • 路径验证：在企业微信后台点“保存”验证 URL 时，请确保 OpenClaw 服务已启动，否则会验证失败。

6. 设备配对与使用

  1. 打开浏览器访问 https://xxx.yourdomain.com (或你的 IP)。
  2. 在 Overview 页面填入配置文件中的 token。
  3. 页面显示 pairing required 时，回到服务器终端执行：
    1
    2
    openclaw devices list
    openclaw devices approve <requestId>
  4. 刷新网页，显示 OK 即可开始对话！

结语：OpenClaw 到底能做什么？

OpenClaw 不仅仅是一个聊天框，它是你的全能数字分身：

  • 工程专家：直接在你的服务器上阅读源码、定位 Bug、甚至写完代码后顺手帮你跑个仿真。
  • 系统管理员：你可以通过微信下令“查一下服务器 CPU 占用”，它会执行命令并把美化后的报告发给你。
  • 跨主机协作：通过 agent-sync，它可以指挥运行在不同主机上的 Agent（如小悦）共同完成一项任务。
  • 自主进化：它能记录你的偏好，不断优化自己的工作流。

通过本次配置，你已经拥有了一台 24 小时待命的超级大脑。后续我将分享更多关于 Agent 协作的黑科技，请关注：blog.wutao6.cfd！🌬️