🦞 OpenClaw 服务部署报告

项目概述

本报告详细记录了 OpenClaw 服务的完整部署方案，包括 Docker 和 Kubernetes 两种部署方式，以及全面的 API 访问权限配置。OpenClaw 是一个开源、本地优先的 AI 智能体平台与自动化网关，通过统一网关连接多种主流大模型与即时通信平台。

系统架构

快速开始

git clone <repository-url>
cd openclaw-deployment

chmod +x scripts/deploy.sh
./scripts/deploy.sh

curl http://localhost:3000/health

前置条件检查清单

• Docker 20.10+ 已安装
• Docker Compose 2.0+ 已安装
• Kubernetes 1.25+ (可选，K8s 部署需要)
• kubectl 1.25+ (可选，K8s 部署需要)
• Node.js 18+ (可选)
• Python 3.9+ (脚本运行)

Docker 部署方案

# 设置环境变量
export ANTHROPIC_API_KEY="your_anthropic_api_key"
export API_TOKEN="your_secure_api_token"

# 启动 OpenClaw
docker run -d \
  -p 3000:3000 \
  -p 8080:8080 \
  -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
  -e API_TOKEN=$API_TOKEN \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/config:/app/config \
  --name openclaw \
  openclaw/openclaw:latest

# 启动服务
docker-compose up -d

# 查看状态
docker-compose ps

# 查看日志
docker-compose logs -f openclaw

# 停止服务
docker-compose down

# 带 Ollama 本地模型
docker-compose --profile with-ollama up -d

# 带 Redis 和 Nginx
docker-compose --profile with-redis --profile with-nginx up -d

Kubernetes 部署方案

资源文件清单

部署步骤

# 1. 创建命名空间
kubectl apply -f k8s/openclaw-namespace.yaml

# 2. 配置 Secrets（填入 API 密钥）
kubectl apply -f k8s/openclaw-secrets.yaml

# 3. 应用所有资源配置
kubectl apply -f k8s/

# 4. 验证部署
kubectl get pods -n openclaw-system
kubectl get svc -n openclaw-system

HPA 自动扩缩容配置

API 访问权限配置

使用配置脚本（推荐）

# 赋予执行权限
chmod +x scripts/configure_api_access.sh

# 基本配置（自动生成安全 Token）
./scripts/configure_api_access.sh

# 自定义配置
./scripts/configure_api_access.sh \
  -t "your_custom_secure_token" \
  -r 200 \
  -c "https://your-domain.com"

API 端点列表

curl -X POST http://localhost:8080/v1/chat/completions \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model": "openclaw", "messages": [{"role": "user", "content": "Hello"}]}'

安全配置选项

CI/CD 集成

Jenkins Pipeline 流程

触发构建

# 通过 Jenkins CLI
java -jar jenkins-cli.jar -s http://jenkins-url build openclaw-deploy

# 通过 API
curl -X POST http://jenkins-url/job/openclaw-deploy/build \
  -u username:api-token \
  --data "DEPLOY_ENV=production&RUN_TESTS=true"

测试和验证

使用测试脚本

# 运行完整测试套件
./scripts/test_api_access.sh \
  -h localhost \
  -p 3000 \
  -t your_api_token \
  --verbose

测试用例覆盖

项目文件结构

访问信息

# 健康检查
curl http://localhost:3000/health

# API 调用（需要认证）
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
     http://localhost:3000/api/v1/status

# Chat Completion
curl -X POST http://localhost:8080/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model": "openclaw", "messages": [{"role": "user", "content": "Hello"}]}'

故障排查

常见问题速查

日志查看命令

# Docker 日志
docker logs --tail 100 -f openclaw

# Kubernetes 日志
kubectl logs -f deployment/openclaw -n openclaw-system