OpenClaw - 极客智坊

什么是 OpenClaw

OpenClaw（曾用名 ClawdBot/Moltbot）是 2026 年最火的开源 AI Agent 项目，GitHub 已获得超过 68,000 星标。它不是普通的聊天机器人，而是一个真正能够执行任务的个人 AI 助理。 本地执行

数据存储在你的设备上，无需上传云端
完全掌控隐私和数据安全

真实执行

不仅是对话，能实际操作你的电脑
自动化处理邮件、日历、文件管理等任务

多平台消息

支持 WhatsApp、Telegram、Discord、Slack 等 10+ 平台
从单一入口管理所有通讯

持久记忆

跨会话保存上下文和用户偏好
随着时间推移越来越了解你，持续提升效率

开源免费

完全开源，只需自备 API Key
免费，完全自主控制

OpenClaw vs 传统 AI 助手 传统 AI（如 ChatGPT）：

你：“帮我整理桌面文件”
AI：“我建议你可以这样做：1. 创建文件夹…… 2. 按类型分类……”

OpenClaw：

你：“帮我整理桌面文件”
OpenClaw：直接重命名、分类、移动文件 “已完成！我把 47 个文件按类型整理到 5 个文件夹中。”

这就是“聊天机器人”和“AI Agent”的本质区别。

新手阶段：基础入门

第一步：环境准备

系统要求：

操作系统： macOS、Linux 或 Windows （需要 WSL）
Node.js: v22 或更高版本
AI 模型 API Key: Claude、GPT、Gemini 等官方或极客智坊等第三方聚合代理的 API 密钥

🔨 检查环境：

# 检查 Node.js 版本
node --version

# 如果版本低于 v22，需要升级
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

第二步：安装 OpenClaw

下面我们以 macOS/Linux 为例，演示如何通过 NPM 安装 OpenClaw：

# 全局安装 OpenClaw
npm install -g openclaw

# 验证安装
openclaw --version

第三步：初始化配置

# 启动初始化向导
openclaw onboard

向导会引导你完成：

选择 AI 模型提供商（Anthropic/OpenAI/自定义）：这里我们选择自定义模型供应商并输入极客智坊 Base URL
输入 API Key：粘贴你的极客智坊 API Key
输入模型名称：输入你想使用的极客智坊对话模型ID，例如 gpt-5.3-codex、claude-sonnet-4-6 或 gemini-3.1-pro-preview，所有对话模型ID可以在极客智坊模型广场查看拷贝
选择消息平台（Telegram/Discord/WhatsApp 等）
配置系统权限（建议先选择沙盒模式）

第四步：第一次对话

启动 OpenClaw：

# 启动 OpenClaw
openclaw

# 或者启动 Dashboard（Web 界面）
openclaw dashboard

如果对话报错，提示 Model context window too small (4096 tokens)，可以通过编辑配置文件 ~/.openclaw/openclaw.json，增加对应模型的 contextWindow 以及 maxTokens 参数，例如：

"geekai": {
  "baseUrl": "https://geekai.co/api/v1",
  "apiKey": {
    "source": "env",
    "provider": "default",
    "id": "GEEKAI_API_KEY"
  },
  "api": "openai-completions",
  "models": [
    {
      "id": "gpt-5.3-codex",
      "name": "gpt-5.3-codex (Custom Provider)",
      "reasoning": false,
      "input": [
        "text"
      ],
      "cost": {
        "input": 0,
        "output": 0,
        "cacheRead": 0,
        "cacheWrite": 0
      },
      "contextWindow": 16000,
      "maxTokens": 400000
    }
  ]
}

编辑后保存即可正常使用。安装配置中遇到任何问题，可以加入极客智坊用户群寻求帮助：极客智坊微信群

第五步：理解核心概念

Gateway（网关） Gateway 是 OpenClaw 与外部世界交互的方式：

消息网关：Telegram、Discord、WhatsApp
API 网关：HTTP API 接口
CLI 网关：命令行交互

Skills（技能） Skills 是 OpenClaw 的能力扩展，类似于“插件”或“应用”：

每个 Skill 定义了一组特定任务
可以从 Clawhub 安装第三方 Skills
也可以自己编写自定义 Skills

