引言：为什么选择OpenClaw？
OpenClaw是一个开源的AI助手平台，它将大型语言模型（LLM）的强大能力带到了你的日常通讯工具中。与传统的ChatGPT或Claude网页界面不同，OpenClaw可以直接集成到QQ、飞书、Telegram、Discord、Signal等主流通讯平台，让你在熟悉的聊天环境中享受AI助手的便利。
核心优势
- 多平台统一接入 - 一个AI助手，所有平台通用
- 强大的技能系统 - 通过ClawHub市场安装各种技能，扩展AI能力
- 灵活的模型配置 - 支持DeepSeek、GLM、Qwen、GPT等多种模型
- 本地部署 - 数据掌握在自己手中，隐私有保障
- 开源免费 - 基于MIT协议，社区活跃，持续更新
OpenClaw部署方法
本地安装（推荐）
1
2
3
4
5
6
7
8
9
10
|
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22
npm install -g @openclaw/cli
openclaw init
|
Docker部署（快速体验）
1
2
3
4
5
6
7
8
9
|
docker pull ghcr.io/openclaw/openclaw:latest
docker run -d \
--name openclaw \
-p 3000:3000 \
-v ~/.openclaw:/root/.openclaw \
ghcr.io/openclaw/openclaw:latest
|
VPS部署（生产环境）
1
2
3
4
5
6
|
ssh root@your-server
pm2 start openclaw-gw --name openclaw
pm2 save
pm2 startup
|
模型配置
OpenClaw支持多种AI模型，你可以根据需求灵活选择。
配置文件结构
OpenClaw的主要配置文件位于 ~/.openclaw/openclaw.json：
1
2
3
4
5
6
7
8
9
10
11
12
13
| {
"agents": {
"defaults": {
"models": {
"custom-api-deepseek-com/deepseek-reasoner": {},
"custom-api-deepseek-com/deepseek-chat": {},
"zai/glm-4.5-air": {},
"Qwen/qwen3.5-plus": {},
"Qwen/qwen3.5-flash": {}
}
}
}
}
|
主流模型配置示例
DeepSeek模型
1
2
3
4
5
6
7
8
| {
"models": {
"custom-api-deepseek-com/deepseek-reasoner": {
"provider": "custom-api-deepseek-com",
"apiKey": "${DEEPSEEK_API_KEY}"
}
}
}
|
智谱AI GLM模型
1
2
3
4
5
6
7
8
| {
"models": {
"zai/glm-4.5-air": {
"provider": "zai",
"apiKey": "${ZAI_API_KEY}"
}
}
}
|
通义千问Qwen模型
1
2
3
4
5
6
7
8
| {
"models": {
"Qwen/qwen3.5-plus": {
"provider": "Qwen",
"apiKey": "${QWEN_API_KEY}"
}
}
}
|
模型切换策略
在OpenClaw网页端Control UI中，你可以：
- 访问
http://your-server:3000/control 进入控制界面
- 在Config > Models中添加新的模型提供商
- 在Agent设置中选择默认模型
- 根据任务需求动态切换模型
Skills技能系统
Skills是OpenClaw的核心扩展机制，类似于浏览器的插件系统。
ClawHub技能市场
ClawHub（https://clawhub.com）是OpenClaw的官方技能市场，提供数百个技能：
- pptx技能 - 创建和编辑PowerPoint演示文稿
- hexo-blog-poster - 自动化发布Hexo博客
- domain-name-brainstormer - 域名创意生成和检查
- weather - 天气预报查询
- tmux - 远程控制tmux会话
- healthcheck - 服务器健康检查和安全加固
技能安装方法
1
2
3
4
5
6
7
8
9
|
cd ~/.nvm/versions/node/v22.22.1/lib/node_modules/openclaw/skills/
git clone https://github.com/anthropics/skills/tree/main/skills/pptx
openclaw skills install pptx
|
创建自定义技能
创建自定义技能只需要几个文件：
1
2
3
4
5
| my-skill/
├── SKILL.md # 技能说明文档
├── scripts/ # 执行脚本
├── references/ # 参考文档
└── config.json # 技能配置
|
多平台机器人对接
QQ机器人配置
QQ机器人基于Go-CQHTTP或官方QQ频道机器人：
1
2
3
4
5
6
7
8
9
10
11
12
13
|
account:
uin: 123456789
password: "your-password"
message:
post-format: array
servers:
host: 0.0.0.0
port: 5700
post:
- url: http://localhost:3000/qq-webhook
|
飞书机器人配置
- 在飞书开放平台创建企业自建应用
- 启用机器人能力
- 配置以下权限：
im:message 消息APIim:message:send_as_bot 发送消息im:message.p2p_msg 私聊消息im:message.group_at_msg 群聊@消息
1
2
3
4
5
6
7
8
9
| {
"channels": {
"feishu": {
"appId": "your-app-id",
"appSecret": "your-app-secret",
"verificationToken": "your-verification-token"
}
}
}
|
Telegram机器人配置
- 通过 @BotFather 创建Telegram机器人
- 获取API Token
- 配置Webhook或长轮询
1
2
3
4
5
6
7
8
9
10
| {
"channels": {
"telegram": {
"token": "your-bot-token",
"webhook": {
"url": "https://your-domain.com/telegram-webhook"
}
}
}
}
|
Discord机器人配置
- 在Discord开发者门户创建应用
- 添加Bot权限
- 获取Token
1
2
3
4
5
6
7
8
| {
"channels": {
"discord": {
"token": "your-discord-token",
"clientId": "your-client-id"
}
}
}
|
实战配置示例
完整配置文件示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
| {
"gateway": {
"bind": "0.0.0.0",
"port": 3000,
"controlUi": {
"allowedOrigins": ["*"]
}
},
"agents": {
"defaults": {
"model": "custom-api-deepseek-com/deepseek-reasoner",
"models": {
"custom-api-deepseek-com/deepseek-reasoner": {},
"custom-api-deepseek-com/deepseek-chat": {},
"zai/glm-4.5-air": {},
"Qwen/qwen3.5-plus": {},
"Qwen/qwen3.5-flash": {}
}
}
},
"channels": {
"feishu": {
"appId": "cli_xxxxxx",
"appSecret": "xxxxxx",
"verificationToken": "xxxxxx"
},
"qq": {
"type": "go-cqhttp",
"webhookUrl": "http://localhost:5700"
}
},
"models": {
"custom-api-deepseek-com/deepseek-reasoner": {
"provider": "custom-api-deepseek-com",
"apiKey": "${DEEPSEEK_API_KEY}"
}
}
}
|
环境变量管理
建议使用环境变量管理敏感信息：
1
2
3
4
5
6
7
|
echo "DEEPSEEK_API_KEY=sk-xxxxxx" >> ~/.openclaw/.env
echo "ZAI_API_KEY=xxxxxx" >> ~/.openclaw/.env
echo "QWEN_API_KEY=xxxxxx" >> ~/.openclaw/.env
"apiKey": "${DEEPSEEK_API_KEY}"
|
服务管理和监控
1
2
3
4
5
6
7
8
9
10
|
pm2 start openclaw-gw --name openclaw
pm2 save
pm2 startup
pm2 logs openclaw
pm2 monit
|
故障排除
常见问题
Q: 网页控制台无法访问？
A: 检查gateway.bind配置，确保不是"loopback"，应该是"0.0.0.0"。
Q: 模型在网页端看不到？
A: 确保模型已添加到agents.defaults.models列表中。
Q: 机器人收不到消息？
A: 检查通道配置和网络连通性，确保Webhook地址正确。
Q: 技能无法使用？
A: 检查技能目录权限和依赖是否安装。
调试命令
1
2
3
4
5
6
7
8
9
|
openclaw status
openclaw doctor
openclaw --version
openclaw models status --probe
|
安全建议
- 最小权限原则 - 只授予必要的API权限
- 环境变量管理 - 避免在配置文件中硬编码密钥
- 定期更新 - 保持OpenClaw和技能的最新版本
- 访问控制 - 配置
controlUi.allowedOrigins限制访问来源
- 日志审计 - 定期检查操作日志
总结
OpenClaw作为一个开源AI助手平台，为个人和企业提供了强大的自动化能力。通过本文的指南，你可以：
- ✅ 成功部署OpenClaw到各种环境
- ✅ 配置主流AI模型提供商
- ✅ 安装和使用丰富的技能扩展
- ✅ 对接QQ、飞书等多个通讯平台
- ✅ 实现生产环境的稳定运行
无论是个人助手、团队协作还是企业自动化，OpenClaw都能提供强大的支持。随着生态的不断发展，OpenClaw的能力将持续增强，为AI的民主化和普及化做出贡献。
相关资源：
标签： #OpenClaw #AI助手 #自动化 #部署指南 #QQ机器人 #飞书机器人
