乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > OpenClaw 安装教程:打造你的专属 AI 助手

OpenClaw 安装教程:打造你的专属 AI 助手

当前时间： 1970-01-01 08:00:00 分类：办公文件 评论(0)
OpenClaw 安装教程:打造你的专属 AI 助手

OpenClaw 安装教程：打造你的专属 AI 助手

📝 本教程基于 OpenClaw 2026.3.8 版本，适用于 Windows 系统

OpenClaw 安装教程：打造你的专属 AI 助手

📝 注意：📝 本教程基于 OpenClaw 2026.3.8 版本，适用于 Windows 系统

一、什么是 OpenClaw？

OpenClaw 是一个开源的 AI 助手网关，它可以：

  • 多渠道接入：支持 WhatsApp、Telegram、Discord、飞书、iMessage 等多个平台
  • 自托管运行：在你自己的电脑上运行，数据完全掌控
  • 插件扩展：支持安装各种插件扩展功能
  • 多模型支持：支持 OpenAI、Claude、GLM（智谱）等多种 AI 模型

简单说，OpenClaw 让你可以通过微信、飞书、Telegram 等聊天软件与 AI 对话，就像有一个随时在线的私人助理。

二、安装前准备

2.1 网络环境

⚠️ 警告：⚠️ 重要提醒：OpenClaw 的安装脚本托管在海外服务器，因此国内用户必须具备科学上网能力，否则安装会失败。

2.2 Git 与 SSH Key 配置

OpenClaw 安装过程中会使用 git-scm 拉取代码，因此需要：

📸 图：Git 安装界面

# 1. 检查是否已安装 Gitgit --version# 2. 生成 SSH Key（如果还没有）#your_email@example.com填写自己的邮箱ssh-keygen -t ed25519 -C "your_email@example.com"# 3. 查看公钥内容cat ~/.ssh/id_ed25519.pub# 4. 将公钥添加到 GitHub/GitLab# 复制公钥内容，在 GitHub Settings -> SSH and GPG keys 中添加

📸 图：SSH Key 生成和添加到 GitHub 的界面

2.3 系统要求

  • 操作系统：Windows 10/11（推荐使用 WSL2）
  • Node.js：22.x 或更高版本
  • 内存：至少 4GB RAM
  • 磁盘空间：至少 500MB

三、一键安装

在 PowerShell（管理员权限）中运行：

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

📸 图：PowerShell 管理员权限界面

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

openclaw onboard

📸 图：配置向导启动界面

四、配置向导详解

4.1 选择模式

📸 图：配置向导模式选择界面

运行 openclaw onboard 后，会进入交互式配置流程：

  • QuickStart（推荐新手）：使用默认配置，快速启动
  • Advanced：完全自定义配置

建议首次安装选择 QuickStart。

4.2 配置 AI 模型

提供商
说明
国内可用
OpenAI
GPT 系列
需要代理
Anthropic
Claude 系列
需要代理
GLM（智谱）
国产大模型
✅ 直接可用
OpenRouter
多模型聚合
需要代理

国内用户推荐使用 GLM（智谱）：

  1. 访问 智谱开放平台
  2. 注册账号并获取 API Key,这里选择自己的服务商，智谱AI新用户送2000万Tokens，如果需要可以使用我的链接注册：
https://www.bigmodel.cn/invite?icode=0EDznL4L%2FUEi0u7Yi6SrlbC%2Fk7jQAKmT1mpEiZXXnFw%3D
  1. 在配置向导中选择 "Custom Provider" 或 "GLM"

4.3 工作目录

默认位置：~/.openclaw/workspace

这是 OpenClaw 存放配置、记忆文件、技能等的地方。

4.4 Gateway 配置(默认就行)

  • 端口：默认 18789
  • 绑定地址：本地回环（127.0.0.1）
  • 认证模式：Token（自动生成）

五、飞书配置详解

5.1 创建飞书应用

这里比较麻烦可以自己探索或者观看视频教程。

  1. 访问 飞书开放平台
  2. 进入「开发者后台」→「创建企业自建应用」
  3. 记录以下信息：

App ID：应用唯一标识 App Secret：应用密钥 4. App ID：应用唯一标识 5. App Secret：应用密钥

  • App ID：应用唯一标识
  • App Secret：应用密钥

5.2 配置应用权限

在应用的「权限管理」中，添加以下权限：

必需权限：

  • im:message - 获取与发送消息
  • im:message:send_as_bot - 以应用身份发消息
  • im:chat - 获取群组信息

可选权限（推荐添加）：

  • drive:drive - 云文档操作
  • wiki:wiki - 知识库操作
  • bitable:bitable - 多维表格操作

5.3 配置事件订阅

在「事件订阅」中：

  1. 连接方式：选择「使用 WebSocket」
  2. 点击「添加事件」，订阅以下事件：

im.message.receive_v1 - 接收消息 3. im.message.receive_v1 - 接收消息

  • im.message.receive_v1 - 接收消息

5.4 配置 OpenClaw

编辑配置文件 ~/.openclaw/openclaw.json：

{"channels": {"feishu": {"enabled": true,"appId": "cli_xxxxxxxxxxxxx","appSecret": "xxxxxxxxxxxxxxxxxxxxxxxx","connectionMode": "websocket","domain": "feishu","groupPolicy": "open"    }  }}

