中文 EN
中等 🌍 地区定价 可靠性: 高

OpenClaw AI Agent框架完整指南 - 300K Stars开源项目

OpenClaw是Apache 2.0开源的AI Agent框架,300K+ Stars,支持20+消息平台。本文介绍OpenClaw的安装配置和支付解决方案

4.8 (5,200 条评价)
浏览 68,000 更新于 2024/5/18
OpenClawAgent框架开源Docker多平台安装教程

一、OpenClaw简介

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

核心特点

  • 多消息平台支持:微信、企业微信、钉钉、飞书、Telegram、Discord等20+平台

  • 插件系统:丰富的插件扩展

  • 记忆管理:长期记忆和上下文管理

  • 工具调用:内置丰富的工具集

  • 跨平台:支持所有主流操作系统
  • 二、安装方式

    方式一: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

    支持的消息平台

    平台配置难度说明

    Telegram简单需要Bot Token

    Discord简单需要Bot Token

    钉钉中等需要钉钉应用

    飞书中等需要飞书应用

    企业微信复杂需要企业资质

    微信复杂需要Hook技术

    四、插件开发

    创建插件

    // 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等。

    相关工具

    觉得有用?分享给同学!