OpenClaw完全安装指南:从零开始搭建个人AI助手

5分钟上手，30分钟精通

OpenClaw 是什么

OpenClaw 是一个运行在你自己设备上的个人 AI 助手。它的主要特点：

• 多平台消息支持：微信、飞书、钉钉、企业微信等
• 本地优先：数据完全在你自己的机器上
• 语音交互：支持语音唤醒、语音对话
• 可视化画布：AI 可以控制实时画布展示内容
• 技能系统：像安装 App 一样安装各种 AI 技能

一句话理解：OpenClaw 就像是把 ChatGPT 变成了你的私人助理，可以通过微信、飞书等软件与你对话，而且完全运行在你自己的电脑上。

安装前准备

系统要求

项目	要求
操作系统	macOS、Linux、Windows (WSL2)
Node.js	Node 22 LTS 或更高
内存	至少 4GB RAM
网络	能访问 AI 服务

检查 Node.js 版本

打开终端，运行：

node --version

如果显示 v22.16.0 或更高版本，说明环境 OK。

安装 Node.js：

• macOS: brew install node
• Ubuntu/Debian: curl -fsSL https://deb.nodesource.com/setup\_22.x | sudo -E bash - && sudo apt-get install -y nodejs
• Windows: 从 Node.js 官网下载安装包

快速安装

只需要 3 步：

第 1 步：安装 OpenClaw

macOS / Linux：

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

Windows (PowerShell)：

iwr -useb https://openclaw.ai/install.ps1 | iex

第 2 步：运行初始化向导

openclaw onboard --install-daemon

这个命令会：

• 引导你配置 AI 模型
• 设置 Gateway 网关服务
• 可选：配置通讯渠道
• 安装系统服务

第 3 步：验证安装

openclaw gateway status

如果显示 running，安装成功！

详细安装步骤

方法一：官方安装脚本

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

或

npm install -g openclaw@latest

方法二：从源码安装

git clone github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm buildpnpm openclaw onboard --install-daemon

方法三：Docker 安装

docker-compose up -d

配置与初始化

运行 Onboarding 向导

openclaw onboard --install-daemon

选择 AI 模型

模型	特点	适用场景
OpenAI GPT-4	能力强，稳定	通用场景
Claude 3.5	上下文长	长文档、编程
Gemini	速度快	日常对话
本地模型	完全离线	隐私敏感

配置 API Key

• OpenAI: 从 OpenAI 官网获取
• Claude: 从 Anthropic 官网获取
• Gemini: 从 Google AI Studio 获取

验证 Gateway 运行状态

openclaw gateway statusopenclaw gateway startopenclaw gateway --verbose

打开控制面板

openclaw dashboard

访问 http://127.0.0.1:18789/

连接通讯渠道

支持的平台

平台	难度	说明
飞书	简单	推荐国内用户
微信	中等	个人用户常用
钉钉	中等	阿里生态
企业微信	中等	腾讯企业生态

飞书配置教程

1.
创建飞书应用

• 访问飞书开放平台
• 点击创建企业自建应用
• 获得 App ID 和 App Secret

2.
配置权限

• im:chat:readonly
• im:message:send
• im:message:receive

3. 配置 OpenClaw

openclaw configure --section channels.feishu

4.
配置事件订阅

• 设置请求地址
• 订阅消息事件

微信配置教程

1.
注册微信公众号

• 访问微信公众平台
• 注册订阅号或服务号

2.
获取 API 凭证

• 进入开发-基本配置
• 获取 AppID 和 AppSecret

3. 配置 OpenClaw

openclaw configure --section channels.wechat

配置多个渠道

openclaw configure --section channels.feishuopenclaw configure --section channels.wechatopenclaw configure --section channels.dingtalk

常见问题解决

安装失败，提示权限不足

mkdir ~/.npm-globalnpm config set prefix &#x27;~/.npm-global&#x27;echo &#x27;export PATH=~/.npm-global/bin:$PATH&#x27; >> ~/.bashrcsource ~/.bashrc

Gateway 启动失败

openclaw gateway --verboselsof -i :18789openclaw config resetopenclaw onboard

AI 不回复消息

检查清单：

• API Key 是否正确配置
• 账户是否有足够余额
• 网络是否能访问 AI 服务
• 查看日志：openclaw logs

Windows 安装问题

建议使用 WSL2：

wsl --install

进阶玩法

安装技能

skillhub search weatherskillhub install weather

热门技能：

• weather 天气查询
• image-gen AI 图像生成
• news-aggregator 新闻聚合
• remind-me 智能提醒

配置多模型故障转移

在 ~/.openclaw/config.json 中配置：

{  "models": {    "default": "openai/gpt-4",    "fallbacks": ["anthropic/claude-3-5"]  }}

启用语音功能

openclaw configure --section voice.wake.enabled=trueopenclaw configure --section voice.talk.enabled=true

设置定时任务

openclaw cron add --name "morning" --schedule "0 8 * * *" --message "早上好"

常用命令速查

命令	说明
openclaw onboard	初始化配置向导
openclaw dashboard	打开控制面板
openclaw gateway status	查看网关状态
openclaw gateway start/stop/restart	控制网关服务
openclaw doctor	诊断问题
openclaw configure	修改配置
openclaw update	更新到最新版

总结

现在你已经：

• 安装了 OpenClaw
• 配置了 AI 模型
• 学会了连接通讯渠道
• 掌握了基本使用方法

下一步建议：

1. 尝试连接飞书或微信
2. 安装实用技能
3. 探索 Canvas 可视化功能