OpenClaw安装与使用指南

OpenClaw安装与使用指南

什么是OpenClaw？

OpenClaw 是一款开源的个人 AI 智能体（Personal AI Agent），核心优势为本地部署 + 系统级执行 + 全渠道交互。它可以通过聊天工具（Telegram、WhatsApp、Discord等）下达指令，自动完成文件整理、代码部署、日程同步等任务，所有数据本地存储，隐私零泄露。

核心特性

• 本地部署：数据不出本地，隐私安全有保障
• 系统级执行：可执行 Shell 命令、访问文件系统
• 多渠道接入：支持 Telegram、WhatsApp、Discord、飞书、钉钉等
• 多模型支持：支持 OpenAI、Anthropic、智谱 GLM、阿里云百炼等多种 AI 模型

前置要求

硬件配置

软件要求

AI 模型 API Key

OpenClaw 支持多种 AI 模型提供商，本文以智谱 GLM-4.7-Flash 免费模型为例。

安装步骤

1. 检查并切换 Node.js 版本

OpenClaw 需要 Node.js 22+ 版本，使用 nvm 进行版本管理：

1
2
3
4
5
6
7
8
9
10
11
12

# 查看已安装的 Node.js 版本
nvm list

# 如果没有安装22+版本，先安装
nvm install 22

# 切换到22版本
nvm use 22

# 验证版本
node -v
# 输出: v22.14.0

2. 配置 npm 镜像（可选）

如果安装速度慢，可以切换到国内镜像：

1
2
3
4
5
6
7
8

# 查看可用镜像
nrm ls

# 测试镜像速度
nrm test

# 切换到最快的镜像（华为镜像通常较快）
nrm use huawei

3. 安装 OpenClaw CLI

1
2
3
4
5
6

# 全局安装 OpenClaw
npm install -g openclaw@latest

# 验证安装
openclaw --version
# 输出: 2026.3.2

安装过程可能需要几分钟，因为包含了很多依赖包。

4. 初始化配置

1
2

# 运行初始化向导
openclaw setup

输出示例：

1
2
3

Wrote ~\.openclaw\openclaw.json
Workspace OK: ~\.openclaw\workspace
Sessions OK: ~\.openclaw\agents\main\sessions

5. 配置智谱 GLM-4.7-Flash 模型

5.1 设置环境变量

1
2

# Windows PowerShell
$env:ZAI_API_KEY="你的智谱API密钥"

1
2

# Linux/macOS
export ZAI_API_KEY="你的智谱API密钥"

5.2 设置默认模型

1
2

# 设置智谱 GLM-4.7-Flash 为默认模型
openclaw models set zai/glm-4.7-flash

5.3 验证模型配置

1

openclaw models status

输出示例：

1
2
3
4
5
6
7

Config        : ~\.openclaw\openclaw.json
Agent dir     : ~\.openclaw\agents\main\agent
Default       : zai/glm-4.7-flash
Fallbacks (0) : -
Image model   : -
...
- zai effective=env:xxx...xxx | env=xxx...xxx | source=env: ZAI_API_KEY

6. 配置 Gateway 模式

1
2

# 设置本地模式
openclaw config set gateway.mode local

7. 启动 Gateway 服务

1
2

# Windows PowerShell（需要带上环境变量）
$env:ZAI_API_KEY="你的智谱API密钥"; openclaw gateway --port 18789

1
2

# Linux/macOS
ZAI_API_KEY="你的智谱API密钥" openclaw gateway --port 18789

启动成功后输出：

1
2
3

[gateway] agent model: zai/glm-4.7-flash
[gateway] listening on ws://127.0.0.1:18789
[browser/server] Browser control listening on http://127.0.0.1:18791/

8. 访问 Dashboard

1
2

# 自动打开带认证 Token 的 Dashboard
openclaw dashboard

或者手动打开浏览器访问：http://127.0.0.1:18789/

你将看到 OpenClaw 的控制面板，包含以下功能：

• Chat：即时对话窗口
• Skills：技能管理
• Channels：渠道配置
• Settings：设置

对话方式

OpenClaw 提供多种对话方式，你可以选择最适合的方式进行交互。

方式一：Web Dashboard 对话

通过浏览器访问 Dashboard 进行对话，适合日常使用。

步骤：

1. 启动 Gateway 服务

   1	$env:ZAI_API_KEY="你的智谱API密钥"; openclaw gateway --port 18789

2. 打开 Dashboard

   1	openclaw dashboard

3. 在 Chat 界面输入消息与 AI 对话

方式二：终端 TUI 对话

通过终端界面（TUI）进行对话，适合开发者快速操作。

步骤：

1. 确保 Gateway 服务已启动

