OpenClaw 安装与诊断操作指南#

OpenClaw 是个很有意思的框架，可以在本地部署 AI 助手并通过 Telegram 控制。安装过程中踩了一些坑，记录一下解决方案。

安装步骤#

官方安装脚本#

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

安装过程分三步：

检查系统依赖
安装 OpenClaw npm 包
运行首次配置向导

内存不足问题#

如果服务器内存较小（<2GB），可能会遇到 npm 安装失败：

1
npm install failed for openclaw@latest

解决方案：增加 Node.js 内存限制

1
# 临时设置环境变量（当前会话有效）
2
export NODE_OPTIONS="--max-old-space-size=4096"
3

4
# 然后重新运行安装脚本
5
curl -fsSL https://openclaw.ai/install.sh | bash
6

7
# 或者只运行失败的步骤
8
NODE_OPTIONS="--max-old-space-size=4096" npm install -g openclaw@latest

内存设置

4096 表示 4GB，根据你的服务器内存调整

如果 4GB 不够，尝试 8192（8GB）

验证安装#

1
openclaw --version
2
openclaw doctor

Doctor 诊断报告解读#

运行 openclaw doctor 后会看到类似这样的报告：

1
🦞 OpenClaw 2026.2.24 (df9a474)
2

3
┌ OpenClaw doctor
4
│
5
◇ Legacy state detected
6
│  - Sessions: canonicalize legacy keys in
7
│    /root/.openclaw/agents/main/sessions/sessions.json
8
│
9
◇ Doctor changes
10
│  Merged sessions store → /root/.openclaw/agents/main/sessions/sessions.json
11
│  Canonicalized 1 legacy session key(s)
12
│
13
◇ State integrity
14
│  - 2/4 recent sessions are missing transcripts.
15
│
16
◇ Security
17
│  - No channel security warnings detected.
18
│  - Run: openclaw security audit --deep
19
│
20
◇ Skills status
21
│  Eligible: 17
22
│  Missing requirements: 42
23
│
24
◇ Plugins
25
│  Loaded: 5
26
│  Disabled: 31
27
│  Errors: 0
28
│
29
◇ Telegram: ok (@yourbot) (2844ms)
30
└ Doctor complete.

建议操作#

1. 清理异常会话数据#

1
# 查看会话存储
2
openclaw sessions --store "/root/.openclaw/agents/main/sessions/sessions.json"
3

4
# 预览清理影响（干运行）
5
openclaw sessions cleanup --store "/root/.openclaw/agents/main/sessions/sessions.json" --dry-run
6

7
# 实际清理
8
openclaw sessions cleanup --store "/root/.openclaw/agents/main/sessions/sessions.json"

2. 执行深度安全审计#

1
openclaw security audit --deep

3. 检查缺失的技能依赖#

报告显示有 42 个技能因缺少依赖无法使用。需要检查：

API Key 是否配置
依赖库是否安装
环境变量是否设置

1
# 查看技能状态
2
openclaw skills list
3

4
# 查看具体技能的依赖
5
openclaw skills info <skill-name>

4. 启用插件#

31 个插件处于禁用状态，按需启用：

1
# 列出插件
2
openclaw plugins list
3

4
# 启用插件
5
openclaw plugins enable <plugin-name>

常用命令#

1
# 查看帮助
2
openclaw --help
3

4
# 查看代理状态
5
openclaw agents list
6

7
# 查看会话
8
openclaw sessions list
9

10
# 查看日志
11
openclaw logs
12

13
# 重启服务
14
openclaw restart
15

16
# 完全重置（慎用）
17
openclaw reset

配置文件位置#

1
/root/.openclaw/
2
├── agents/
3
│   └── main/
4
│       └── sessions/
5
│           └── sessions.json    # 会话数据
6
├── config.json                  # 主配置
7
└── plugins/                     # 插件目录