一、OpenClaw简介

OpenClaw是一个Apache 2.0开源的AI Agent框架，GitHub 300K+ Stars，是目前最流行的开源Agent框架之一。支持Windows、Mac、Linux多平台，以及Docker部署。

核心特点

二、安装方式

方式一：Docker部署（推荐）

克隆仓库

git clone https://github.com/openclaw/agent.git
进入目录

cd agent
使用Docker启动

docker-compose up -d
访问Web界面

open http://localhost:3000

方式二：直接安装

Windows：

使用PowerShell安装

iwr https://install.openclaw.com | iex
启动OpenClaw

openclaw start

Mac/Linux：

使用curl安装

curl -L https://install.openclaw.com | sh
启动OpenClaw

openclaw start

方式三：源码部署

克隆仓库

git clone https://github.com/openclaw/agent.git
安装依赖

npm install
复制配置文件

cp config.example.yaml config.yaml
编辑配置文件

vim config.yaml
启动

npm run dev

三、配置指南

配置文件说明

config.yaml

server:
  port: 3000
  host: localhost
agent:
  model: gpt-4
  api_key: your-api-key
platforms:
  - type: telegram
    bot_token: your-bot-token
  - type: discord
    bot_token: your-bot-token

支持的消息平台

四、插件开发

创建插件

// plugins/my-plugin/index.js
module.exports = {
  name: 'my-plugin',
  version: '1.0.0',
  // 插件初始化
  async onLoad(ctx) {
    console.log('插件加载');
  },
  // 处理消息
  async onMessage(ctx, message) {
    // 处理逻辑
    return {
      content: '回复内容'
    };
  }
};

插件配置

plugins:
  - name: my-plugin
    enabled: true
    config:
      option1: value1

五、API调用配置

OpenAI API

agent:
  model: gpt-4
  api_key: sk-xxx
  api_base: https://api.openai.com/v1

Claude API

agent:
  model: claude-3-opus
  api_key: sk-ant-xxx
  api_base: https://api.anthropic.com

国内API（推荐）

agent:
  model: deepseek-chat
  api_key: your-deepseek-api-key
  api_base: https://api.deepseek.com

六、常见问题

Q: Docker版本启动失败？
A: 确保Docker版本 >= 20.10，并分配足够内存。

Q: 如何配置HTTPS？
A: 使用nginx反向代理，或配置let's encrypt证书。

Q: 支持哪些AI模型？
A: 支持所有OpenAI兼容的API，包括GPT-4、Claude、DeepSeek等。