OpenClaw 安装配置教程

AI基础 OpenClawAgent  收藏
0 / 9

核心特性

✨ 主要功能
🤖 AI 代理桥接 — 连接 Pi 代理（RPC 模式），支持工具流式传输
💬 流式响应 — 块流式传输 + Telegram 草稿流式传输
🧠 多代理路由 — 将不同提供者/用户路由到隔离的代理
🔐 订阅认证 — Anthropic (Claude Pro/Max) + OpenAI (ChatGPT/Codex) via OAuth
💬 会话管理 — 私聊合并为共享的 main 会话；群聊隔离
👥 群聊支持 — @提及触发（可配置为始终响应）
📎 媒体支持 — 发送和接收图片、音频、文档
🎤 语音笔记 — 可选的转录钩子
🖥️ WebChat + macOS 应用 — 本地 UI + 菜单栏辅助
📱 iOS/Android 节点 — 配对后暴露 Canvas + 聊天 + 摄像头

系统要求

基础要求

Node.js：≥ 22.x
内存：最低 2GB，推荐 4GB+
磁盘空间：最低 1GB，推荐 5GB+

各平台要求

macOS

如果要构建应用：安装 Xcode / Command Line Tools
仅 CLI + Gateway：Node.js 足够

Windows

强烈推荐使用 WSL2（推荐 Ubuntu）
原生 Windows 未测试，问题更多，工具兼容性较差
必须先安装 WSL2，然后在 WSL 内运行 Linux 步骤

Linux

无额外要求

🌐 网络要求

需要访问互联网（API 调用）
国内用户：必须使用代理，否则 Gateway 无法启动

安装 Node.js

使用 nvm 安装（推荐）

curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash
. ~/.bashrc
nvm install 22
node --version  # 应显示 v22.x.x

安装 OpenClaw

macOS / Linux

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

Windows (PowerShell)

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

安装过程会自动完成：

  • 检测系统环境
  • 安装必要依赖（Node.js 等）
  • 下载 OpenClaw 核心文件
  • 配置环境变量
  • 启动配置向导

初始配置向导

安装完成后，会自动进入配置向导（openclaw onboard）。

一）风险告知

这一步主要是告诉你，使用 OpenClaw 可能会有一些风险。请问你是否继续？
按 向左方向键 ←，选择 Yes，按 Enter 回车确认

二）选择 QiuickStart 模式

三）配置 AI 模型 API Key

OpenClaw 需要连接到大语言模型才能工作。Openclaw 比较费 token，国外模型成本高，门槛也高，这里我选择国内的智谱的 GLM 4.7

如果没有智谱的 API Key，点击官方地址自己注册账号获取 API key：https://www.bigmodel.cn/glm-coding?ic=RBSKXMPNJP

输入自己的 API Key：

四）选择 AI 模型

这里我选择默认的 GLM 4.7，也是智普当前的旗舰模型

五）连接即时通讯平台

配置完 AI 模型后，OpenClaw 会询问你要连接哪个通讯平台？

OpenClaw 原生支持的即时通信平台主要是海外的 WhatsApp、Telegram、Discord、Slack、iMessage 等，国内用户不习惯，这里国产即时通信软件大厂也跟进了，现在钉钉，飞书等都已支持接入 OpenClaw

后面会带领大家把飞书机器人接入 OpenClaw，使大家可以通过飞书即可指挥 OpenClaw 为我们干活，但是飞书配置比较复杂，这里我们先选择跳过，后面我们可以通过继续进行配置：

六）选择 Skills

这里也选择：No，暂不配置，后面通过 UI 界面进行配置：

七）是否开启 Hooks

操作步骤：先敲空格 ，表示选中当前项，再敲回车键

八）启动服务并打开 UI 界面

此时它会自动再打开一个命令窗口来启动服务:

这个过程是在启动服务，可能会需要等一点时间

同时，大约过 30 秒左右，我们回到刚才的设置窗口，选择 Open the Web UI ，打开 OpenClaw 的 UI 界面：

浏览器自动打开 Web UI 界面：

九）测试一下

接入飞书机器人

我们需要先到飞书平台创建自己的机器人来接入 OpenClaw：

一）来到飞书开发者后台

飞书开放平台地址：https://open.feishu.cn

