OpenClaw安装使用指南

1. 前言

OpenClaw 是一款开源的跨平台个人助理框架，旨在帮助用户通过本地或云端代理统一管理各种聊天渠道、自动化脚本和插件。本文档覆盖从下载、安装到基本使用的全流程，帮助你快速上手。

2. 环境要求

• 操作系统：Windows 10/11、macOS 12+、Linux （Ubuntu 20.04+）
• Node.js：v22 或以上（推荐使用 Volta 管理）
• Python（可选）：用于某些插件的脚本执行
• 网络：需要能够访问 GitHub、npm、以及你要接入的渠道 API（如 Telegram、Discord、微信等）

3. 下载与安装

# 1. 安装 Volta（可选）
curl https://get.volta.sh | bash
# 2. 使用 Volta 安装 Node
volta install node@22
# 3. 克隆 OpenClaw 仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 4. 安装依赖
npm ci
# 5. 全局链接（可选）
npm link

完成后，运行 openclaw --help 验证是否安装成功。

4. 初始化工作区

# 在用户目录下创建工作区（默认路径）
openclaw init
# 会生成以下文件:
#   AGENTS.md、SOUL.md、USER.md、MEMORY.md、TOOLS.md 等

首次启动时，系统会提示你填写 IDENTITY.md（你的名字、角色）和 USER.md（你的使用者信息），请按提示完成。

5. 启动网关服务

网关负责与外部渠道（Telegram、QQ、微信等）通信。

openclaw gateway install   # 安装系统计划任务（Windows）或 systemd 服务（Linux）
openclaw gateway start     # 启动服务
openclaw gateway status    # 查看运行状态

如需重新启动：openclaw gateway restart。

6. 添加渠道插件

# 以 Telegram 为例
openclaw plugins add openclaw-telegram
# 配置环境变量（在 workspace 目录下创建 telegram.env）
# TELEGRAM_BOT_TOKEN=your_bot_token
openclaw gateway restart   # 让插件生效

其它渠道（Discord、QQ、微信）同理，参考官方文档或对应插件的 README。

7. 使用技能（Skills）

OpenClaw 通过 Skills 扩展功能，例如健康检查、天气查询、代码生成等。

# 查找并安装技能
openclaw skills find weather
openclaw skills add weather

已安装的技能会出现在 ~/.agents/skills/ 目录，可直接在对话中调动。

8. 基础命令速查

命令	说明
openclaw status	查看整体运行状态
openclaw gateway restart	重启网关服务
openclaw plugins list	列出已安装插件
openclaw skills list	列出已装技能
openclaw cron add …	添加定时任务
openclaw sessions spawn …	启动子代理会话

9. 常见问题

1. 网关不启动：检查防火墙是否开放端口，确认 gateway.cmd 已正确生成。
2. 插件报错：阅读插件目录下的 README.md，确保所需的 API Key 已写入对应的 .env 文件。
3. 记忆丢失：MEMORY.md 为长期记忆文件，务必不要在非主会话中读取/修改。

10. 进阶使用

• 自定义 Skill：参考 skills/skill-creator，编写 SKILL.md 和实现脚本即可发布。
• 集成 CI/CD：使用 turborepo 管理多仓库，结合 openclaw cron 实现自动部署。
• 安全审计：运行 openclaw healthcheck 检查系统硬化、SSH 配置等。

11. 小结

通过上述步骤，你已经完成 OpenClaw 的安装、基本配置以及技能扩展。后续可根据个人需求继续探索插件、自动化脚本和自定义 Skill，打造专属的 AI 助手。

本文档已保存至 D:\demo\OpenClaw_guide.txt，如需进一步编辑请使用任意文本编辑器。