2. 启动 TUI

   1	openclaw tui --token "你的认证Token"

3. 在终端中直接输入消息与 AI 对话

示例对话记录：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

┌────────────────────────────────────────────────────────────────────────────────

 你是谁，你可以做什么？

────────────────────────────────────────────────────────────────────────────────

 我来介绍一下我自己！

 嘿。我刚上线。我们可以开始定义彼此了。

 ────────────────────────────────────────────────────────────────────────────────

 我是什么：
 我是个AI助手，但不是那种标准的"你好有什么可以帮你"的模式。更像是一个有主见的、能干活的管家/伙伴。

 我可以做什么：
 - 📂 文件操作 - 读写、编辑你的代码、文档、笔记
 - 💻 运行命令 - 在你的系统上执行各种操作（需要时问一下）
 - 🌐 网络操作 - 搜索、抓取网页、控制浏览器
 - 🤖 自动化 - 调度任务、管理子代理、多会话协作
 - 📱 消息通知 - 在你的各个平台之间发消息（需要你授权）
 - 🎨 媒体处理 - 分析图片、语音转文字、文字转语音
 - 🔧 系统监控 - 检查状态、运行健康检查、管理设备

 我的边界：
 - 私密的东西不动，不确定就问
 - 不随便发外部消息（除非你同意）
 - 在群里只是参与者，不是你的代言人

└────────────────────────────────────────────────────────────────────────────────

询问是否可以操作 Trae 编辑器：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

┌────────────────────────────────────────────────────────────────────────────────

 你好，请问你可以操作当前电脑上打开的 Trae 编辑器吗？你能做什么操作？

────────────────────────────────────────────────────────────────────────────────

 找到了！Trae CN.exe 正在运行。

 坦白说，我没有直接的 Trae 操作工具。但我可以通过几种方式间接操作：

 ### 可以做的事情：

 1. 命令行操作 - 如果 Trae 提供 CLI 工具，我可以运行命令
     - 例如：code 命令（VS Code CLI）
     - 读取/写入工作区的文件
     - 执行 Git 操作
 2. UI 自动化 - 通过自动化工具控制窗口
     - 使用 Playwright/Selenium 模拟点击、输入
     - 适合：打开文件、运行测试、提交代码等重复性任务
 3. 文件与项目操作 - 作为你的助手
     - 读取、编辑项目文件
     - 分析代码
     - 运行构建脚本

 ### 现在能试什么：

 - 你想让我做什么？比如：
     - 打开某个文件？
     - 运行测试/构建？
     - 修改配置？
     - 还是其他具体任务？

 告诉我你的目标，我看看能怎么帮。

└────────────────────────────────────────────────────────────────────────────────

方式三：命令行单次对话

适合快速执行单个任务。

1
2

# 发送单条消息
openclaw agent --local --session-id my-session --message "帮我查看当前目录的文件列表"

常用命令

模型管理

1
2
3
4
5
6
7
8
9
10
11

# 查看所有可用模型
openclaw models list --all

# 查看当前模型状态
openclaw models status

# 设置默认模型
openclaw models set <model-id>

# 设置图片模型
openclaw models set-image <model-id>

配置管理

1
2
3
4
5
6
7
8

# 查看配置文件路径
openclaw config file

# 获取配置值
openclaw config get <path>

# 设置配置值
openclaw config set <path> <value>

Gateway 管理

1
2
3
4
5

# 启动 Gateway
openclaw gateway --port 18789

# 查看帮助
openclaw gateway --help

健康检查

1
2
3
4
5

# 运行诊断
openclaw doctor

# 查看状态
openclaw status

Skills 技能系统

Skills 是 OpenClaw 的能力扩展，类似于”插件”或”应用”。

什么是 Skills？

• 模块化设计：每个 Skill 定义一组特定任务
• 生态丰富：可从 ClawHub 安装第三方 Skills
• 自定义开发：支持编写自己的 Skills

查看可用 Skills

1
2
3
4
5

# 列出所有可用技能
openclaw skills list

# 查看技能详情
openclaw skills inspect <skill-name>

常用内置 Skills

安装第三方 Skills

1
2

# 从 ClawHub 安装
openclaw plugins install <plugin-name>

Skills 使用示例

示例1：文件操作

1
2
3
4
5
6
7
8
9

用户：帮我读取 d:\MyDemo\blog\source\_posts\ 目录下的所有 md 文件列表

AI：好的，我来帮你查看...
[执行 fs skill]
找到以下 md 文件：
- OpenClaw安装与使用指南.md
- AI+Figma.md
- Vue3基础复习.md
...

示例2：执行命令

1
2
3
4
5

用户：帮我运行 npm run build 命令

