OpenClaw 安装部署完整教程

一、部署方式选择
OpenClaw 支持两种部署方式:
方式 1:本地部署(推荐新手)
-
适用场景:个人使用、测试体验 -
优点:简单快速、数据完全本地 -
缺点:需要电脑常开
方式 2:服务器部署(推荐长期使用)
-
适用场景:7×24 小时运行、企业使用 -
优点:稳定可靠、不需要电脑常开 -
缺点:需要云服务器成本
二、本地部署(Windows/Mac)
2.1 环境准备
必需条件:
-
Node.js 18+ -
稳定的网络环境(需要访问 GitHub 和 npm)
检查 Node.js 版本:
node -v
# 如果版本低于 18,需要升级
安装 Node.js:
-
Windows:https://nodejs.org/zh-cn/download/ -
Mac: brew install node@18
2.2 安装 OpenClaw
npm install -g openclaw
如果安装失败:
# 清除 npm 缓存
npm cache clean --force
# 使用国内镜像
npm config set registry https://registry.npmmirror.com
# 重新安装
npm install -g openclaw
2.3 首次启动配置
openclaw
首次启动会自动进入安装向导,需要配置:
1. 选择 AI 模型
-
Claude(推荐) -
GPT-4 -
Kimi -
DeepSeek
2. 配置 API Key
-
根据选择的模型,提供对应的 API Key -
示例:选择 Claude,需要提供 Anthropic API Key
3. 配置聊天渠道
-
Telegram(推荐) -
飞书 -
Discord -
微信(需要额外配置)
2.4 配置 Telegram 渠道(推荐)
步骤 1:创建 Telegram Bot
-
在 Telegram 搜索 @BotFather -
发送 /newbot创建机器人 -
按提示设置机器人名称和用户名 -
获取 Bot Token(类似: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz)
步骤 2:获取你的 Chat ID
-
在 Telegram 搜索 @userinfobot -
发送任意消息 -
获取你的 Chat ID(类似: 123456789)
步骤 3:在 OpenClaw 中配置
-
选择 Telegram 渠道 -
输入 Bot Token -
输入你的 Chat ID
2.5 验证安装
打开 Telegram,给你的机器人发送:
你好,你叫什么名字?
如果机器人回复了,说明安装成功!
三、服务器部署(Linux)
3.1 服务器要求
最低配置:
-
CPU: 1 核 -
内存:512MB -
硬盘:10GB -
系统:Ubuntu 20.04+ 或 CentOS 7+
推荐配置:
-
CPU: 2 核 -
内存:1GB -
硬盘:20GB -
系统:Ubuntu 22.04
3.2 安装 Node.js
# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
# CentOS
curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
sudo yum install -y nodejs
3.3 安装 OpenClaw
sudo npm install -g openclaw
3.4 配置环境变量
创建配置文件:
mkdir -p ~/.openclaw
cd ~/.openclaw
nano config.json
配置文件内容:
{
"ai_model": "claude",
"api_key": "你的 API Key",
"channel": "telegram",
"bot_token": "你的 Bot Token",
"chat_id": "你的 Chat ID"
}
3.5 后台运行
使用 systemd 服务:
创建服务文件:
sudo nano /etc/systemd/system/openclaw.service
内容:
[Unit]
Description=OpenClaw AI Assistant
After=network.target
[Service]
Type=simple
User=your_username
WorkingDirectory=/home/your_username
ExecStart=/usr/bin/openclaw
Restart=always
[Install]
WantedBy=multi-user.target
启动服务:
sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw
# 查看状态
sudo systemctl status openclaw
3.6 防火墙配置
如果服务器有防火墙,需要放行:
# Ubuntu
sudo ufw allow 3000/tcp
# CentOS
sudo firewall-cmd --add-port=3000/tcp --permanent
sudo firewall-cmd --reload
四、配置 SOUL.md(个性化你的小龙虾)
4.1 什么是 SOUL.md?
SOUL.md 是小龙虾的”灵魂”配置文件,定义了:
-
说话风格 -
做事原则 -
边界限制
4.2 创建 SOUL.md
在 OpenClaw 配置目录创建文件:
nano ~/.openclaw/SOUL.md
4.3 配置模板
模板 1:助理型
# SOUL.md
你是鬼懿的 AI 助手。
## 说话风格
- 用大白话,像朋友聊天
- 简洁直接,不说废话
- 可以开玩笑,但知道分寸
## 做事原则
- 收到任务先说"收到"
- 不确定的事先问再做
- 完成后主动汇报结果
## 边界
- 不涉及政治、色情、暴力内容
- 不执行删除文件等危险操作
- 不泄露用户的隐私信息
模板 2:专业型
# SOUL.md
你是专业的 AI 研究员助手。
## 说话风格
- 专业严谨,数据驱动
- 引用来源要标注
- 复杂概念用比喻解释
## 做事原则
- 先确认需求细节
- 提供多个方案对比
- 给出推荐和理由
## 边界
- 只提供研究建议,不做决策
- 不确定的内容明确标注
- 定期整理研究笔记
模板 3:创意型
# SOUL.md
你是创意内容创作者。
## 说话风格
- 幽默风趣,有创意
- 善用比喻和故事
- 语言生动有画面感
## 做事原则
- 大胆尝试新想法
- 快速产出初稿
- 根据反馈快速迭代
## 边界
- 不抄袭,保持原创
- 符合品牌调性
- 避免敏感话题
4.4 应用配置
保存后重启 OpenClaw:
# 本地部署
openclaw
# 服务器部署
sudo systemctl restart openclaw
五、安装技能(Skills)
5.1 技能商店
ClawHub 技能商店:https://clawhub.ai
目前有 12000+ 个技能
5.2 一键安装技能
# 安装天气技能
npx clawhub@latest install weather
# 安装邮件技能
npx clawhub@latest install email
# 安装爬虫技能
npx clawhub@latest install crawler
5.3 查看已安装技能
npx clawhub@latest list
5.4 卸载技能
npx clawhub@latest uninstall weather
5.5 自己写技能
创建技能文件 SKILL.md:
# SKILL.md
技能名称:发送飞书消息
触发词:飞书、发消息
## 步骤
1. 准备飞书 Webhook URL
2. 构造消息内容
3. 发送 POST 请求
4. 返回发送结果
## 代码示例
```javascript
fetch(webhook_url, {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({msg_type: 'text', content: {text: message}})
})
---
## 六、配置定时任务(Cron)
### 6.1 直接对话设置
在 Telegram/飞书中直接说:
每天早上 8 点帮我搜一下 ComfyUI 最新动态,整理成中文发给我
小龙虾会自动创建 cron 任务。
### 6.2 查看定时任务
```bash
# 在聊天中问
我的定时任务有哪些?
6.3 删除定时任务
# 在聊天中说
删除每天早上 8 点的任务
七、常见问题
Q1: 安装失败怎么办?
解决方案:
-
检查 Node.js 版本(需要 18+) -
使用国内 npm 镜像 -
清除 npm 缓存重新安装
Q2: 机器人不回复怎么办?
检查清单:
-
Bot Token 是否正确 -
Chat ID 是否正确 -
网络连接是否正常 -
API Key 是否有效
Q3: 数据会泄露吗?
安全说明:
-
OpenClaw 运行在你的电脑/服务器上 -
数据不经过第三方 -
API 调用直接到模型提供商 -
比使用 ChatGPT 网页版更安全
Q4: 费用多少?
费用构成:
-
OpenClaw:免费开源 -
AI 模型:按量付费(Claude/GPT 等) -
服务器(可选):约 50-200 元/月
轻度使用示例:
-
每天对话 100 次 -
每月费用:约 30-50 元(API 费用)
Q5: 手机能用吗?
使用方式:
-
小龙虾运行在电脑/服务器上 -
通过 Telegram/飞书在手机上聊天 -
随时随地可以使用
八、下一步
安装完成后,你可以:
-
配置你的 SOUL.md – 让小龙虾更有个性 -
安装常用技能 – 天气、邮件、爬虫等 -
设置定时任务 – 自动日报、周报等 -
加入交流群 – 获取更多教程和案例
遇到问题?
-
官方文档:https://docs.openclaw.ai -
GitHub:https://github.com/openclaw/openclaw -
Discord 社区:https://discord.com/invite/clawd -
技能商店:https://clawhub.ai
扫一扫 微信咨询
商务合作 联系我们
微信扫一扫 