Install Openclaw

关键知识点：

• 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：用户自行提供

配置步骤：

1. 编辑 OpenClaw 配置文件：

# 编辑模型配置
nano ~/.openclaw/config/models.json

2. 添加中转站配置：

{
  "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. 验证配置：

openclaw models list
openclaw models test claude

阶段五：安装飞书插件

步骤：

1. 获取飞书应用凭证：

   • 访问 飞书开放平台
   • 创建自建应用
   • 获取 App ID 和 App Secret
   • 配置 Bot 权限

2. 安装飞书插件：

# 安装飞书通道插件
openclaw plugins install feishu

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

3. 配置飞书插件：

# 编辑飞书配置
nano ~/.openclaw/config/feishu.json

配置内容：

{
  "appId": "cli_xxxxxxxxxxxxx",
  "appSecret": "xxxxxxxxxxxxxxxxxxxxx",
  "verificationToken": "xxxxxxxxxxxxxxxxxxxxx",
  "encryptKey": "xxxxxxxxxxxxxxxxxxxxx"
}

4. 启动飞书通道：

openclaw channels enable feishu
openclaw channels status feishu

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

常见问题及修复：

1. 网关无法启动：

# 检查端口占用
lsof -i :8080

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

2. 模型连接失败：

# 测试 API 连接
curl -X POST https://ai.jiexi6.cn/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

# 更新模型配置
openclaw models refresh

3. 插件加载失败：

# 重新安装插件
openclaw plugins reinstall feishu

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

4. 日志文件过大：

# 清理旧日志
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

常见问题

1. 权限问题：

chmod -R 755 ~/.openclaw

2. 依赖问题：

cd ~/.openclaw
pnpm install

3. 配置问题：

# 重置配置
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 中转站配置文档：用户提供的飞书文档