第2章：环境搭建与安装
2.1 快速安装指南
OpenClaw 支持多种部署方式，包括本地部署和云端部署。无论你选择哪种方式，其核心逻辑都是通过安装 OpenClaw 的核心包并配置 API 密钥来启动。
本地部署 (Mac/Linux/Windows)
对于大多数个人用户，本地部署是最推荐的方式，因为它能直接访问本地文件并保证数据的隐私性。
- 环境要求：确保你的电脑已安装 Node.js (v18+) 和 Git。
- 安装命令：
npm install -g @openclaw/core
- 初始化配置：
openclaw init
在初始化过程中，系统会提示你输入 API 密钥（推荐使用 Claude 3.5 Sonnet 或 GPT-4o）。
云端部署 (Docker/腾讯云)
如果你希望 AI 助手 24 小时在线并接入飞书/企微，云端部署是更好的选择。
- Docker 部署：
docker run -d --name openclaw -p 18789:18789 -v ~/.openclaw:/root/.openclaw openclaw/core
- 一键部署：腾讯云开发者社区提供了针对飞书和企微接入的一键部署方案，极大简化了配置流程。
2.2 环境变量与基础配置
OpenClaw 的配置主要存储在 ~/.openclaw/config.json 中。以下是核心配置项的详细说明：
| 配置项 | 必填 | 说明 |
|---|---|---|
| api.claude.apiKey | 是 | Claude 官方或代理 API Key，建议使用 Claude 3.5 Sonnet。 |
| api.openai.apiKey | 否 | OpenAI API Key，用于辅助任务或特定 Skills。 |
| gateway.token | 是 | Web UI 访问的验证 Token，防止他人非法访问。 |
| workspace.path | 是 | 核心配置（SOUL.md/USER.md）所在的目录路径。 |
安全提示：请务必修改默认的 gateway.token。如果你将 OpenClaw 部署在公网服务器上，未授权的访问可能导致你的本地文件被泄露或被恶意操作。
2.3 常见安装问题排查
在安装和启动过程中，你可能会遇到以下常见问题：
- Node.js 版本过低：OpenClaw 依赖较新的 Node.js 特性，如果版本低于 18，可能会报错 SyntaxError。
- 网络访问超时：由于 API 密钥通常需要访问海外服务器，如果本地网络环境不佳，建议在配置文件中设置 baseUrl 代理。
- 权限不足：在 Linux/Mac 上执行全局安装时，如果遇到 EACCES 错误，请尝试使用 sudo 或修改 npm 默认安装路径。
完成安装后，你可以通过执行 openclaw start 启动服务，并访问 http://localhost:18789 进入 Web 管理界面。
© 版权声明
若无特殊声明，本站所有文章版权均归「PMKG AI知识库」原创和所有，未经许可，任何个人、媒体、网站、团体不得转载、抄袭或以其他方式复制发表本站内容，或在非我站所属的服务器上建立镜像。否则，我站将依法保留追究相关法律责任的权利。
相关文章
暂无笔记...