没有飞书账号的，需要自己注册账号

点击右上角进入 开发者后台 ：

二）创建应用

三）填写应用信息

四）获取自己的应用凭证

五）给应用添加机器人

六）给应用配置权限

把即时通讯相关的权限全部开通：

七）创建版本并发布

来到飞书客户端进行审批：

八）安装飞书插件

打开 powershell，输入以下命令，安装飞书插件：

openclaw plugins install @m1heng-clawd/feishu

安装成功后，再打开一个新的命令窗口，开始配置飞书插件：

输入命令：openclaw config

选择渠道:

选择配置链接:

输入飞书的 AppID，AppSecrect：

域名选择中国的：

接受群组聊天：

选择完成：

选择 yes：

选择 open：

选择继续，完成配置：

重启服务，使配置生效：
控制可以看到飞书插件已经配置成功

七）回到飞书后台设置事件回调

选择 使用长连接接收事件 ：

可以看到添加事件按钮由原来的灰色不可点击变为可点击：

添加接收消息事件：

给应用开通获取通讯录基本信息的权限：

重新发布版本：

跟前面的步骤一样，发布为在线应用即可。

现在可以在 飞书中与 AI 助手对话了！

八）在飞书中与 OpenClaw 对话

来到飞书客户端或者手机飞书 app 上：

以下是 openclaw 文件夹下面的文档内的内容：

现在我跟废水机器人对话，让他告诉我指定文档内是什么内容：

访问 Web 控制面板

配置完成后，PowerShell 窗口底部会显示控制面板链接，格式类似：

Control UI: http://127.0.0.1:18789
  1. 复制完整链接
  2. 在浏览器中打开
  3. 即可看到可视化 UI 管理界面

常用命令速查

命令 功能
openclaw onboard 重新进入配置向导
openclaw status 查看运行状态
openclaw health 健康检查
openclaw gateway start 启动服务
openclaw gateway stop 停止服务
openclaw update 更新到最新版本
openclaw doctor 诊断问题
openclaw uninstall 卸载 OpenClaw

常见问题解答

Q1: 安装飞书插件提示：spawn npm ENOENT

问题原因：这可能是 openclaw 的一个 bug，可以等官方更新，也可以自己去官方仓库提 issue

解决步骤：

定位问题代码

文件路径：

C:\Users\Administrator\AppData\Roaming\fnm\node-versions\v22.14.0\installation\node_modules\openclaw\dist\process\exec.js

修改代码

找到 runCommandWithTimeout 函数中的 spawn 调用，修改如下：

修改前：

const stdio = resolveCommandStdio({ hasInput, preferInherit: true });
const child = spawn(argv[0], argv.slice(1), {
    stdio,
    cwd,
    env: resolvedEnv,
    windowsVerbatimArguments,
});

修改后：

const stdio = resolveCommandStdio({ hasInput, preferInherit: true });
// On Windows, npm must be spawned with shell: true or use .cmd extension
let command = argv[0];
let useShell = false;
if (process.platform === "win32" && path.basename(command) === "npm") {
    useShell = true;
}
const child = spawn(command, argv.slice(1), {
    stdio,
    cwd,
    env: resolvedEnv,
    shell: useShell,
});

Q2: 提示 "openclaw 命令找不到"

解决方法：

  1. 关闭所有 PowerShell 窗口
  2. 重新打开 PowerShell
  3. 如果还不行，执行 exec bash 或重启电脑

Q3: 安装卡住不动

解决方法：

  1. 按 Ctrl + C 中断当前操作
  2. 执行：openclaw doctor 检查问题
  3. 如提示网络问题，检查防火墙设置

Q4: API Key 配置错误

解决方法：

  1. 执行：openclaw onboard
  2. 选择重新配置 API Key
  3. 确保密钥格式正确

Q5: 端口 18789 被占用

解决方法：

openclaw gateway --port 18790

使用其他端口启动服务。

成本说明

OpenClaw 软件本身完全免费，主要成本来自 AI 模型 API 调用，可选择国产大模型，降低成本。

结语

OpenClaw 代表了个人 AI 助理的未来趋势——从"聊天工具"进化为"执行工具"。虽然目前的配置过程对小白用户有一定门槛，但一旦完成设置，您将拥有一个 24/7 待命的超级助手。