Memory（记忆） OpenClaw 会记住：

你的偏好和习惯
之前的对话上下文
重要的信息和任务

Sandbox（沙盒） 沙盒模式限制 OpenClaw 的系统访问权限，保护你的电脑安全：

Sandbox Mode: 限制文件系统、网络、Shell 访问
Full Access Mode: 完全权限（需谨慎使用）

🔨 探索工作空间：

# 查看 OpenClaw 的工作目录
ls ~/.openclaw

# 查看配置文件
openclaw config list

# 查看已安装的 Skills
openclaw skills list

# 运行安全审计
openclaw security audit

进阶阶段：实用技能

第六步：安装和使用 Skills

浏览 Skills 市场，访问 Clawhub 或使用命令：

# 搜索 Skills
openclaw skills search email

# 查看 Skill 详情
openclaw skills info @author/skill-name

安装常用 Skills：

# 安装邮件管理 Skill
openclaw skills install @openclaw/email-manager

# 安装日历管理 Skill
openclaw skills install @openclaw/calendar

# 安装文件整理 Skill
openclaw skills install @openclaw/file-organizer

# 安装网页搜索 Skill（使用 Tavily 替代 Brave）
openclaw skills install @openclaw/tavily-search

第七步：Google Workspace 集成

OpenClaw 可以管理你的 Gmail、Google 日历、Google 文档等。配置步骤：

创建 Google Cloud 项目

访问 console.cloud.google.com
创建新项目
启用 Gmail API、Google Calendar API、Google Drive API

创建服务账号

在 IAM & Admin → Service Accounts 创建服务账号
下载 JSON 密钥文件

配置 OpenClaw

openclaw config set integrations.google.enabled true
openclaw config set integrations.google.credentialsPath
"/path/to/credentials.json"

授权访问

openclaw integrations google authorize

第八步：设置定时任务（Cron Jobs）

OpenClaw 可以定期自动执行任务。创建每日简报:

我想让你每天早上 8 点给我发送一份简报，包含：
今天的天气
我的日历安排
未读邮件数量
一句励志的话

OpenClaw 会自动创建一个定时任务（cron job）。查看定时任务：

# 列出所有定时任务
openclaw cron list

# 查看任务详情
openclaw cron show <task-id>

# 禁用任务
openclaw cron disable <task-id>

# 删除任务
openclaw cron delete <task-id></task-id></task-id></task-id>

第九步：配置持久记忆

OpenClaw 的记忆系统让它能记住你的偏好。 训练你的助手 告诉 OpenClaw 关于你的信息：

记住以下关于我的信息：
- 我的名字是 [你的名字]
- 我的工作是 [你的职业]
- 我的工作时间是周一到周五 9:00-18:00
- 我喜欢简洁的回复，不要太啰嗦
- 我使用中文交流
- 我的时区是 GMT+8

查看记忆：

# 查看记忆文件
cat ~/.openclaw/memory/long-term.json

# 或在对话中询问
你记得我的哪些信息？

中级阶段：高级应用

第十步：编写自定义 Skill

Skills 使用 YAML 或 Markdown 格式定义。 Skill 基本结构 创建文件 ~/.openclaw/skills/my-first-skill.yaml:

name: “每日新闻摘要”
description: “获取并总结今日科技新闻”
version: “1.0.0”

triggers:
  - "今日新闻"
  - "科技新闻"

steps:
  - action: web_search
    query: "latest tech news today"
    max_results: 5
    
  - action: summarize
    content: "{{search_results}}"
    style: "bullet_points"
    
  - action: respond
    message: "📰 今日科技新闻摘要：

{{summary}}"

安装自定义 Skill

# 重新加载 Skills
openclaw skills reload

# 测试 Skill
openclaw skills test "每日新闻摘要"

第十一步：多 Agent 管理

你可以运行多个 OpenClaw 实例，每个有不同的配置和用途。创建多个 Agent：

# 创建工作用 Agent
openclaw create-agent work
openclaw config --agent work set ai.model "claude-sonnet-4.6"

# 创建个人用 Agent
openclaw create-agent personal
openclaw config --agent personal set ai.model "gpt-5.3"

# 切换 Agent
openclaw switch-agent work
openclaw switch-agent personal

