🦎 OpenClaw 安装配置与使用指南

基于 OpenClaw + Claude Code 的端到端研发自动化系统 · 2026 最新版

📋 文档信息
  • 版本: v1.0.0
  • 创建日期: 2026-03-18
  • 适用系统: Windows / macOS / Linux (Ubuntu 24.04)

核心特性

🤖

多平台支持

WhatsApp、Telegram、飞书等 15+ 平台集成

🔌

插件化架构

支持自定义插件扩展,灵活定制

🔄

工作流自动化

日常任务自动执行,效率提升 10 倍+

💬

多模型集成

Kimi、Claude、GPT 等主流模型支持

🏠

自托管部署

数据完全私有化,安全可控

双层 Agent

Codex + Claude Code 协同调度

系统要求

组件 最低配置 推荐配置
操作系统 Windows 10 / Ubuntu 20.04 Windows 11 / Ubuntu 24.04
CPU 2 核 4 核+
内存 2GB 4GB+
磁盘空间 10GB 20GB+
Python 3.10 3.11+
Node.js v18.x v20.x LTS

📦 安装方法

⚠️ 推荐安装方式

Docker 部署 是最简单、最可靠的安装方式,推荐使用!

方法一:Docker 部署(推荐)

1

安装 Docker (Ubuntu 24.04)

# 更新包索引
sudo apt update

# 安装依赖
sudo apt install -y apt-transport-https ca-certificates curl gnupg lsb-release

# 添加 Docker GPG 密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# 设置稳定版仓库
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] \
https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装 Docker Engine
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io

# 验证安装
docker --version

# 将当前用户添加到 docker 组
sudo usermod -aG docker $USER
newgrp docker
2

安装 Docker Compose

# 下载 Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" \
-o /usr/local/bin/docker-compose

# 赋予执行权限
sudo chmod +x /usr/local/bin/docker-compose

# 验证安装
docker-compose --version
3

创建配置文件

# 创建并进入目录
mkdir -p ~/openclaw && cd ~/openclaw

# 创建 docker-compose.yml 文件
cat > docker-compose.yml << 'EOF'
version: "3.9"
services:
  openclaw:
    image: openclaw-dev:latest
    container_name: openclaw-dev
    network_mode: host
    restart: unless-stopped
    volumes:
      - ~/.openclaw:/home/dev/.openclaw
    environment:
      - OPENCLAW_API_KEY=your_api_key_here
      - OPENCLAW_MODEL=kimi-k2.5
EOF
4

启动容器

# 启动容器(后台运行)
docker compose up -d

# 查看容器状态
docker ps

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

方法二:源码安装

克隆仓库并安装依赖

# 克隆 OpenClaw 仓库
git clone https://github.com/OpenClaw/OpenClaw.git
cd OpenClaw

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Windows
.venv\Scripts\activate
# macOS/Linux
source venv/bin/activate

# 安装 Python 依赖
pip install -r requirements.txt

# 安装 Node.js 依赖(如果需要 Web 控制台)
npm install

🔑 API Key 配置

支持的 AI 模型

模型提供商 模型名称 API 端点 推荐度
月之暗面 Kimi-K2.5 https://api.moonshot.cn/v1 ⭐⭐⭐⭐⭐
智谱 AI GLM-5 https://api.z.ai/api/anthropic ⭐⭐⭐⭐⭐
阿里云 Qwen-Coder https://dashscope.aliyuncs.com ⭐⭐⭐⭐
Anthropic Claude Sonnet https://api.anthropic.com ⭐⭐⭐⭐

获取 Kimi API Key

  1. 访问月之暗面开放平台:https://platform.moonshot.cn/
  2. 注册/登录账号
  3. 进入控制台 → API Keys
  4. 创建新的 API Key
  5. 复制并保存 API Key

配置环境变量

# Linux/macOS
export OPENCLAW_API_KEY="sk-xxxxxxxxxxxxxxxx"
export OPENCLAW_MODEL="kimi-k2.5"
export OPENCLAW_BASE_URL="https://api.moonshot.cn/v1"

# Windows PowerShell
$env:OPENCLAW_API_KEY="sk-xxxxxxxxxxxxxxxx"
$env:OPENCLAW_MODEL="kimi-k2.5"
$env:OPENCLAW_BASE_URL="https://api.moonshot.cn/v1"
💡 配置文件方式

编辑 ~/.openclaw/config.yaml:

api:
  key: "sk-xxxxxxxxxxxxxxxx"
  model: "kimi-k2.5"
  base_url: "https://api.moonshot.cn/v1"
  
