5 分钟部署 OpenClaw：从零到运行的完整流程

一、为什么要部署 OpenClaw？

1.1 你可能遇到的痛点

作为一名开发者，你是否经历过这些场景：

❌ 每天花 1 小时整理日报、周报，重复劳动毫无价值
❌ 多个平台消息（飞书、邮件、Slack）来回切换，错过重要信息
❌ 想自动化一些工作流，但配置复杂、学习成本高
❌ 试过各种 RPA 工具，要么太贵，要么太难用
❌ 看到别人用 AI Agent 提效，自己却不知道怎么上手

如果你中了一条以上，那么 OpenClaw 就是为你设计的。

1.2 OpenClaw 能做什么

OpenClaw 是一个本地优先的 AI 智能体编排框架，核心能力包括：

能力	说明	典型场景
多 Agent 协作	7 个核心 Agent（main/think/work/ops/invest/report/seo）分工协作	复杂任务拆解与执行
多渠道集成	飞书、邮件、Telegram、Slack 等消息统一处理	消息聚合与自动回复
自动化工作流	基于自然语言的任务调度与执行	日报生成、数据整理、代码审查
本地记忆系统	会话记忆、语义检索、经验沉淀	跨会话上下文保持
技能扩展	支持自定义 Skill，无限扩展能力边界	对接内部 API、定制业务逻辑

1.3 部署收益

⏱️ 5 分钟完成部署，无需复杂配置
🚀 开箱即用，内置 70+ 技能覆盖常见场景
💰 完全免费，本地运行无 API 调用费用（除大模型 API）
🔒 隐私安全，所有数据存储在本地

二、前置准备

2.1 系统要求

系统	版本要求	备注
macOS	12.0+	推荐 M 系列芯片
Linux	Ubuntu 20.04+	主流发行版均可
Windows	WSL2	暂不支持原生 Windows

2.2 必要工具

bash 复制代码

# 1. Node.js（v18 或更高版本）
node --version  # 推荐 v20+

# 2. npm（随 Node.js 安装）
npm --version   # 推荐 v9+

# 3. Git
git --version

2.3 大模型 API（三选一）

OpenClaw 支持多种大模型后端，选择其一即可：

服务商	推荐模型	价格	申请地址
阿里云百炼	qwen3.5-plus	¥0.02/1K tokens	https://bailian.console.aliyun.com
DeepSeek	deepseek-chat	¥0.004/1K tokens	https://platform.deepseek.com
OpenAI	gpt-4o	$0.01/1K tokens	https://platform.openai.com

推荐新手使用阿里云百炼，国内访问速度快，性价比高。

三、核心步骤：从零到运行

步骤 1：安装 OpenClaw CLI

bash 复制代码

# 使用 npm 全局安装
npm install -g openclaw

# 验证安装
openclaw --version

预期输出：

复制代码

openclaw v2.1.76

步骤 2：初始化工作区

bash 复制代码

# 创建工作区（首次运行自动初始化）
openclaw init

# 工作区默认路径：~/.openclaw/workspace

初始化完成后，目录结构如下：

复制代码

~/.openclaw/
├── workspace/
│   ├── AGENTS.md          # Agent 协作规范
│   ├── SOUL.md            # 主 Agent 人格设定
│   ├── USER.md            # 用户偏好配置
│   ├── TOOLS.md           # 本地工具配置
│   ├── MEMORY.md          # 长期记忆
│   ├── memory/            # 每日记忆文件
│   │   └── 2026-03-18.md
│   └── skills/            # 自定义技能
└── logs/                  # 会话日志

步骤 3：配置大模型 API

bash 复制代码

# 编辑配置文件
vim ~/.openclaw/config.json

配置示例（阿里云百炼）：

json 复制代码

{
  "default_model": "bailian/qwen3.5-plus",
  "models": {
    "bailian/qwen3.5-plus": {
      "api_key": "sk-xxxxxxxxxxxxxxxx",
      "base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1"
    },
    "deepseek/deepseek-chat": {
      "api_key": "sk-xxxxxxxxxxxxxxxx",
      "base_url": "https://api.deepseek.com"
    }
  }
}

获取 API Key 步骤：

登录阿里云百炼控制台
进入「API-KEY 管理」
创建新 API Key
复制到配置文件中

步骤 4：配置飞书集成（可选）

如果需要飞书消息通知，需配置飞书应用：

bash 复制代码

# 编辑飞书配置
vim ~/.openclaw/feishu-config.json

配置示例：

json 复制代码

{
  "app_id": "cli_a1b2c3d4e5f6",
  "app_secret": "xxxxxxxxxxxxxxxx",
  "bot_user_id": "ou_xxxxxxxxxxxxxxxx"
}

