OpenClaw大龙虾部署（国内环境）详细指南

岚天start

1296人浏览 · 2026-03-11 20:41:14

岚天start · 2026-03-11 20:41:14 发布

1. 前言

OpenClaw（江湖人称“大龙虾”），开源个人 AI 智能体（Agent）框架。它由知名开发者 Peter Steinberger 发起（前身曾叫 Clawdbot、Moltbot），其核心 Slogan 是 “The AI that actually does things”（真正做事的 AI）。

2. 环境准备

2.1 操作系统

本文以ubuntu系统为例

cat /etc/os-release
PRETTY_NAME="Ubuntu 24.04.4 LTS"
NAME="Ubuntu"
VERSION_ID="24.04"
VERSION="24.04.4 LTS (Noble Numbat)"
VERSION_CODENAME=noble
ID=ubuntu
ID_LIKE=debian
HOME_URL="https://www.ubuntu.com/"
SUPPORT_URL=" ://help.ubuntu.com/"
BUG_REPORT_URL="https://bugs.launchpad.net/ubuntu/"
PRIVACY_POLICY_URL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy"
UBUNTU_CODENAME=noble
LOGO=ubuntu-logo

2.2 安装Node.js环境

OpenClaw的核心代码由 TypeScript 编写，需要Node.js运行环境(要求版本 ≥ 22)

# Ubuntu/Debian 系统
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node --version  # 应显示 v22.x.x
npm --version   # 应显示 10.x.x

3. 部署OpenClaw

3.1 配置 npm 国内镜像源

npm config set registry https://registry.npmmirror.com

3.2 安装OpenClaw

#  全局安装 OpenClaw
npm install -g openclaw@latest

3.3 初始化OpenClaw

# 交互式配置
openclaw onboard --install-daemon

3.3.1 关键配置点

本文以配置阿里云百炼大模型为例（新用户有免费额度），

Model/auth provider：选择 Custom Provider
API Base URL: 百炼模型地址填写 https://dashscope.aliyuncs.com/compatible-mode/v1
API key：登录百炼https://bailian.console.aliyun.com/，获取方式方式如下

Endpoint compatibility：选择 OpenAI-compatible
Model ID : 可以选择如图所示任意一个，本文选择qwen3.5-plus

3.3.2 关键截图展示

3.4 简单测试

root@aly-ubuntu-yq-test:~# cat  /mnt/test/disk_monitor.sh 
#!/bin/bash
# 磁盘使用率监控脚本
# 创建时间：2026-03-11

LOG_FILE="/mnt/test/disk_usage.log"
DATE=$(date '+%Y-%m-%d %H:%M:%S')

# 获取磁盘使用情况
echo "=== 磁盘使用率检查 [$DATE] ===" >> "$LOG_FILE"
df -h >> "$LOG_FILE"
echo "" >> "$LOG_FILE"

# 检查是否有分区使用率超过 80%
# df -h | awk 'NR>1 {gsub(/%/, "", $5); if (int($5) > 80) print "警告: " $6 " 分区使用率已达 " $5 "%"; }'
echo "警告检查:" >> "$LOG_FILE"
df -h | awk 'NR>1 {
    gsub(/%/, "", $5);
    if (int($5) > 80) {
        print "⚠️  警告: " $6 " 分区使用率已达 " $5 "%";
    }
}' >> "$LOG_FILE"
echo "" >> "$LOG_FILE"
echo "==============================" >> "$LOG_FILE"
echo "" >> "$LOG_FILE"

echo "磁盘监控完成，日志已保存到: $LOG_FILE"