OpenClaw 官方文档

项目介绍

OpenClaw 不是一个套壳的网页聊天框，而是一个运行在你本地的 AI 核心网关。它通过监听各大社交软件的协议，让你的 AI 助手无缝潜入你最常用的聊天工具中。

• 完全开源，数据 100% 留在你的本地硬盘。
• 支持持久化记忆，它能记住你上周和它聊过的项目细节。
• 自带 WASM 插件沙箱，你可以直接命令它写代码并生成新的工具。

环境准备

在开始之前，请确保你的服务器或个人电脑已安装以下基础环境：

• Node.js (v18.0.0 或更高版本)
• Git 命令行工具
• 一个可用的 OpenAI API Key，或本地部署的 Ollama 运行实例。

极速安装

打开你的终端 (Terminal / Command Prompt)，按顺序执行以下命令：

# 1. 克隆代码库
git clone https://github.com/openclaw/openclaw.git

# 2. 进入项目目录
cd openclaw

# 3. 安装所需依赖
npm install

配置大模型 (LLM)

OpenClaw 需要一个大脑。我们推荐复制环境配置模板来进行设置：

cp .env.example .env

使用你喜欢的文本编辑器打开 .env 文件，填入你的 API 密钥：

# 如果你使用 OpenAI
OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"

# 如果你使用本地的 Ollama (数据最安全)
OLLAMA_ENDPOINT="http://localhost:11434"
DEFAULT_MODEL="llama3"

接入 Telegram

让 OpenClaw 接管你的 Telegram 机器人非常简单：

1. 在 Telegram 中搜索并添加 @BotFather。
2. 发送 /newbot 创建一个新机器人，并获取专属的 Bot Token。
3. 将 Token 填入你的 .env 文件中：TELEGRAM_BOT_TOKEN="你的Token"
4. 在终端运行 npm run dev，你的机器人就复活了！

接入 WhatsApp

WhatsApp 接入使用的是 Web 协议模拟（基于 Baileys 库）。

在你的 .env 中设置 ENABLE_WHATSAPP=true，然后启动程序。终端会自动打印出一个 二维码。打开你手机上的 WhatsApp，进入“已连接的设备”扫码即可完成登录。你的 AI 将接管该账号的消息回复。