跳转到主要内容
OpenClaw 是一个开源的个人 AI 助手平台,主打“真正帮你做事”而不只是聊天:它可以运行在你的本地设备上,接入 WhatsApp、Telegram、Slack、飞书 等聊天工具,并结合邮件、日历、浏览器、文件系统和脚本执行能力,帮助你完成自动化任务;同时支持持久记忆、多模型接入和技能扩展,适合希望拥有一个可控、可定制、能实际执行工作的私人 AI 助手的用户。

安装

这里使用较简单的安装方式,其他请参考官方文档 https://docs.openclaw.ai/

系统要求

  • Node >=22
  • macOS、Linux 或通过 WSL2 的 Windows
  • pnpm 仅在从源代码构建时需要

快速安装

curl -fsSL https://openclaw.ai/install.sh | bash

接入 接口AI API

修改 ~/.openclaw/openclaw.json 配置文件,字段值可根据需求修改
  • models 字段
  "models": {
    "mode": "merge",
    "providers": {
      "<provider_name>": {
        "baseUrl": "<provider_base_url>",
        "apiKey": "<your_api_key>",
        "api": "<api_endpoint_type>",
        "models": [
          {
            "id": "<model_id>",
            "name": "<model_display_name>",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": <contextWindow>,
            "maxTokens": <maxTokens>
          }
        ]
      }
    }
  }
  • agent 字段
"agents": {
    "defaults": {
      "model": {
        "primary": "<provider_name>/<model_id>"
      },
      "models": {
        "<provider_name>/<model_id>": {
          "alias": "<model_alias>"
        }
      },
      "workspace": "<your_local_path>/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  }
  • 示例:
"models": {
    "mode": "merge",
    "providers": {
      "Jiekou": {
        "baseUrl": "https://api.jiekou.ai/openai/v1",
        "apiKey": "sk_xxxxxxxxxxxxxxxxxx",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-5.4",
            "name": "gpt-5.4 (Custom Provider)",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 16000,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "jiekou/gpt-5.4"
      },
      "models": {
        "Jiekou/gpt-5.4": {
          "alias": "gpt-5.4"
        }
      },
      "workspace": "/Users/0000/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },