OpenClaw 安装教程

OpenClaw 是一个强大的开源 AI 助手框架，可以帮你接管消息、管理日程、自动化各种任务。这篇教程将带你一步步完成安装和配置。

什么是 OpenClaw？

你可以把 OpenClaw理解为：

  • 🤖 私人 AI 秘书 — 帮你处理各种消息
  • 🔄 自动化中枢 — 连接飞书、微信、Telegram 等平台
  • 🧠 可定制智能体 — 按需求打造专属助手

系统要求

  • Node.js: 24.x（推荐）或 22.x LTS
  • 系统: macOS / Linux / Windows (WSL2)
  • 内存: 最少 2GB，推荐 4GB+

安装方式

方式一：一键安装脚本（推荐）

1
curl -fsSL https://openclaw.ai/install.sh | bash

这个脚本会自动：

  1. 检测并安装 Node.js（如需要）
  2. 下载安装 OpenClaw
  3. 启动新手引导

如果只想安装 CLI，跳过新手引导：

1
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

方式二：npm / pnpm

1
2
3
4
5
# 使用 npm
npm install -g openclaw

# 或使用 pnpm
pnpm add -g openclaw

方式三：Docker

1
2
3
4
5
docker run -d \
  --name openclaw \
  -v ~/.openclaw:/home/node/.openclaw \
  -p 8080:8080 \
  ghcr.io/openclaw/openclaw

首次配置

安装完成后，运行配置向导：

1
openclaw config edit

配置示例

以下是我的配置文件，供你参考：

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
39
40
{
  "gateway": {
    "port": 18789,
    "bind": "loopback",
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "你的token"
    }
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "你的AppID",
      "appSecret": "你的AppSecret",
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist"
    }
  },
  "models": {
    "providers": {
      "bailian": {
        "apiKey": "你的APIKey",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "models": [
          "qwen3.5-plus",
          "MiniMax-M2.5",
          "kimi-k2.5"
        ]
      }
    }
  },
  "plugins": {
    "entries": {
      "feishu": {
        "enabled": true
      }
    }
  }
}

配置说明

配置项 说明 示例值
gateway.port Web 服务端口 18789
gateway.bind 绑定地址 loopback
channels.* 消息渠道配置 飞书/微信/Telegram
models.* AI 模型配置 阿里云百炼/OpenAI

启用飞书

  1. 在飞书开放平台创建应用
  2. 获取 App ID 和 App Secret
  3. 添加权限：im:message、im:chat:readonly 等
  4. 在配置中填入相应信息

验证安装

1
openclaw status

正常的话会显示运行状态和版本信息。

常见问题

Q: 端口被占用？
A: 修改 gateway.port 为其他端口

Q: 模型连接失败？
A: 检查 API Key 是否正确，网络是否正常

Q: 飞书收不到消息？
A: 检查 App Secret 和权限配置

下一步

安装好后可以尝试：

  • 配置飞书/Telegram/微信
  • 设置定时任务
  • 对接语音合成

有问题欢迎在评论区留言交流！

本文由博客小助手协助撰写