OpenClaw 完整搭建教程 - 打造你的专属 AI 助手

本教程适用于 Windows、macOS、Linux 系统，手把手教你从零搭建 OpenClaw，让 AI 真正成为你的私人助理。

---

🦞 OpenClaw 是什么？

OpenClaw 是一个开源的 AI 助手框架，支持多种 AI 模型（GPT、Claude、Gemini、DeepSeek、千帆等），可以通过微信、飞书、Telegram、Discord 等多种渠道与你对话。

核心优势：

• 🔌 多模型支持：一个框架接入所有主流 AI

• 💬 多渠道接入：微信、飞书、Telegram、Discord、Web Chat

• 🔒 本地部署：数据在自己手里，隐私安全

• 🛠️ 插件生态：丰富的插件扩展功能

• 🤖 自动化任务：定时任务、心跳检测、自动提醒

---

📦 准备工作

必需

• Node.js 18+（推荐 20+）

• npm 或 pnpm

• 一个 AI 模型的 API Key（OpenAI / Claude / DeepSeek / 百度千帆 等）

可选

• Tailscale：远程访问（不公网也能用）

• Docker：容器化部署

---

🚀 快速安装

macOS 安装

`bash

1. 确保已安装 Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装 Node.js

brew install node

3. 全局安装 OpenClaw

npm install -g openclaw

4. 初始化配置

openclaw configure`

Windows 安装

`powershell

1. 安装 Node.js（推荐去官网下载 LTS 版本）

https://nodejs.org/

2. 打开 PowerShell，安装 OpenClaw

npm install -g openclaw

3. 初始化配置

openclaw configure`

Linux 安装

`bash

Ubuntu/Debian

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs

CentOS/RHEL

curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash - sudo yum install -y nodejs

安装 OpenClaw

npm install -g openclaw openclaw configure`

---

⚙️ 配置 API Key

OpenClaw 支持多种 AI 模型，配置方式：

`bash

配置 OpenAI

openclaw config set providers.openai.apiKey "sk-xxxxx"

配置 Claude

openclaw config set providers.anthropic.apiKey "sk-ant-xxxxx"

配置 DeepSeek

openclaw config set providers.deepseek.apiKey "sk-xxxxx"

配置百度千帆

openclaw config set providers.baiduqianfan.apiKey "your-api-key" openclaw config set providers.baiduqianfan.secretKey "your-secret-key"`

设置默认模型：`bash openclaw config set agents.defaults.model.primary "deepseek/deepseek-chat"`

---

🌐 启动服务

`bash

启动 Gateway（核心服务）

openclaw gateway start

查看状态

openclaw status

打开控制面板

openclaw dashboard`

启动后访问 http://localhost:18789 即可进入 Web Chat 界面。

---

📱 接入飞书

步骤 1：创建飞书应用

1. 访问 [飞书开放平台](https://open.feishu.cn/) 2. 创建企业自建应用 3. 获取 App ID 和 App Secret

步骤 2：配置权限

在飞书应用后台添加以下权限：

• im:message - 获取与发送消息

• im:message.group_msg - 接收群聊消息

• im:message.p2p_msg - 接收单聊消息

步骤 3：配置 OpenClaw

`bash

启用飞书通道

openclaw config set channels.feishu.enabled true

配置 App ID 和 Secret

openclaw config set channels.feishu.appId "cli_xxxxx" openclaw config set channels.feishu.appSecret "your-app-secret"

设置连接模式

openclaw config set channels.feishu.connectionMode "websocket"`

步骤 4：重启 Gateway

`bash openclaw gateway restart`

---

💬 接入微信/Telegram/Discord

Telegram

`bash

创建 Bot（找 @BotFather）

获取 Bot Token

openclaw config set channels.telegram.enabled true openclaw config set channels.telegram.botToken "123456:ABC-xxxxx" openclaw gateway restart`

Discord

`bash

创建 Bot（Discord Developer Portal）

获取 Bot Token

openclaw config set channels.discord.enabled true openclaw config set channels.discord.botToken "your-bot-token" openclaw gateway restart`

---

⏰ 定时任务

OpenClaw 内置 Cron 调度器，可以设置定时任务：

`bash

每天早上 8 点提醒

openclaw cron add --name "morning-reminder" --schedule "0 8 *" --message "早安！今天有什么计划？"

每 30 分钟心跳检测

openclaw cron add --name "healthcheck" --schedule "/30 *" --message "系统检查中..."`

---

🧠 记忆系统

OpenClaw 有完整的记忆系统，会记住你的偏好、习惯、重要信息：

`记忆文件位置： ~/.openclaw/workspace/MEMORY.md     # 长期记忆 ~/.openclaw/workspace/memory/       # 每日日志`

手动添加记忆：`记住：我喜欢喝咖啡，每天早上 9 点提醒我`

---

🔧 常用命令

`bash

查看状态

openclaw status

查看日志

openclaw logs --follow

重启服务

openclaw gateway restart

检查问题

openclaw doctor

更新版本

npm update -g openclaw`

---

🐛 常见问题

1. Gateway 启动失败

`bash

检查端口占用

lsof -i :18789

杀掉占用进程

kill -9

本文链接：https://www.kkkliao.cn/?id=615 转载需授权！