Skip to content

快速开始

欢迎使用 OpenClaw 知识库!本指南将帮助你快速上手 OpenClaw - 开源个人 AI 助手。

什么是 OpenClaw?

OpenClaw 是一款开源、可自托管、跨平台的个人 AI 助手。它具备以下核心特性:

  • 持久化记忆:记录用户偏好、会话上下文,实现个性化助手
  • 多平台通信:集成 WhatsApp、Telegram、Discord、Slack、企业微信、QQ、钉钉、飞书等
  • 完整系统访问:可读写文件、执行 shell 命令、运行脚本
  • 浏览器控制:自动浏览网页、填写表单、从任意网站提取数据
  • 技能扩展:支持社区技能或自定义技能,AI 可自行编写新技能

系统要求

  • 操作系统:macOS 15+、Windows 10+、Linux
  • Node.js:v18 或更高版本
  • 内存:至少 4GB RAM(推荐 8GB+)
  • 存储:至少 2GB 可用空间

安装方式

方式一:一键安装脚本(推荐)

适用于 macOS 和 Linux:

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

方式二:npm 全局安装

bash
npm i -g openclaw

安装完成后,运行:

bash
openclaw

方式三:Git 源码安装

适合开发者:

bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm run build
pnpm start

方式四:macOS 菜单栏应用

GitHub Releases 下载 macOS 应用(需要 macOS 15+)。

首次配置

1. 配置 AI 模型

OpenClaw 支持多种 AI 模型,你可以选择:

云端模型

  • Anthropic Claude(推荐)
  • OpenAI GPT
  • Google Gemini
  • Kimi
  • MiniMax

本地模型

  • Ollama
  • LM Studio
  • LocalAI

编辑配置文件 ~/.openclaw/config.json

json
{
  "model": {
    "provider": "anthropic",
    "modelId": "claude-3-5-sonnet-20241022",
    "apiKey": "your-api-key"
  }
}

2. 配置 IM 平台

选择你要接入的聊天平台:

国内平台

  • 企业微信
  • QQ
  • 钉钉
  • 飞书

海外平台

  • WhatsApp
  • Telegram
  • Discord
  • Slack
  • Signal
  • iMessage

详细配置请参考 IM 集成指南

3. 安全配置

OpenClaw 提供两种运行模式:

  • 沙盒模式(推荐新手):限制文件系统和命令执行权限
  • 完全访问模式:允许完全访问系统资源

注意

完全访问模式具有较高权限,请确保在受信任的环境中使用。

验证安装

运行以下命令验证安装:

bash
openclaw doctor

该命令会检查:

  • Node.js 版本
  • 配置文件
  • 模型连接
  • 权限设置

下一步

获取帮助

如果遇到问题,可以通过以下方式获取帮助:

基于 MIT 许可发布