dvcrn OpenClaw 全自动安装与配置
概述
本技能提供 OpenClaw 的一站式安装、配置和维护服务：
- 全自动安装 OpenClaw - 一键安装最新版本的 OpenClaw
- Claude API 中转站配置 - 接入用户的 AI 中转站
- 飞书插件集成 - 安装并配置飞书消息通道
- Bug 自动修复 - 检测并修复 OpenClaw 的常见问题
依赖
确保已安装：
- Node.js 18+
- pnpm
- Python 3.8+
工作流程
阶段一：学习 OpenClaw 文档
首先阅读 OpenClaw 官方文档，成为 OpenClaw 专家：
# 阅读本地文档
ls ~/Library/pnpm/global/*/node_modules/openclaw/docs/
# 查看安装文档
cat ~/Library/pnpm/global/*/node_modules/openclaw/docs/install/*.md
# 查看网关配置文档
cat ~/Library/pnpm/global/*/node_modules/openclaw/docs/gateway/*.md
关键知识点：
- OpenClaw 是一个自托管网关，连接聊天应用（WhatsApp、Telegram、Discord、iMessage 等）到 AI 助手
- 核心组件：Gateway（网关）、Control UI（控制界面）、Plugins（插件）
- 配置文件位置：
~/.openclaw/ - 日志文件位置：
~/.openclaw/logs/
阶段二：检查 OpenClaw 安装状态
# 检查是否已安装
which openclaw
openclaw --version
# 检查网关状态
openclaw gateway status
# 查看日志
openclaw logs --tail 100
阶段三：全自动安装 OpenClaw
如果未安装或需要重新安装：
# 使用官方安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash
# 或使用 pnpm 安装
pnpm add -g openclaw
# 验证安装
openclaw --version
阶段四：配置 Claude API 中转站
根据用户提供的中转站配置文档进行配置：
配置信息：
- AI 中转站 URL：
https://ai.jiexi6.cn - API Key：用户自行提供
配置步骤：
- 编辑 OpenClaw 配置文件：
# 编辑模型配置
nano ~/.openclaw/config/models.json
- 添加中转站配置：
{
"models": {
"claude": {
"provider": "openai-compatible",
"baseUrl": "https://ai.jiexi6.cn/v1",
"apiKey": "用户_API_Key",
"models": ["claude-sonnet-4-5-20250929", "claude-opus-4-5-20250929"]
}
}
}
- 验证配置：
openclaw models list
openclaw models test claude
阶段五：安装飞书插件
步骤：
获取飞书应用凭证：
- 访问 飞书开放平台
- 创建自建应用
- 获取 App ID 和 App Secret
- 配置 Bot 权限
安装飞书插件：
# 安装飞书通道插件
openclaw plugins install feishu
# 或手动安装
cd ~/.openclaw/plugins
git clone https://github.com/openclaw/feishu-plugin.git
- 配置飞书插件：
# 编辑飞书配置
nano ~/.openclaw/config/feishu.json
配置内容：
{
"appId": "cli_xxxxxxxxxxxxx",
"appSecret": "xxxxxxxxxxxxxxxxxxxxx",
"verificationToken": "xxxxxxxxxxxxxxxxxxxxx",
"encryptKey": "xxxxxxxxxxxxxxxxxxxxx"
}
- 启动飞书通道：
openclaw channels enable feishu
openclaw channels status feishu
阶段六：Bug 自动检测与修复
常见问题及修复：
- 网关无法启动：
# 检查端口占用
lsof -i :8080
# 清理并重启
openclaw gateway stop
openclaw gateway clean
openclaw gateway start
- 模型连接失败：
# 测试 API 连接
curl -X POST https://ai.jiexi6.cn/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"
# 更新模型配置
openclaw models refresh
- 插件加载失败：
# 重新安装插件
openclaw plugins reinstall feishu
# 检查插件依赖
cd ~/.openclaw/plugins/feishu
pnpm install
- 日志文件过大：
# 清理旧日志
openclaw logs clean --days 7
# 配置日志轮转
nano ~/.openclaw/config/logging.json
阶段七：验证和测试
# 检查整体状态
openclaw status
# 测试消息发送
openclaw message send --channel feishu --to "测试用户" --message "测试消息"
# 查看运行状态
openclaw gateway logs --tail 50
自动化脚本
运行全自动安装脚本：
# 进入技能目录
cd ~/.openclaw/workspace/skills/install-openclaw
# 运行安装脚本
./scripts/install.sh
# 运行配置脚本
./scripts/configure-claude.sh
# 运行飞书安装脚本
./scripts/install-feishu.sh
# 运行修复脚本
./scripts/fix-bugs.sh
故障排查
查看日志
# 查看网关日志
tail -f ~/.openclaw/logs/gateway.log
# 查看插件日志
tail -f ~/.openclaw/logs/plugins/feishu.log
# 使用 openclaw 命令查看
openclaw logs --follow
常见问题
- 权限问题：
chmod -R 755 ~/.openclaw
- 依赖问题：
cd ~/.openclaw
pnpm install
- 配置问题：
# 重置配置
openclaw config reset
# 重新配置
openclaw onboard
记忆要点
将以下信息写入 MEMORY.md：
- OpenClaw 安装路径：
~/Library/pnpm/global/*/node_modules/openclaw/ - 配置目录：
~/.openclaw/ - 日志目录：
~/.openclaw/logs/ - AI 中转站 URL：
https://ai.jiexi6.cn - 飞书文档： https://open.feishu.cn/document/server-docs/docs/docs/docx-v1/docx-overview
下一步
安装完成后：
- 运行
openclaw onboard完成向导设置 - 访问 Control UI：http://localhost:8080
- 配对移动设备
- 测试消息收发
参考文档：
- OpenClaw 官方文档：https://docs.openclaw.ai/
- 飞书开放平台：https://open.feishu.cn/
- AI 中转站配置文档：用户提供的飞书文档