OpenClaw (AI Agent) 部署与生产环境配置指南

基于 Ubuntu 24.04.2 LTS Live Server 环境，针对 OpenClaw（AI Agent 框架）的严谨技术部署指南。本教程排除了所有非技术干扰，直击底层依赖与网络策略。

一、系统环境预检查

Ubuntu 24.04 默认提供的 Node.js 版本（v18）无法满足 OpenClaw (v22+) 的 ESM 模块要求。必须进行内核级的环境更替。

1. 基础工具安装

sudo apt update
sudo apt install -y build-essential python3 python3-pip wget curl git libgbm-dev

2. Node.js v22 二进制部署（避开系统包管理器冲突）

由于 Ubuntu 仓库版本过旧，采用二进制手动部署路径：

# 下载 Node v22.14.0 (采用国内镜像)
wget https://npmmirror.com/mirrors/node/v22.14.0/node-v22.14.0-linux-x64.tar.xz

# 解压并重定向路径
tar -xvf node-v22.14.0-linux-x64.tar.xz
mv node-v22.14.0-linux-x64 $HOME/node22

# 写入环境变量
echo "export PATH=\$HOME/node22/bin:\$PATH" >> ~/.bashrc
source ~/.bashrc

# 验证环境 (预期: v22.14.0)
node -v

二、核心组件安装

1. 全局安装 OpenClaw

针对国内网络环境，必须劫持 npm 注册表并配置 Git 代理以拉取 libsignal-node 等加密库零件：

# 1. 配置 Git 代理（解决下载依赖卡死）
git config --global url."https://ghp.ci/https://github.com/".insteadOf https://github.com/
git config --global url."https://ghp.ci/https://github.com/".insteadOf ssh://git@github.com/

# 2. 安装 OpenClaw
npm install -g openclaw@latest --registry=https://registry.npmmirror.com

2. 初始化 Playwright 浏览器内核

OpenClaw 依靠视觉识别，必须安装受控 Chromium 内核及其系统级库：

npx playwright install --with-deps chromium

三、部署后配置与调试 (Post-Deployment)

1. 交互式配置 (Onboarding)

运行配置向导。该过程会生成加密的 Session 文件。

openclaw onboard

关键配置参数说明：

Provider: 优先选 Anthropic (Claude 3.5 Sonnet)，次选 OpenAI (GPT-4o)。国产模型（DeepSeek等）建议通过 One-API 转换后使用 OpenAI 格式接入。
Platform:
- WhatsApp: 终端会弹出 QR 码。需手机 WhatsApp 扫码。
- Telegram: 填入 Bot Token（通过 @BotFather 获取）。

2. 进程守护 (PM2 生产模式)

为保证 Agent 持续运行且在崩溃后自动重启，引入 PM2：

# 安装 PM2
npm install -g pm2 --registry=https://registry.npmmirror.com

# 启动 OpenClaw 并命名为 lobster
pm2 start openclaw --name "lobster"

# 设置开机自启
pm2 save
pm2 startup

四、调试与日志监控

1. 查看实时运行轨迹

Agent 的所有思考过程、视觉截图状态和 API 消耗都会实时输出：

pm2 logs lobster

2. Session 修复

如果扫码后无法连接，或提示权限错误，通常是 Session 损坏：

# 进入配置目录并清理过期 Session
rm -rf ~/.openclaw/sessions/*
openclaw onboard

3. API 响应调试

若 Agent 报错 401 或 429，说明 API Key 无效或超限。

验证：curl https://api.anthropic.com/v1/messages 检查网络连通性。

4. 接入微信和钉钉

4.1 微信

目前只有iOS系统推出“ClawBot”插件，如果没有苹果手机就只能等或者使用钉钉，又或者使用其它支持外部接入的聊天软件等

打开微信 -> 我的 -> 设置 -> 插件 -> 微信ClawBot 进行安装。
在运行OpenClaw的设备上安装插件，并与微信连接，执行下方的命令：

npx -y @tencent-weixin/openclaw-weixin-cli@latest install

然后使用扫一扫功能扫描二维码，点击连接即可完成。

4.2 钉钉

登录开发者后台。
在应用开发下，点击立即创建，可一键创建OpenClaw机器人。
在创建OpenClaw界面，填写机器人基本信息，直接点击确定即可。
OpenClaw创建成功后，会自动展示应用的Client ID和Client Secret，请保存好Client ID和Client Secret用于后续使用。
当OpenClaw创建成功后，会自动创建一个应用

重要：

自动创建的OpenClaw会默认开通Card.Streaming.Write、Card.Instance.Write和qyapi_robot_sendmsg权限，开发者无需再手动申请。

简单配置后即可在单聊中使用，也可以在群聊中加入此机器人（这里不多赘述，也不推荐）

五、附录：一键部署脚本 (`deploy_claw.sh`)

此脚本针对 Ubuntu 24.04 环境编写，包含环境自检与错误拦截逻辑。

#!/bin/bash
# OpenClaw Deployment Script for Ubuntu 24.04
# Author: Vincent & DevOps Expert

set -e

echo "--- 开始部署 OpenClaw AI Agent ---"

# 1. 权限与依赖检查
sudo apt update && sudo apt install -y wget curl git build-essential libgbm-dev

# 2. 安装 Node.js v22 (如果尚未安装)
if [[ "$(node -v 2>/dev/null)" != v22* ]]; then
    echo "正在安装 Node.js v22..."
    wget https://npmmirror.com/mirrors/node/v22.14.0/node-v22.14.0-linux-x64.tar.xz
    tar -xvf node-v22.14.0-linux-x64.tar.xz
    mv node-v22.14.0-linux-x64 $HOME/node22
    export PATH="$HOME/node22/bin:$PATH"
    echo "export PATH=\$HOME/node22/bin:\$PATH" >> ~/.bashrc
else
    echo "Node.js 版本已符合要求"
fi

# 3. 网络优化配置
git config --global url."https://ghp.ci/https://github.com/".insteadOf https://github.com/
git config --global url."https://ghp.ci/https://github.com/".insteadOf ssh://git@github.com/

# 4. 安装核心程序
echo "正在安装 OpenClaw 全局包..."
npm install -g openclaw@latest --registry=https://registry.npmmirror.com

# 5. 浏览器环境安装
echo "配置 Playwright 浏览器依赖..."
npx playwright install --with-deps chromium

# 6. 安装守护进程管理工具
npm install -g pm2 --registry=https://registry.npmmirror.com

echo "------------------------------------------------"
echo "部署完成！"
echo "请执行：source ~/.bashrc"
echo "然后执行：openclaw onboard  进行配置"
echo "最后执行：pm2 start openclaw --name lobster 启动"
echo "------------------------------------------------"

脚本使用说明：

将上述代码保存为 deploy_claw.sh。
赋予执行权限：chmod +x deploy_claw.sh。
运行：./deploy_claw.sh。

六、生产安全红线

权限最小化：严禁以 root 权限长期运行 Agent。
API 指纹隔离：Agent 在网页操作时会上传截图，切勿让 Agent 操作包含网银、明文密码的页面。
封号预警：基于协议的 WhatsApp 自动化行为受官方严格审查，建议使用新号（养号 7 天以上）进行测试。
访问地址白名单：一些网站会诱导AI访问，然后不断消耗用户的token，需要建立可以访问的网站白名单来控制AI的访问范围。