OpenClaw 完全新手指南
OpenClaw 是一个强大的 AI Agent 框架，让你能够轻松打造自己的智能助手。本指南将带你从零开始，快速上手 OpenClaw。
什么是 OpenClaw？
OpenClaw 是一个开源的 AI Agent 平台，它提供了：
- 🤖 多平台集成 - 支持微信、Telegram、Discord、CLI 等多种交互方式
- 🛠️ 丰富的工具集 - 文件操作、终端命令、网页搜索、代码执行等
- 🧠 技能系统 - 可复用的任务模板和最佳实践
- 📝 记忆系统 - 跨会话的持久化记忆
- 🔄 多 Agent 协作 - 构建多 Agent 团队系统
在线体验: https://vercel-deploy-livid-nine.vercel.app/
快速开始
1. 环境准备
系统要求:
- Node.js 18+ 或 Python 3.10+
- Git
- 终端（Terminal/WSL）
推荐操作系统:
- macOS
- Linux
- Windows (WSL2)
2. 安装 OpenClaw
方法一：NPM 安装（推荐）
# 全局安装
npm install -g openclaw
# 验证安装
openclaw --version
方法二：源码安装
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 安装依赖
npm install
# 构建项目
npm run build
# 链接到全局
npm link
3. 配置 API Key
OpenClaw 需要 LLM API Key 才能运行。支持多种提供商：
OpenAI
export OPENAI_API_KEY="sk-..."
Anthropic Claude
export ANTHROPIC_API_KEY="sk-ant-..."
OpenRouter（推荐，支持多模型）
export OPENROUTER_API_KEY="sk-or-..."
提示: 建议将环境变量添加到 ~/.bashrc 或 ~/.zshrc 中，以便永久生效。
4. 启动 OpenClaw
CLI 模式（命令行交互）
openclaw
启动后，你会看到交互式界面：
OpenClaw v1.0.0
Type 'help' for available commands
You: 你好
Assistant: 你好！我是 OpenClaw AI 助手，有什么可以帮你的吗？
单次命令模式
openclaw "创建一个 Python 脚本，输出 Hello World"
微信机器人模式
openclaw --platform wechat
核心功能详解
1. 文件操作
OpenClaw 可以读取、写入、搜索文件：
You: 读取 README.md 文件内容
Assistant: [调用 read_file 工具] 文件内容如下...
You: 在当前目录创建一个 hello.py 文件，输出 Hello World
Assistant: [调用 write_file 工具] 已创建文件 hello.py
You: 搜索所有包含 "TODO" 的文件
Assistant: [调用 search_files 工具] 找到 3 个文件...
2. 终端命令
执行系统命令：
You: 列出当前目录的文件
Assistant: [调用 terminal 工具]
- src/
- package.json
- README.md
...
You: 安装 express 依赖
Assistant: [调用 terminal] npm install express
已成功安装 express@4.18.2
3. 网页搜索
搜索互联网信息：
You: Next.js 15 有哪些新特性？
Assistant: [调用 web_search 工具]
根据搜索结果，Next.js 15 的主要新特性包括：
1. Turbopack 稳定版
2. React 19 支持
3. 部分预渲染（PPR）
...
4. 代码执行
运行 Python 脚本处理复杂逻辑：
You: 计算 1 到 100 的质数
Assistant: [调用 execute_code 工具]
执行 Python 代码...
找到 25 个质数: [2, 3, 5, 7, 11, ...]
5. 技能系统
使用预定义的技能模板：
You: 使用 nextjs-vercel-website-deployment 技能创建一个博客
Assistant: [加载技能]
好的，我将按照以下步骤部署 Next.js 网站：
1. 创建 Next.js 项目
2. 初始化 Git 仓库
3. 推送到 GitHub
4. 部署到 Vercel
...
查看所有技能:
openclaw skills list
创建自定义技能:
openclaw skills create my-skill
6. 记忆系统
OpenClaw 会记住重要信息：
You: 记住，我喜欢使用 TypeScript 而不是 JavaScript
Assistant: [调用 memory 工具] 已记录：用户偏好 TypeScript
# 下次对话
You: 创建一个 Web 项目
Assistant: 好的，我将使用 TypeScript 创建项目... [自动应用记忆]
高级用法
多 Agent 系统
创建多个 Agent 协同工作：
# team.yaml
agents:
- name: pm
role: 项目经理
personality: professional
- name: dev
role: 开发工程师
personality: technical
- name: designer
role: UI 设计师
personality: creative
启动团队：
openclaw team start team.yaml
定时任务（Cron Jobs）
设置定时执行的任务：
You: 每天早上 9 点发送天气预报到我的邮箱
Assistant: [调用 cronjob 工具]
已创建定时任务：
- 频率: 每天 09:00
- 任务: 查询天气并发送邮件
- 下次执行: 2026-05-12 09:00
后台进程管理
运行长时间任务：
You: 后台运行测试套件
Assistant: [调用 terminal(background=true)]
已启动后台进程 (session_id: proc_xxx)
我会在测试完成后通知你。
# 30 分钟后
Assistant: [自动通知] 测试完成！通过 95/100 个测试用例。
配置文件
全局配置
位置：~/.openclaw/config.yaml
# LLM 配置
llm:
provider: openrouter
model: anthropic/claude-sonnet-4
# 默认设置
defaults:
personality: helpful
language: zh-CN
# 工具启用
toolsets:
- file
- terminal
- web
- skills
# 记忆配置
memory:
enabled: true
max_entries: 100
项目配置
在项目根目录创建 .openclaw.yaml：
# 项目特定配置
project:
name: my-website
type: nextjs
# 自动加载技能
skills:
- nextjs-development
- vercel-deployment
# 项目记忆
memory:
- key: tech_stack
value: Next.js 15 + TypeScript + Tailwind
常见问题
Q1: API Key 配置后仍然报错？
解决:
# 检查环境变量
echo $OPENAI_API_KEY
# 临时设置
export OPENAI_API_KEY="sk-..."
# 重启 OpenClaw
openclaw
Q2: 如何切换模型？
# 使用 Claude
openclaw --model anthropic/claude-sonnet-4
# 使用 GPT-4
openclaw --model openai/gpt-4-turbo
Q3: 如何导出对话历史？
openclaw export --session last --format markdown > session.md
Q4: 技能加载失败？
检查技能路径：
# 查看技能目录
ls ~/.openclaw/skills/
# 验证技能格式
openclaw skills validate my-skill
Q5: 如何更新 OpenClaw？
# NPM 安装方式
npm update -g openclaw
# 源码安装方式
cd openclaw
git pull
npm install
npm run build
最佳实践
1. 编写清晰的指令
❌ 不好的例子：
做一个网站
✅ 好的例子：
创建一个 Next.js 15 个人博客网站，要求：
1. 使用 TypeScript
2. 集成 Tailwind CSS
3. 包含首页、博客列表、文章详情、关于页面
4. 部署到 Vercel
2. 善用技能系统
创建可复用的技能，避免重复劳动：
# 保存常用流程为技能
openclaw "将刚才的操作保存为技能 deploy-nextjs-website"
3. 定期清理会话
# 清理超过 30 天的会话
openclaw sessions clean --older-than 30d
4. 备份重要配置
# 备份配置和技能
tar -czf openclaw-backup.tar.gz ~/.openclaw/
进阶资源
- 📚 官方文档: https://docs.openclaw.ai
- 💬 社区论坛: https://community.openclaw.ai
- 🐛 问题反馈: https://github.com/openclaw/openclaw/issues
- 💡 技能市场: https://skills.openclaw.ai
下一步
现在你已经掌握了 OpenClaw 的基础用法，建议：
- ✅ 尝试创建一个简单的项目（如 Todo App）
- ✅ 编写自己的第一个技能
- ✅ 加入社区，分享你的经验
- ✅ 探索高级功能（多 Agent 系统、定时任务等）
祝你使用愉快！ 🎉
最后更新: 2026-05-11