OpenClaw 本地部署完整指南
> 拥有自己的 AI 助手不是梦。Linux/Mac/Windows 三平台详细步骤，避坑大全。
—
什么是 OpenClaw？
OpenClaw 是一个开源的 AI 助手框架，让你可以：
– 🤖 拥有专属 AI 助手
– 💬 连接微信/Telegram/Discord
– 🧠 管理记忆和上下文
– 🔌 扩展各种技能
– 🌐 浏览器自动化
核心优势：
– 开源免费
– 支持多平台
– 技能可扩展
– 数据本地存储
—
环境要求
硬件要求
| 配置 | 最低 | 推荐 |
|——|——|——|
| CPU | 2 核 | 4 核 + |
| 内存 | 2GB | 4GB+ |
| 存储 | 5GB | 10GB+ |
| 网络 | 稳定连接 | 稳定连接 |
软件要求
| 系统 | 版本要求 |
|——|———-|
| Node.js | v18+（推荐 v22） |
| npm | v8+ |
| 操作系统 | Linux/macOS/Windows |
—
快速安装
方法一：npm 安装（推荐）
“`bash
全局安装 OpenClaw
npm install -g openclaw
验证安装
openclaw –version
“`
方法二：源码安装
“`bash
克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
安装依赖
npm install
链接到全局
npm link
“`
方法三：Docker 安装
“`bash
拉取镜像
docker pull openclaw/openclaw:latest
运行容器
docker run -d \
-v ./workspace:/app/workspace \
-p 3000:3000 \
openclaw/openclaw
“`
—
初始化配置
步骤 1：创建工作区
“`bash
初始化工作区
openclaw init
默认创建在 ~/.openclaw/workspace
也可指定路径
openclaw init ~/my-ai-workspace
“`
步骤 2：配置 AI 模型
编辑配置文件 `~/.openclaw/config.json`：
“`json
{
“model”: {
“provider”: “qwen”,
“apiKey”: “your-api-key”,
“model”: “qwen-plus”
},
“gateway”: {
“port”: 3000,
“host”: “localhost”
}
}
“`
步骤 3：配置模型提供商
#### 通义千问（推荐中文用户）
“`json
{
“provider”: “qwen”,
“apiKey”: “从 dashscope.aliyun.com 获取”,
“model”: “qwen-plus”
}
“`
#### Claude
“`json
{
“provider”: “anthropic”,
“apiKey”: “从 console.anthropic.com 获取”,
“model”: “claude-3-sonnet-20240229”
}
“`
#### GPT-4
“`json
{
“provider”: “openai”,
“apiKey”: “从 platform.openai.com 获取”,
“model”: “gpt-4-turbo”
}
“`
#### 本地模型（Ollama）
“`json
{
“provider”: “ollama”,
“baseUrl”: “http://localhost:11434”,
“model”: “qwen2.5:7b”
}
“`
—
启动服务
启动 Gateway
“`bash
启动服务
openclaw gateway start
查看状态
openclaw status
停止服务
openclaw gateway stop
重启服务
openclaw gateway restart
“`
验证运行
“`bash
检查端口
lsof -i :3000
或访问网页
open http://localhost:3000
“`
—
连接通讯平台
企业微信（WeCom）
“`bash
1. 创建企业微信应用
访问 https://work.weixin.qq.com
2. 获取配置信息
– CorpID
– AgentID
– Secret
3. 配置到 OpenClaw
openclaw config wecom –corp-id XXX –agent-id XXX –secret XXX
“`
Telegram
“`bash
1. 联系 BotFather 创建 Bot
获取 Bot Token
2. 配置
openclaw config telegram –token YOUR_BOT_TOKEN
3. 启动 Bot
openclaw gateway start
“`
Discord
“`bash
1. 创建 Discord 应用
访问 https://discord.com/developers
2. 获取 Bot Token
3. 配置
openclaw config discord –token YOUR_BOT_TOKEN
“`
“`bash
1. 扫描 QR 码连接
openclaw connect whatsapp
2. 用手机 WhatsApp 扫描二维码
3. 连接成功后自动保存会话
“`
—
安装技能
使用 skillhub（推荐）
“`bash
搜索技能
skillhub search weather
安装技能
skillhub install weather
更新技能
skillhub update weather
列出已安装
skillhub list
“`
常用技能推荐
| 技能 | 功能 | 命令 |
|——|——|——|
| weather | 天气查询 | `skillhub install weather` |
| browser | 浏览器自动化 | `skillhub install browser` |
| github | GitHub 操作 | `skillhub install github` |
| obsidian | 笔记管理 | `skillhub install obsidian` |
| summarize | 内容摘要 | `skillhub install summarize` |
手动安装技能
“`bash
1. 下载技能包
git clone https://github.com/xxx/skill-xxx.git
2. 复制到技能目录
cp -r skill-xxx ~/.openclaw/skills/
3. 启用技能
openclaw skills enable xxx
“`
—
记忆系统
记忆文件结构
“`
~/.openclaw/workspace/
├── MEMORY.md # 长期记忆
├── SOUL.md # 人格设定
├── USER.md # 用户信息
├── TOOLS.md # 工具配置
├── IDENTITY.md # 身份定义
├── HEARTBEAT.md # 定期检查任务
└── memory/
├── 2026-03-13.md # 每日日志
├── 2026-03-14.md
└── …
“`
记忆管理命令
“`bash
查看记忆
openclaw memory show
搜索记忆
openclaw memory search “关键词”
导出记忆
openclaw memory export > backup.md
导入记忆
openclaw memory import backup.md
“`
记忆最佳实践
1. 定期清理 — 删除过时信息
2. 分类整理 — 按主题组织
3. 备份保存 — 定期导出
4. 隐私保护 — 不存储敏感信息
—
高级功能
浏览器自动化
“`bash
启动浏览器
openclaw browser start
打开网页
openclaw browser open https://example.com
截图
openclaw browser screenshot
执行脚本
openclaw browser eval “document.title”
“`
子代理（Sub-agent）
“`bash
spawn 子任务
openclaw agent spawn “分析这份报告”
列出子代理
openclaw agent list
查看状态
openclaw agent status
终止任务
openclaw agent kill
“`
定时任务
“`bash
添加 cron 任务
openclaw cron add “0 9 * ” “检查邮件”
列出任务
openclaw cron list
删除任务
openclaw cron remove
“`
Heartbeat 定期检查
编辑 `HEARTBEAT.md`：
“`markdown
每天早上 9 点检查
– [ ] 查看未读邮件
– [ ] 查看日历事件
– [ ] 查看天气
– [ ] 查看项目状态
“`
—
常见问题
Q1: 安装失败怎么办？
“`bash
清理 npm 缓存
npm cache clean –force
重新安装
npm install -g openclaw –force
检查 Node.js 版本
node –version # 需要 v18+
“`
Q2: 如何更新？
“`bash
更新到最新版
npm update -g openclaw
或指定版本
npm install -g openclaw@2026.3.8
“`
Q3: 支持中文吗？
完全支持！推荐使用：
– 通义千问（qwen）
– Claude
– 本地中文模型
Q4: 数据存在哪里？
“`
~/.openclaw/workspace/ # 工作区
~/.openclaw/config.json # 配置文件
“`
Q5: 如何备份？
“`bash
备份整个工作区
tar -czf openclaw-backup.tar.gz ~/.openclaw/
恢复
tar -xzf openclaw-backup.tar.gz -C ~/
“`
Q6: 端口冲突怎么办？
“`bash
修改配置
openclaw config gateway –port 3001
或编辑 config.json
{
“gateway”: {
“port”: 3001
}
}
“`
—
性能优化
内存优化
“`json
{
“memory”: {
“maxContextLength”: 4096,
“maxHistoryMessages”: 50
}
}
“`
响应速度优化
“`json
{
“model”: {
“maxTokens”: 1024,
“temperature”: 0.7
}
}
“`
并发优化
“`json
{
“gateway”: {
“maxConcurrentSessions”: 10
}
}
“`
—
安全建议
1. API Key 保护
– 不要提交到 Git
– 使用环境变量
– 定期轮换
2. 访问控制
– 限制 IP 访问
– 启用认证
– 设置防火墙
3. 数据加密
– 敏感数据加密存储
– 使用 HTTPS
– 定期备份
4. 日志审计
– 开启操作日志
– 定期检查异常
– 设置告警
—
参考资料
– 官方文档：[docs.openclaw.ai](https://docs.openclaw.ai)
– GitHub：[github.com/openclaw/openclaw](https://github.com/openclaw/openclaw)
– 技能市场：[clawhub.com](https://clawhub.com)
– Discord 社区：[discord.gg/clawd](https://discord.com/invite/clawd)
—
结语
OpenClaw 让你拥有完全可控的 AI 助手。
下一步：
1. 完成部署
2. 连接通讯平台
3. 安装常用技能
4. 开始使用！
—
💬 部署遇到问题？欢迎在评论区提问！
📚 推荐阅读：
– [提示词工程的 5 个核心原则](#)
– [搭建你的第一个自动化工作流](#)
—
本文首发于 [AI 创作网](https://a188.cn)
标签：#OpenClaw #AI 助手 #部署教程
