Install Openclaw

---
name: install-openclaw
description: "OpenClaw 全自动安装、配置和修复工具。包括：OpenClaw 安装、Claude API 中转站配置、飞书插件集成、bug 自动修复。当用户需要安装、配置或修复 OpenClaw 时使用此技能。"
---

# OpenClaw 全自动安装与配置

## 概述

本技能提供 OpenClaw 的一站式安装、配置和维护服务：

1. **全自动安装 OpenClaw** - 一键安装最新版本的 OpenClaw
2. **Claude API 中转站配置** - 接入用户的 AI 中转站
3. **飞书插件集成** - 安装并配置飞书消息通道
4. **Bug 自动修复** - 检测并修复 OpenClaw 的常见问题

## 依赖

确保已安装：
- Node.js 18+ 
- pnpm
- Python 3.8+

## 工作流程

### 阶段一：学习 OpenClaw 文档

首先阅读 OpenClaw 官方文档，成为 OpenClaw 专家：

```bash
# 阅读本地文档
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 安装状态

```bash
# 检查是否已安装
which openclaw
openclaw --version

# 检查网关状态
openclaw gateway status

# 查看日志
openclaw logs --tail 100
```

### 阶段三：全自动安装 OpenClaw

如果未安装或需要重新安装：

```bash
# 使用官方安装脚本
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：用户自行提供

**配置步骤：**

1. 编辑 OpenClaw 配置文件：
```bash
# 编辑模型配置
nano ~/.openclaw/config/models.json
```

2. 添加中转站配置：
```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"]
    }
  }
}
```

3. 验证配置：
```bash
openclaw models list
openclaw models test claude
```

### 阶段五：安装飞书插件

**步骤：**

1. 获取飞书应用凭证：
   - 访问 [飞书开放平台](https://open.feishu.cn/app)
   - 创建自建应用
   - 获取 App ID 和 App Secret
   - 配置 Bot 权限

2. 安装飞书插件：
```bash
# 安装飞书通道插件
openclaw plugins install feishu

# 或手动安装
cd ~/.openclaw/plugins
git clone https://github.com/openclaw/feishu-plugin.git
```

3. 配置飞书插件：
```bash
# 编辑飞书配置
nano ~/.openclaw/config/feishu.json
```

配置内容：
```json
{
  "appId": "cli_xxxxxxxxxxxxx",
  "appSecret": "xxxxxxxxxxxxxxxxxxxxx",
  "verificationToken": "xxxxxxxxxxxxxxxxxxxxx",
  "encryptKey": "xxxxxxxxxxxxxxxxxxxxx"
}
```

4. 启动飞书通道：
```bash
openclaw channels enable feishu
openclaw channels status feishu
```

### 阶段六：Bug 自动检测与修复

**常见问题及修复：**

1. **网关无法启动：**
```bash
# 检查端口占用
lsof -i :8080

# 清理并重启
openclaw gateway stop
openclaw gateway clean
openclaw gateway start
```

2. **模型连接失败：**
```bash
# 测试 API 连接
curl -X POST https://ai.jiexi6.cn/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

# 更新模型配置
openclaw models refresh
```

3. **插件加载失败：**
```bash
# 重新安装插件
openclaw plugins reinstall feishu

# 检查插件依赖
cd ~/.openclaw/plugins/feishu
pnpm install
```

4. **日志文件过大：**
```bash
# 清理旧日志
openclaw logs clean --days 7

# 配置日志轮转
nano ~/.openclaw/config/logging.json
```

### 阶段七：验证和测试

```bash
# 检查整体状态
openclaw status

# 测试消息发送
openclaw message send --channel feishu --to "测试用户" --message "测试消息"

# 查看运行状态
openclaw gateway logs --tail 50
```

## 自动化脚本

运行全自动安装脚本：

```bash
# 进入技能目录
cd ~/.openclaw/workspace/skills/install-openclaw

# 运行安装脚本
./scripts/install.sh

# 运行配置脚本
./scripts/configure-claude.sh

# 运行飞书安装脚本
./scripts/install-feishu.sh

# 运行修复脚本
./scripts/fix-bugs.sh
```

## 故障排查

### 查看日志

```bash
# 查看网关日志
tail -f ~/.openclaw/logs/gateway.log

# 查看插件日志
tail -f ~/.openclaw/logs/plugins/feishu.log

# 使用 openclaw 命令查看
openclaw logs --follow
```

### 常见问题

1. **权限问题：**
```bash
chmod -R 755 ~/.openclaw
```

2. **依赖问题：**
```bash
cd ~/.openclaw
pnpm install
```

3. **配置问题：**
```bash
# 重置配置
openclaw config reset

# 重新配置
openclaw onboard
```

## 记忆要点

将以下信息写入 MEMORY.md：

1. **OpenClaw 安装路径：** `~/Library/pnpm/global/*/node_modules/openclaw/`
2. **配置目录：** `~/.openclaw/`
3. **日志目录：** `~/.openclaw/logs/`
4. **AI 中转站 URL：** `https://ai.jiexi6.cn`
5. **飞书文档：** https://open.feishu.cn/document/server-docs/docs/docs/docx-v1/docx-overview

## 下一步

安装完成后：
1. 运行 `openclaw onboard` 完成向导设置
2. 访问 Control UI：http://localhost:8080
3. 配对移动设备
4. 测试消息收发

---

**参考文档：**
- OpenClaw 官方文档：https://docs.openclaw.ai/
- 飞书开放平台：https://open.feishu.cn/
- AI 中转站配置文档：用户提供的飞书文档