OpenClaw 快速安装指南

准备工作

1. 获取必要信息

• AI模型API Key：选择下方任一提供商
  • DeepSeek
  • 火山引擎(豆包)
  • 阿里云(通义千问)
• 飞书应用：App ID + App Secret

2. 模型配置对照表

提供商	模型	Base URL	API Type
火山引擎	Doubao	https://ark.cn-beijing.volces.com/api/coding/v3	openai-completions
阿里云	Qwen	https://dashscope.aliyuncs.com/compatible-mode/v1	openai-completions
DeepSeek	DeepSeek	https://api.deepseek.com/v1	openai-completions
Anthropic	Claude	https://api.anthropic.com	anthropic-messages
OpenAI	GPT	https://api.openai.com/v1	openai-completions

安装步骤

第一步：安装 OpenClaw

# Windows
iwr -useb https://openclaw.ai/install.ps1 | iex

# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash

# 验证安装
openclaw --version

第二步：创建配置文件

推荐方式：先让系统自动生成，再修改！

# 运行一次 openclaw doctor 让系统自动生成完整配置
openclaw doctor

然后打开生成的配置文件，只修改以下部分：

配置文件位置：

• Windows: `C:\Users\你的用户名.openclaw\openclaw.json
• macOS/Linux: `~/.openclaw/openclaw.json

**需要修改的部分（用下面的模板替换对应部分）：

{
  "models": {
    "mode": "merge",
    "providers": {
      "volcano": {
        "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3",
        "apiKey": "你的火山引擎API Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "doubao-seed-2.0-code",
            "name": "doubao-seed-2.0-code",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 128000,
            "maxTokens": 32000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "volcano/doubao-seed-2.0-code"
      },
      "workspace": "C:\\Users\\你的用户名\\.openclaw\\workspace"
    }
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "main": {
          "appId": "你的飞书App ID",
          "appSecret": "你的飞书App Secret",
          "botName": "OpenClaw助手"
        }
      }
    }
  },
  "gateway": {
    "mode": "local",
    "port": 18789,
    "bind": "loopback",
    "controlUi": {
      "enabled": true,
      "basePath": "/openclaw"
    }
  }
}

切换其他模型：只需修改 providers 里的配置和 agents.defaults.model.primary 即可，参考上面的模型对照表。

第三步：安装并启动

# 安装飞书插件
openclaw plugins install @openclaw/feishu

# 启动网关
openclaw gateway start

# 检查状态
openclaw gateway status

第四步：配置飞书（详细步骤）

4.1 创建飞书应用

1. 访问 飞书开放平台 并登录
2. 进入 开发者后台 → 创建应用
3. 选择 自建应用，填写应用名称（如"OpenClaw助手"）
4. 点击 确定创建

4.2 获取 App ID 和 App Secret

1. 在应用详情页，找到 凭证与基础信息
2. 复制 App ID 和 App Secret
3. 填入配置文件的 channels.feishu.accounts.main 中

4.3 配置事件订阅（关键！）

1. 在左侧菜单选择 事件订阅
2. 点击 添加事件
3. 选择 接收消息方式 → 使用长连接接收事件 ⭐（重要！不用填回调URL）
4. 添加以下事件：
   • 接收消息 (im.message.receive_v1)
   • 消息已读 (im.message.message_read_v1)
5. 点击 保存

4.4 配置权限

1. 在左侧菜单选择 权限管理
2. 添加以下权限：
   • 获取用户基本信息
   • 读取群组信息
   • 发送消息
   • 读取消息
3. 点击 批量添加

4.5 发布应用版本

1. 在左侧菜单选择 版本管理与发布
2. 点击 创建版本
3. 填写版本号（如1.0.0）和更新说明
4. 点击 保存 → 申请发布
5. 选择 发布范围（建议先发布到"仅自己可见"测试）
6. 点击 确认发布

4.6 测试机器人

1. 打开飞书，搜索你创建的机器人名称
2. 给机器人发消息（如"你好"）
3. 如果收到回复，说明配置成功！

网络说明：飞书使用 WebSocket 长连接，不需要公网 URL！不需要内网穿透！

验证与故障排除

# 检查版本
openclaw --version

# 检查配置
openclaw doctor

# 查看日志
openclaw logs --follow

# 访问管理面板
http://127.0.0.1:18789/

常见问题

问题	解决方案
网关无法启动	检查端口18789、配置语法，运行 openclaw doctor --fix
飞书不响应	确认应用已发布、事件订阅正确、网关运行中
模型调用失败	确认API Key、Base URL、网络连接正常

配置文件说明

配置文件中的 meta、wizard、browser、messages、commands、session、hooks、plugins 等字段由 OpenClaw自动生成和管理，请勿手动修改！

只需要修改：

• models - AI模型配置
• agents - Agent默认配置
• channels - 飞书等渠道配置
• gateway - 网关配置

其他字段保持原样即可！

参考资源

• 官方文档: https://docs.openclaw.ai/
• 飞书开放平台: https://open.feishu.cn/

---

⚠️ 安全提示：请勿泄露API Key、App Secret等敏感信息！