OpenClaw 安装指南

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

前提条件

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

Node.js: 22 或更高版本

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

安装步骤

1. 安装 OpenClaw

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

macOS / Linux:

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

Windows (PowerShell):

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

2. 运行引导向导

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

openclaw-cn onboard --install-daemon

向导会引导你完成：

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

3. 检查网关状态

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

openclaw-cn gateway status

4. 打开控制 UI

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

openclaw-cn dashboard

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

可选：前台运行网关

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

openclaw-cn gateway --port 18789

常用环境变量

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

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

飞书接入教程

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

1. 创建飞书应用

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

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

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

2. 配置 OpenClaw

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

openclaw-cn channels add

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

3. 启动并测试

openclaw-cn gateway

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

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

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