OpenClaw 安装指南#

OpenClaw 是一个开源免费的 AI 助手框架，支持多种大语言模型和频道集成。本文将带你从零开始安装 OpenClaw。

前提条件#

在开始之前，请确保你的系统满足以下要求：

Node.js: 22 或更高版本

::: tip 如果不确定 Node 版本，可以在终端运行 node --version 检查。 :::

安装步骤#

1. 安装 OpenClaw#

根据你的操作系统选择对应的安装命令：

macOS / Linux:

1
curl -fsSL https://clawd.org.cn/install.sh | bash

Windows (PowerShell):

1
iwr -useb https://clawd.org.cn/install.ps1 | iex

2. 运行引导向导#

安装完成后，运行以下命令启动引导配置：

1
openclaw-cn onboard --install-daemon

向导会引导你完成：

认证配置
网关设置
可选频道配置

3. 检查网关状态#

服务应该已经自动运行，你可以检查状态：

1
openclaw-cn gateway status

4. 打开控制 UI#

在浏览器中打开控制界面开始使用：

1
openclaw-cn dashboard

或者直接访问：http://127.0.0.1:18789/

可选：前台运行网关#

如果你想进行测试或故障排除，可以在前台运行网关：

1
openclaw-cn gateway --port 18789

常用环境变量#

如果需要自定义配置路径，可以设置以下环境变量：

变量名	说明
`OPENCLAW_HOME`	设置主目录
`OPENCLAW_STATE_DIR`	覆盖状态目录
`OPENCLAW_CONFIG_PATH`	覆盖配置文件路径

飞书接入教程#

如果你想把 AI 助手接入飞书机器人，可以按照以下步骤操作：

1. 创建飞书应用#

打开飞书开放平台，登录后点击「创建企业自建应用」
填写应用名称和描述，选择应用图标
在「凭证与基础信息」页面获取 App ID 和 App Secret
在「权限管理」页面导入以下权限：

1
{
2
  "scopes": {
3
    "tenant": [
4
      "aily:file:read",
5
      "aily:file:write",
6
      "application:application.app_message_stats.overview:readonly",
7
      "application:application:self_manage",
8
      "application:bot.menu:write",
9
      "cardkit:card:write",
10
      "contact:user.employee_id:readonly",
11
      "corehr:file:download",
12
      "docs:document.content:read",
13
      "event:ip_list",
14
      "im:chat",
15
      "im:chat.access_event.bot_p2p_chat:read",
16
      "im:chat.members:bot_access",
17
      "im:message",
18
      "im:message.group_at_msg:readonly",
19
      "im:message.group_msg",
20
      "im:message.p2p_msg:readonly",
21
      "im:message:readonly",
22
      "im:message:send_as_bot",
23
      "im:resource",
24
      "sheets:spreadsheet",
25
      "wiki:wiki:readonly"
26
    ],
27
    "user": [
28
      "aily:file:read",
29
      "aily:file:write",
30
      "im:chat.access_event.bot_p2p_chat:read"
31
    ]
32
  }
33
}

在「应用能力 > 机器人」页面开启机器人能力
在「事件订阅」页面添加事件 im.message.receive_v1（选择 WebSocket 长连接模式）
发布应用并等待审批

2. 配置 OpenClaw#

运行以下命令添加飞书渠道：

1
openclaw-cn channels add

选择 Feishu，输入 App ID 和 App Secret。

3. 启动并测试#

1
openclaw-cn gateway

在飞书中给机器人发送消息，配对后即可对话。

更多详细文档请参考 OpenClaw 官方文档

希望这篇教程能帮助你顺利安装 OpenClaw！如果有问题，欢迎随时交流。

OpenClaw 安装指南