字段说明：

  • enabled：是否启用飞书渠道
  • appId：飞书应用的 App ID
  • appSecret：飞书应用的 App Secret
  • connectionMode：连接方式，推荐 websocket
  • groupPolicy：群组消息策略

open：接收所有群组消息 allowlist：只接收白名单群组消息

  • open：接收所有群组消息

  • allowlist：只接收白名单群组消息

  • open：接收所有群组消息

  • allowlist：只接收白名单群组消息

5.5 安装飞书插件

OpenClaw 的飞书功能通过插件提供：

# 插件会在配置飞书渠道时自动安装# 也可以手动安装openclaw plugins install @openclaw/feishu

5.6 发布应用

在飞书开放平台：

  1. 提交应用审核
  2. 审核通过后，发布到企业
  3. 在飞书中搜索并添加机器人

六、常用命令

# 查看 Gateway 状态openclaw gateway status# 启动 Gatewayopenclaw gateway start# 停止 Gatewayopenclaw gateway stop# 打开 Web 控制台openclaw dashboard# 查看日志openclaw logs --follow# 查看配对列表openclaw pairing list feishu# 批准配对请求openclaw pairing approve feishu # 运行诊断openclaw doctor

七、常见问题

Q1：安装脚本下载失败

⚠️ 警告：原因：无法访问 openclaw.ai

解决：

  1. 确保已开启科学上网
  2. 在 PowerShell 中设置代理环境变量

Q2：Git 克隆失败

⚠️ 警告：原因：未配置 SSH Key

解决：

  1. 生成 SSH Key：ssh-keygen -t ed25519
  2. 将公钥添加到 GitHub
  3. 测试连接：ssh -T git@github.com

Q3：飞书机器人不回复

可能原因：

  • 应用未发布或未添加到群聊
  • 权限配置不完整
  • Gateway 未运行

排查步骤：

# 1. 检查 Gateway 状态openclaw gateway status# 2. 查看日志openclaw logs --follow# 3. 检查飞书配置openclaw channels status feishu

Q4：如何更换 AI 模型

编辑 ~/.openclaw/openclaw.json：

{"agents": {"defaults": {"model": {"primary": "zai/glm-5"      }    }  }}

可用模型：

  • zai/glm-5 - GLM-5（智谱）
  • openai/gpt-4o - GPT-4o
  • anthropic/claude-3-opus - Claude 3

Q5：如何查看 API Key 是否正确配置

# 查看当前配置（敏感信息会脱敏）openclaw config show# 测试模型连接openclaw model test

八、进阶配置

8.1 配置系统提示词

在 ~/.openclaw/workspace/SOUL.md 中定义 AI 的「性格」：

# SOUL.md - AI 人格定义## 核心特质- 简洁高效，不说废话- 有主见，敢于表达不同观点- 技术能力强，善于解决问题## 边界- 私密信息不外泄- 不确定的事情先询问

8.2 配置记忆系统

OpenClaw 有长期记忆功能：

  • MEMORY.md - 长期记忆
  • memory/YYYY-MM-DD.md - 每日记录

AI 会自动读取这些文件来「记住」之前的对话和重要信息。

8.3 安装技能（Skills）

技能是扩展 OpenClaw 能力的插件：

# 查看可用技能openclaw skills list# 安装技能openclaw skills install weather

九、安全建议

  1. API Key 安全

不要将 API Key 提交到公开仓库 定期更换 API Key 使用环境变量存储敏感信息 2. 不要将 API Key 提交到公开仓库 3. 定期更换 API Key 4. 使用环境变量存储敏感信息 5. 网络安全

默认绑定到 127.0.0.1，不对外暴露 如需远程访问，启用 Token 认证 考虑使用 Tailscale 进行安全远程访问 6. 默认绑定到 127.0.0.1，不对外暴露 7. 如需远程访问，启用 Token 认证 8. 考虑使用 Tailscale 进行安全远程访问 9. 权限控制

使用 allowlist 模式限制谁能访问 群组中启用 requireMention，只有 @机器人 时才响应 10. 使用 allowlist 模式限制谁能访问 11. 群组中启用 requireMention，只有 @机器人 时才响应

  • 不要将 API Key 提交到公开仓库

  • 定期更换 API Key

  • 使用环境变量存储敏感信息

  • 默认绑定到 127.0.0.1，不对外暴露

  • 如需远程访问，启用 Token 认证

  • 考虑使用 Tailscale 进行安全远程访问

  • 使用 allowlist 模式限制谁能访问

  • 群组中启用 requireMention，只有 @机器人 时才响应

附录：资源链接

  • 官网：https://openclaw.ai
  • 文档：https://docs.openclaw.ai
  • GitHub：https://github.com/openclaw/openclaw
  • 社区：https://discord.com/invite/clawd
  • 技能市场：https://clawhub.com
  • 智谱开放平台：https://open.bigmodel.cn

六、常用命令

查看 Gateway 状态

openclaw gateway status

启动 Gateway

openclaw gateway start

停止 Gateway

openclaw gateway stop

打开 Web 控制台

openclaw dashboard

查看日志

openclaw logs --follow

查看配对列表

openclaw pairing list feishu

批准配对请求

openclaw pairing approve feishu <CODE>

运行诊断

openclaw doctor

附录：资源链接

  • 官网
  • 文档
  • GitHub
  • 社区
  • 技能市场
  • 智谱开放平台

最后更新：2026年3月