AI：好的，正在执行构建...
[执行 bash skill]
构建完成，输出目录：dist/

接入聊天渠道

接入 Telegram

步骤：

1. 在 Telegram 中搜索 @BotFather
2. 发送 /newbot 创建机器人
3. 按提示输入机器人名称和用户名（需以 bot 结尾）
4. 获取 Bot Token（格式：123456:ABC-DEF1234ghIkl）

1
2
3
4

# 配置 Telegram 渠道
openclaw channels login telegram

# 按提示输入 Bot Token

接入 Discord

步骤：

1. 访问 Discord 开发者门户：https://discord.com/developers/applications
2. 创建新应用，进入 Bot 标签页
3. 开启 Bot 并获取 Bot Token
4. 在 OAuth2 -> URL Generator 中勾选 bot 权限
5. 生成邀请链接，将 Bot 邀请到服务器

1
2
3

# 配置 Discord 渠道
openclaw config set channels.discord.enabled true
openclaw config set channels.discord.token "YOUR_BOT_TOKEN"

接入飞书

步骤：

1. 访问飞书开放平台：https://open.feishu.cn/
2. 创建企业自建应用
3. 在凭证与基础信息中获取 App ID 和 App Secret
4. 开启机器人权限

1
2
3
4

# 配置飞书渠道
openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.appId "YOUR_APP_ID"
openclaw config set channels.feishu.appSecret "YOUR_APP_SECRET"

接入钉钉

步骤：

1. 访问钉钉开放平台：https://open.dingtalk.com/
2. 创建企业内部应用
3. 获取 AppKey 和 AppSecret

1
2
3
4

# 配置钉钉渠道
openclaw config set channels.dingtalk.enabled true
openclaw config set channels.dingtalk.clientId "YOUR_APP_KEY"
openclaw config set channels.dingtalk.clientSecret "YOUR_APP_SECRET"

安全注意事项

⚠️ 重要提示：OpenClaw 具备系统级权限，可以执行 Shell 命令和访问文件系统。

推荐做法

1. 不要在主力电脑上运行：建议使用闲置设备或云服务器
2. 限制权限：仅启用必要的权限（文件系统访问、Shell访问）
3. 禁止网络访问权限：防止恶意代码外泄
4. 定期审查日志：检查异常操作
5. 谨慎安装第三方 Skills：从可信来源安装，检查代码

Windows 用户特别提示

Windows 用户建议使用 WSL2（Linux 子系统）运行，因为 Windows 的文件系统权限模型较为脆弱。

Skills 安全警告

安装第三方 Skills 时要特别注意：

• 检查 Skills 的来源和代码
• 不要安装来源不明的 Skills
• 定期审查已安装的 Skills

常见问题

1. Node.js 版本不兼容

问题：安装失败，提示 Node.js 版本过低

解决：

1
2

nvm install 22
nvm use 22

2. npm 安装速度慢

问题：安装依赖包速度很慢

解决：切换到国内镜像

1
2
3

nrm use huawei
# 或
nrm use taobao

3. Gateway 启动失败

问题：提示 set gateway.mode=local

解决：

1

openclaw config set gateway.mode local

4. API Key 未生效

问题：模型调用失败，提示认证错误

解决：确保环境变量已设置

1
2
3
4
5

# Windows PowerShell
$env:ZAI_API_KEY="你的智谱API密钥"

# 然后启动 gateway
openclaw gateway --port 18789

5. Dashboard 认证失败

问题：提示 unauthorized: too many failed authentication attempts

解决：

1
2
3
4
5
6
7
8

# 重置认证 Token
openclaw config unset gateway.auth.token

# 重启 Gateway
openclaw gateway --port 18789

# 重新打开 Dashboard
openclaw dashboard

6. Dashboard 提示 Token 缺失

问题：提示 gateway token missing

解决：

1
2
3
4
5

# 获取当前 Token
openclaw config get gateway.auth.token

# 或直接打开带 Token 的 Dashboard
openclaw dashboard

社区资源

官方资源

社区讨论

相关教程

智谱 AI 相关

参考链接

• OpenClaw GitHub：https://github.com/openclaw/openclaw
• 智谱 AI 开放平台：https://open.bigmodel.cn/
• GLM-4.7-Flash 文档：https://docs.bigmodel.cn/cn/guide/models/free/glm-4.7-flash

总结

OpenClaw 是一个功能强大的个人 AI 智能体平台，通过本地部署确保数据安全，支持多种 AI 模型和聊天渠道。本文详细介绍了从安装到配置智谱 GLM-4.7-Flash 模型的完整流程，包括终端对话、Dashboard 对话、Skills 技能系统、渠道接入等常用功能，希望对你有所帮助。

祝你使用愉快！🎉