# 列出所有 Agent
openclaw list-agents

使用场景：

工作 Agent: 连接公司邮箱、项目管理工具
个人 Agent: 管理个人日程、家庭事务
实验 Agent: 测试新功能、新 Skills

第十二步：Docker 沙盒安全实践

Docker 沙盒提供最强的安全隔离。配置 Docker 沙盒：

# 安装 Docker（如果还没有）
# macOS: 下载 Docker Desktop
# Linux: sudo apt install docker.io

# 配置 OpenClaw 使用 Docker 沙盒
openclaw config set sandbox.mode "docker"
openclaw config set sandbox.docker.image "openclaw/sandbox:latest"

# 测试沙盒
openclaw sandbox test

Docker 沙盒会限制：

文件系统访问（只能访问指定目录）
网络访问（可配置白名单）
系统命令执行
资源使用（CPU、内存限制）

第十三步：浏览器控制

OpenClaw 可以控制浏览器执行复杂的网页操作。启用浏览器控制：

# 安装浏览器控制插件
openclaw plugins install @openclaw/browser-control

# 配置浏览器
openclaw config set browser.enabled true
openclaw config set browser.headless false  # false 表示显示浏览器窗口

使用示例：

打开浏览器，访问 GitHub，搜索 "openclaw"，并告诉我前 3 个结果

帮我在亚马逊上搜索 "机械键盘"，找到评分最高的 3 个产品，记录价格

第十四步：与其他工具集成

Linear 集成（项目管理）：

# 安装 Linear Skill
openclaw skills install @openclaw/linear

# 配置 API Key
openclaw config set integrations.linear.apiKey "YOUR_LINEAR_API_KEY"

使用示例：

在 Linear 中创建一个新任务："修复登录页面的 bug"，优先级高

Obsidian 集成（笔记）:

# 安装 Obsidian Skill
openclaw skills install @openclaw/obsidian

# 配置 Obsidian vault 路径
openclaw config set integrations.obsidian.vaultPath "/path/to/obsidian/vault"

使用示例：

在 Obsidian 中创建一篇新笔记，标题是"OpenClaw 学习笔记"

第十五步：高级配置优化

性能优化：

# 配置缓存
openclaw config set cache.enabled true
openclaw config set cache.ttl 3600

# 配置并发请求
openclaw config set ai.maxConcurrentRequests 3

# 配置超时
openclaw config set ai.timeout 30000

成本控制：

# 设置每日 API 调用限制
openclaw config set ai.dailyLimit 1000

# 设置每月预算（美元）
openclaw config set ai.monthlyBudget 50

# 查看使用统计
openclaw stats usage
openclaw stats cost

日志和调试：

# 启用详细日志
openclaw config set logging.level "debug"

# 查看日志
openclaw logs

# 查看特定时间的日志
openclaw logs --since "2026-02-20"

# 导出日志
openclaw logs --export logs.txt

Documentation Index

​什么是 OpenClaw

​新手阶段：基础入门

​第一步：环境准备

​第二步：安装 OpenClaw

​第三步：初始化配置

​第四步：第一次对话

​第五步：理解核心概念

​进阶阶段：实用技能

​第六步：安装和使用 Skills

​第七步：Google Workspace 集成

​第八步：设置定时任务（Cron Jobs）

​第九步：配置持久记忆

​中级阶段：高级应用

​第十步：编写自定义 Skill

​第十一步：多 Agent 管理

​第十二步：Docker 沙盒安全实践

​第十三步：浏览器控制

​第十四步：与其他工具集成

​第十五步：高级配置优化

什么是 OpenClaw

新手阶段：基础入门

第一步：环境准备

第二步：安装 OpenClaw

第三步：初始化配置

第四步：第一次对话

第五步：理解核心概念

进阶阶段：实用技能

第六步：安装和使用 Skills

第七步：Google Workspace 集成

第八步：设置定时任务（Cron Jobs）

第九步：配置持久记忆

中级阶段：高级应用

第十步：编写自定义 Skill

第十一步：多 Agent 管理

第十二步：Docker 沙盒安全实践

第十三步：浏览器控制

第十四步：与其他工具集成

第十五步：高级配置优化