OpenClaw 本地部署教程 - 从 0 到 1 跑通你的第一只龙虾

基于官方文档：docs.openclaw.ai/start/getti...

一、前置准备

在安装 OpenClaw 之前，你需要准备：

1. Node.js 22+

OpenClaw 需要 Node.js 22 或更高版本。

bash 复制代码

# 检查版本
node --version

如果版本低于 22，推荐使用 nvm 管理 Node 版本：

bash 复制代码

# 安装 nvm（如果没有）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 安装并使用 Node 22
nvm install 22
nvm use 22

2. 代码编辑器（可选）

推荐 VS Code，官网下载：code.visualstudio.com/

3. Git（可选）

用于版本控制，官网下载：git-scm.com/

二、安装 OpenClaw

macOS / Linux

arduino 复制代码

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

Windows

在 PowerShell 中运行：

arduino 复制代码

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

💡 安装脚本会自动检测环境并完成配置。

三、初始化配置

安装完成后，运行引导向导：

css 复制代码

openclaw onboard --install-daemon

这个命令会：

配置认证信息
设置 Gateway 参数
安装系统服务（后台运行）
可选：配置渠道（如微信、Telegram、飞书等）

按提示操作即可，中途可选择要连接的渠道。

四、启动服务

检查 Gateway 状态

lua 复制代码

openclaw gateway status

如果显示 running，表示服务已启动。

打开控制台界面

复制代码

openclaw dashboard

然后在浏览器打开：http://127.0.0.1:18789

即可开始和 AI 助手聊天！

五、后台运行

在初始化时使用了 --install-daemon，OpenClaw 会作为系统服务自动后台运行。

常用命令

bash 复制代码

# 查看状态
openclaw gateway status

# 停止服务
openclaw gateway stop

# 重启服务
openclaw gateway restart

# 前台运行（调试用）
openclaw gateway --port 18789

六、更多配置

环境变量（可选）

OPENCLAW_HOME - 设置主目录
OPENCLAW_STATE_DIR - 设置状态目录
OPENCLAW_CONFIG_PATH - 配置文件路径

连接更多渠道

官网文档：docs.openclaw.ai/channels

支持微信、Telegram、飞书、Discord、Slack 等主流平台。

七、配置飞书渠道

参考：docs.openclaw.ai/channels/fe...

方式一：引导向导（推荐）

如果你刚安装完 OpenClaw，运行：

复制代码

openclaw onboard

或之后添加渠道：

csharp 复制代码

openclaw channels add

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

方式二：手动配置

第一步：创建飞书应用

打开飞书开放平台
点击 创建企业应用 → 填写名称和描述
在 凭证与基础信息 中复制：
1. App ID （格式：cli_xxx）
2. App Secret

第二步：配置权限

在权限页面，点击 批量导入，粘贴：

json 复制代码

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application:self_manage",
      "im:message",
      "im:message:send_as_bot",
      "im:message.p2p_msg:readonly",
      "im:message.group_at_msg:readonly",
      "im:chat.members:bot_access",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write"]
  }
}

第三步：开启 Bot 能力

在 应用能力 → Bot：

启用 Bot 能力
设置机器人名称

第四步：配置事件订阅

⚠️ 注意：先确保 Gateway 已运行，再配置事件订阅！

进入 事件订阅
选择 使用长连接接收事件（WebSocket）
添加事件：im.message.receive_v1

第五步：发布应用

在 版本管理与发布 创建版本
提交审核并发布（企业应用通常自动通过）

配置 OpenClaw

编辑 ~/.openclaw/openclaw.json：

json 复制代码

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "你的AppSecret",
          "botName": "我的AI助手"
        }
      }
    }
  }
}

启动测试

bash 复制代码

# 启动 Gateway
openclaw gateway

# 在飞书找到你的 Bot，发消息测试

# 批准配对
openclaw pairing approve feishu <验证码>

常见问题

Q: 安装报错怎么办？ A: 确保 Node.js 版本 >= 22，参考官网排查：docs.openclaw.ai/install

Q: 怎么修改 API Key？ A: 运行 openclaw config 或直接编辑配置文件。

Q: 想用国产 大模型 怎么办？ A: 在配置中添加硅基流动、DeepSeek 等 API，支持多种模型接入。

Q: 群聊中 Bot 不响应？ A: 检查是否 @了 Bot，确认 groupPolicy 不是 disabled

Q: Bot 收不到消息？ A: 确保应用已发布、已添加 im.message.receive_v1 事件、Gateway 已运行

下一步

🔗 配对设备：docs.openclaw.ai/channels/pa...
📱 连接更多渠道：docs.openclaw.ai/channels
⚙️ 高级配置：docs.openclaw.ai/start/setup