飞书应用创建步骤：

登录飞书开放平台：https://open.feishu.cn
创建企业自建应用
获取 App ID 和 App Secret
添加机器人权限（消息、群组、联系人）
发布应用并安装到企业

步骤 5：启动 Gateway 服务

bash 复制代码

# 启动后台服务
openclaw gateway start

# 查看服务状态
openclaw gateway status

预期输出：

复制代码

Gateway Status: Running
PID: 12345
Port: 8080
Uptime: 0h 0m 5s

步骤 6：运行第一个任务

bash 复制代码

# 通过命令行交互（或直接与主 Agent 对话）
openclaw chat "你好，请介绍一下你自己"

预期输出：

复制代码

我叫头孢，是龙的通用助手与主协调者。

我的核心作用不是替代所有专业角色，而是先理解需求、拆解任务、判断优先级、调度合适的 Agent 或工具执行，再把结果汇总成清晰、可执行的反馈，推动事情形成闭环。

今天有什么任务需要我协调？

四、进阶：运行复杂任务

4.1 多 Agent 协作示例

任务： 分析某支股票的投资价值

bash 复制代码

# 主 Agent 会自动调度 think/invest/report 等 specialist
openclaw chat "帮我分析一下 NVDA 的投资价值，给出买入建议和风险点"

执行流程：

复制代码

main（接收任务）
  → think（研究分析）
  → invest（ROI 评估）
  → report（生成报告）
  → main（汇总输出）

4.2 使用技能扩展能力

bash 复制代码

# 查看已安装技能
openclaw skills list

# 安装新技能
openclaw skills install stock-analysis

# 使用技能
openclaw chat "/stock analyze AAPL"

4.3 查看会话历史

bash 复制代码

# 查看最近的会话日志
openclaw logs --limit 10

# 搜索特定任务的执行记录
openclaw logs --search "股票分析"

五、常见问题（FAQ）

Q1：安装时提示权限错误怎么办？

错误信息：

复制代码

npm ERR! Error: EACCES: permission denied

解决方案：

bash 复制代码

# 方案 1：使用 sudo（不推荐）
sudo npm install -g openclaw

# 方案 2：修复 npm 权限（推荐）
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g openclaw

Q2：API Key 配置后仍然报错？

错误信息：

复制代码

Error: Invalid API key or rate limit exceeded

排查步骤：

检查 API Key 是否正确复制（无多余空格）
确认账户余额充足
检查是否超过速率限制（免费额度）
尝试切换其他模型服务商

Q3：Gateway 服务启动失败？

错误信息：

复制代码

Error: Port 8080 is already in use

解决方案：

bash 复制代码

# 查看占用端口的进程
lsof -i :8080

# 终止占用进程
kill -9 <PID>

# 或者修改配置使用其他端口
vim ~/.openclaw/config.json
# 修改 "port": 8081

Q4：如何重置配置？

bash 复制代码

# 备份当前配置
cp ~/.openclaw/config.json ~/.openclaw/config.json.bak

# 删除配置重新初始化
rm -rf ~/.openclaw
openclaw init

Q5：飞书机器人不回复消息？

排查清单：

飞书应用已发布并安装到企业
机器人已添加到目标群聊
App ID 和 App Secret 配置正确
机器人权限包含「消息收发」
Gateway 服务正在运行

六、总结与延伸

6.1 核心要点回顾

步骤	关键动作	耗时
1. 安装 CLI	`npm install -g openclaw`	1 分钟
2. 初始化	`openclaw init`	30 秒
3. 配置 API	编辑 config.json	2 分钟
4. 配置飞书	编辑 feishu-config.json（可选）	3 分钟
5. 启动服务	`openclaw gateway start`	30 秒
6. 运行任务	`openclaw chat "..."`	1 分钟

总计：约 10 分钟完成部署

6.2 进阶学习建议

阅读核心文档
- AGENTS.md：理解多 Agent 协作机制
- SOUL.md：了解主 Agent 的工作信仰
- TOOLS.md：配置本地工具集成
探索内置技能
bash 复制代码
```
openclaw skills list --all
```
加入社区
- GitHub: https://github.com/openclaw
- 文档：https://docs.openclaw.io

6.3 下一步行动

✅ 完成部署后，尝试运行第一个任务
✅ 配置飞书集成，实现消息通知
✅ 安装 2-3 个常用技能（如 stock-analysis、weather）
✅ 阅读记忆系统文档，理解会话持久化机制

5 分钟部署 OpenClaw：从零到运行的完整流程