settings:
  temperature: 0.7
  max_tokens: 4096
  timeout: 60

🚀 核心功能使用

CLI 基本命令

# 查看帮助
openclaw --help

# 启动对话
openclaw chat

# 执行任务
openclaw run "帮我创建一个 Python Flask 应用"

# 查看历史
openclaw history

# 清除上下文
openclaw clear

# 导出对话
openclaw export --format markdown

工作流自动化示例

创建每日工作报告工作流

创建 ~/.openclaw/workflows/daily_report.yaml:

name: daily_report
description: 生成每日工作报告
trigger:
  schedule: "0 18 * * *"  # 每天 18:00 执行
  
steps:
  - name: collect_tasks
    action: query_todo_list
    params:
      date: today
      
  - name: generate_report
    action: llm_generate
    params:
      prompt: "根据以下任务列表生成日报:{{tasks}}"
      input: "{{collect_tasks.output}}"
      
  - name: send_email
    action: send_email
    params:
      to: "manager@company.com"
      subject: "每日工作报告 - {{date}}"
      body: "{{generate_report.output}}"

插件系统

# 从插件市场安装
openclaw plugin install github-integration

# 从 URL 安装
openclaw plugin install https://github.com/user/openclaw-plugin.git

# 本地安装
openclaw plugin install ./my-plugin

常用插件

插件名称 功能描述 安装命令
github-integration GitHub 集成 openclaw plugin install github-integration
jenkins-connector Jenkins CI/CD openclaw plugin install jenkins-connector
docker-manager Docker 容器管理 openclaw plugin install docker-manager
k8s-deploy K8s 部署工具 openclaw plugin install k8s-deploy

🔗 与 Claude Code 集成

双层 Agent 架构

┌─────────────────────────────────────────────────────────┐ │ OpenClaw Orchestrator │ │ (任务调度、工作流管理、多 Agent 协调) │ └─────────────────────────────────────────────────────────┘ │ │ ▼ ▼ ┌──────────────────────┐ ┌──────────────────────┐ │ Codex Agent │ │ Claude Code Agent │ │ (通用任务处理) │ │ (专业代码生成) │ └──────────────────────┘ └──────────────────────┘

配置集成

~/.openclaw/config.yaml 中添加:

agents:
  claude_code:
    enabled: true
    api_key: "${ANTHROPIC_AUTH_TOKEN}"
    base_url: "${ANTHROPIC_BASE_URL}"
    model: "glm-5"
    
  codex:
    enabled: true
    api_key: "${OPENAI_API_KEY}"
    model: "gpt-4"

routing:
  rules:
    - pattern: ".*code.*|.*编程.*|.*开发.*"
      agent: claude_code
    - pattern: ".*test.*|.*测试.*"
      agent: claude_code
    - pattern: ".*"
      agent: codex
💡 协同工作示例
# 任务:创建一个完整的 Web 应用
openclaw run "创建一个用户管理系统,包含前后端代码、测试和部署配置"

# OpenClaw 自动分解任务:
# 1. Codex: 需求分析和 PRD 设计
# 2. Claude Code: 后端 API 开发 (Python FastAPI)
# 3. Claude Code: 前端页面开发 (React)
# 4. Claude Code: 单元测试编写
# 5. OpenClaw: 集成测试配置
# 6. OpenClaw: Docker 部署配置

❓ 常见问题解决

安装问题

Q1: Docker 容器启动失败
# 检查 Docker 状态
docker ps -a

# 查看容器日志
docker logs openclaw-dev

# 重新启动容器
docker compose down
docker compose up -d
Q2: 权限错误
# Docker 权限问题
sudo usermod -aG docker $USER
newgrp docker

# 文件权限问题
chmod -R 755 ~/.openclaw

API 连接问题

Q1: API Key 无效
  • 检查 API Key 是否正确复制
  • 确认 API Key 未过期
  • 检查账户余额/额度

验证安装

# 1. 检查 Docker 容器
docker ps | grep openclaw

# 2. 测试 API 连接
openclaw test-connection

# 3. 执行简单任务
openclaw run "请用中文自我介绍"

# 4. 测试工作流
openclaw workflow run test_workflow

# 5. 检查 Web 控制台
# 访问 http://localhost:8080

🔗 资源链接

资源 链接
OpenClaw GitHub https://github.com/OpenClaw/OpenClaw
官方文档 https://openclaw.dev/docs
插件市场 https://openclaw.dev/plugins
月之暗面开放平台 https://platform.moonshot.cn/
智谱 AI 开放平台 https://open.bigmodel.cn/
社区论坛 GitHub Discussions