OpenClaw官方入门指南（精译实战版）：5分钟极速上手

问题

你想让AI自动做点实事——比如每天抓取「36氪早报」网页，提取标题、摘要、链接，再一键存进Notion数据库。但你没GPU、不熟悉Docker、不想配环境变量、更不想写100行Python脚本。

OpenClaw 就是为这种场景生的：它不是另一个大模型聊天框，而是一个本地运行的智能代理调度中心。你告诉它“做什么”，它自动拆解任务（查网页→解析HTML→结构化→调Notion API），全程不用GPU，Mac/Windows双平台一键启动。

方案

用 OpenClaw 官方安装包 + 内置 onboarding 向导，5分钟完成三件事：
✅ 自动安装（含轻量级本地推理引擎）
✅ 生成专属 Gateway 服务（AI任务调度入口）
✅ 连通 Notion，跑通首个端到端自动化任务

所有操作都在终端里敲几行命令，无手动改代码、无配置文件手写、无API密钥硬编码。

步骤

1. 一键安装（Mac & Windows）

打开终端（Mac）或 PowerShell（Windows），粘贴执行：

curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw/main/install.sh | bash

为什么这行能跑通？
官方脚本会自动检测系统（Intel/Apple Silicon/Windows）、下载预编译二进制（含量化小模型 Phi-3-mini）、创建 ~/.openclaw 目录并设好权限。全程离线可运行，不依赖Python环境或CUDA。

安装完成后，终端会显示：

✅ OpenClaw installed! Run `openclaw onboarding` to begin.

2. 启动 onboarding 向导（全自动配置）

执行：

openclaw onboarding

向导会依次引导你：

• 选择语言（中文选 2）
• 输入 Notion 集成密钥（见下一步）
• 自动生成 ~/.openclaw/config.yaml（关键字段已填好）

Notion API 密钥怎么来？
① 登录 notion.so/my-integrations → “+ New integration”
② 命名如 OpenClaw-WebScraper，选你的工作区
③ 复制页面右下角 Internal Integration Token（以 secret_ 开头）
④ 粘贴进 onboarding 的提示框（不加引号，直接回车）

向导最后会说：

✅ Config saved. Starting Gateway...

3. 启动 Gateway 服务（本地AI调度中心）

Gateway 是 OpenClaw 的核心：它监听你的指令，分发给内置工具链（浏览器、解析器、Notion SDK），返回结构化结果。启动命令：

openclaw gateway --port 8080

为什么是 8080？
默认端口，方便你在浏览器访问 http://localhost:8080 查看实时任务日志。不需要 sudo，不占GPU显存，M1 MacBook Air 跑满也不烫手。

4. 发起首个任务：抓网页 → 存 Notion

新开一个终端窗口，用 curl 发送请求（替换为你的真实 Notion 数据库ID）：

curl -X POST http://localhost:8080/v1/tasks \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "抓取 https://36kr.com/p/2829452732123232 的标题、发布时间和前3个段落，存入我的Notion数据库",
    "notion_database_id": "a1b2c3d4-5678-90ef-ghij-klmnopqrstuv"
  }'

数据库ID在哪找？
打开你的 Notion 数据库 → 右上角 ⋯ → “Copy link” → 链接末尾 /p/ 后面一长串就是（如 a1b2c3d4-...）

几秒后，你会收到 JSON 响应，含 task_id 和 status: "completed"。同时，Notion 数据库里已新增一条记录，字段自动匹配：Title、Published、Summary（内容已清洗去广告/JS标签）。

验证

✅ 终端看到 gateway 日志中出现 tool: web_scraper → notion_writer
✅ Notion 数据库里多出一条带时间戳的记录
✅ 打开 http://localhost:8080，点击 Tasks 标签页，能看到该任务完整执行链路（含每个工具的输入/输出）

👉 Binance · OKX · Gate.io · HTX · Bitget

常见问题

Q：提示 notion_database_id invalid？
A：Notion 数据库必须是「Full Page」类型（不是 Inline Database），且你已在集成设置中授予该数据库读写权限（Settings → Connections → 选中你的集成 → ✅ Pages and databases）。

Q：Gateway 启动后浏览器打不开？
A：检查是否被防火墙拦截（Windows Defender 有时会拦）。临时关闭或放行 openclaw 即可。Mac 用户注意：Safari 可能因 CORS 拒绝加载，用 Chrome 或 Edge 访问。

Q：能换别的模型吗？
A：可以！编辑 ~/.openclaw/config.yaml，把 model: phi3-mini 改成 model: llama3-8b-q4（需先用 ollama pull llama3:8b-q4 下载），重启 gateway 即生效。

下一步

你已经拥有了一个私有、免GPU、可扩展的AI工作流中枢。接下来：

• 🌐 《用 OpenClaw + MCP 接入企业微信》 —— 把AI助手变成部门机器人
• 📦 《自定义工具开发：3步封装自己的Python脚本》 —— 让AI调用你写的财务爬虫
• ⚙️ 《Gateway 高级配置：限流/日志/HTTPS》 —— 上生产环境必读

OpenClaw 不是让你更会写Prompt，而是让你彻底忘记Prompt——任务描述清楚，剩下的交给它。