跳转到主要内容

​
概述

OpenClaw 是一款开源的本地 AI 助手，由开发者 Peter Steinberger 于 2025 年 11 月创建。它运行在你自己的电脑上，可通过 Telegram、WhatsApp、Discord 等多种聊天平台交互，实现文件操作、终端命令执行、浏览器控制等自动化任务。 通过配置 API易 服务，您可以获得：

🔒 本地隐私

数据完全在本地处理，隐私安全有保障

📱 多平台支持

支持 Telegram、WhatsApp、Discord、Slack、iMessage 等

🛠️ 自主执行

不只是聊天，能真正操作电脑、执行命令

🔌 可扩展

支持自定义技能和插件扩展
项目信息：OpenClaw 是 MIT 许可证开源项目，官网 openclaw.ai，项目地址 github.com/openclaw/openclaw。

​
环境准备

​
系统要求

  • Node.js 22 或更高版本
  • macOS / Linux / Windows

​
安装 Node.js

brew install node@22

​
安装 OpenClaw

npm install -g openclaw
验证安装： 
openclaw --version

​
快速配置

OpenClaw 使用 JSON 配置文件，位于 ~/.openclaw/openclaw.json。

​
配置 API易

创建或编辑配置文件 ~/.openclaw/openclaw.json： 
{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/gpt-4.1" }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-你的API易密钥",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4.1", "name": "GPT-4.1" },
          { "id": "claude-sonnet-4-20250514", "name": "Claude Sonnet 4" },
          { "id": "deepseek-chat", "name": "DeepSeek V3" },
          { "id": "gemini-2.5-pro-preview-05-06", "name": "Gemini 2.5 Pro" }
        ]
      }
    }
  }
}

​
配置说明

字段说明
agents.defaults.model.primary默认模型，格式为 provider名/模型名
models.providers自定义模型提供商配置
baseUrlAPI 地址，使用 https://api.apiyi.com/v1
apiKey你的 API易 密钥
apiAPI 类型：OpenAI 兼容用 openai-completions，Anthropic 兼容用 anthropic-messages

​
运行安装向导

openclaw onboard
向导会引导你完成：
  • Gateway 配置
  • 聊天渠道连接（Web UI、Telegram、WhatsApp 等）
  • 技能配置

​
启动服务

openclaw gateway start

​
使用方式

​
方式一：Web UI（推荐）

最简单的使用方式，无需任何外部服务： 
openclaw dashboard
浏览器会打开 http://127.0.0.1:18789/，直接在网页聊天窗口发消息即可。
Web UI 是国内用户的推荐方式，不需要代理，直接可用。

​
方式二：Telegram Bot

  1. 在 Telegram 搜索 @BotFather
  2. 发送 /newbot 创建机器人
  3. 获取 Bot Token
  4. 在 openclaw onboard 时输入 Token
国内使用 Telegram 需要代理支持：
export https_proxy=http://127.0.0.1:代理端口
export http_proxy=http://127.0.0.1:代理端口
openclaw gateway restart

​
方式三：其他平台

OpenClaw 还支持：
  • WhatsApp（扫码连接）
  • Discord（需要创建 Bot）
  • Slack、Signal、iMessage、微软 Teams 等

​
核心技能

OpenClaw 内置丰富的技能，可以执行各种任务：

​
文件操作

技能功能
fs.read读取文件（文本/图片）
fs.write写入/创建文件
fs.edit编辑文件内容

​
系统操作

技能功能
shell.exec执行终端命令
shell.process管理运行中的命令
browser.*自动控制浏览器（打开网页、截图、点击等）

​
智能功能

技能功能
web_search网页搜索
web_fetch抓取网页内容
memory_search搜索记忆
memory_get读取记忆
cron.*定时任务（提醒、自动执行）
tts文字转语音

​
常用命令

​
终端命令

命令功能
openclaw onboard运行安装向导
openclaw gateway start启动 Gateway 服务
openclaw gateway restart重启 Gateway 服务
openclaw gateway stop停止 Gateway 服务
openclaw status查看运行状态
openclaw doctor诊断配置问题
openclaw doctor --fix自动修复配置问题
openclaw dashboard打开 Web 控制面板
openclaw logs --follow查看实时日志
openclaw configure修改配置
openclaw update更新到最新版本

​
聊天命令

在聊天窗口中可以使用的命令：
命令功能
/help显示帮助
/new开始新对话
/reset重置对话
/stop停止当前任务
/think <level>设置思考深度
/model <id>切换模型
/verbose on/off开关详细模式
/status查看状态
/skills查看可用技能

​
使用示例

直接用中文与 OpenClaw 对话，它会自动理解并执行任务：

​
文件操作

> 帮我在桌面创建一个 test.txt 文件，内容写 hello world

> 读取 ~/Documents/notes.txt 的内容

> 把桌面上所有 .png 文件移动到 Pictures 文件夹

​
终端命令

> 列出我桌面上的所有文件

> 查看当前系统内存使用情况

> 帮我安装 python 的 requests 库

​
浏览器控制

> 打开浏览器访问 baidu.com

> 搜索一下最新的 MacBook Pro 价格

> 截图当前网页

​
定时任务

> 每天早上 9 点提醒我喝水

> 每隔 1 小时提醒我休息一下

> 明天下午 3 点提醒我开会

​
编程辅助

> 帮我写一个 Python 脚本，批量重命名文件

> 这段代码有什么问题：[粘贴代码]

> 帮我写一个简单的 HTML 页面

​
推荐模型

OpenClaw 通过 API易 支持 200+ 主流 AI 模型，可根据不同任务选择合适的模型。

查看模型推荐

查看最新的场景化模型推荐，包括文本创作、编程开发、快速响应、长文本处理等全场景的最佳模型选择。

​
场景化模型推荐

任务类型推荐模型原因
复杂任务执行Claude Sonnet 4理解能力强，执行准确
日常对话GPT-4.1响应自然，通用性好
代码编写DeepSeek V3编程能力强，性价比高
长文档处理Gemini 2.5 Pro支持超长上下文

​
故障排除

国内访问 Telegram 需要代理。设置终端代理后重启 Gateway：
export https_proxy=http://127.0.0.1:代理端口
export http_proxy=http://127.0.0.1:代理端口
openclaw gateway restart
或直接使用 Web UI（不需要代理）。
运行诊断命令自动修复：
openclaw doctor --fix
  1. 检查 API 密钥是否正确
  2. 确认 baseUrl 设置为 https://api.apiyi.com/v1
  3. 测试连通性：
curl -H "Authorization: Bearer 你的密钥" \
     https://api.apiyi.com/v1/models

openclaw logs --follow

openclaw update

openclaw channels add --channel telegram

​
进阶功能

​
多模型配置

可以配置多个模型，在聊天中用 /model <id> 切换： 
{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-你的密钥",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4.1", "name": "GPT-4.1" },
          { "id": "claude-sonnet-4-20250514", "name": "Claude Sonnet 4" },
          { "id": "deepseek-chat", "name": "DeepSeek V3" }
        ]
      }
    }
  }
}

​
自定义技能

OpenClaw 支持自定义技能，可以在 ~/.openclaw/workspace/skills/ 目录下创建。

​
记忆功能

OpenClaw 会记住你的对话和偏好，可以用 /memory 查看和管理记忆。

​
多设备同步

可以在多台设备上运行 OpenClaw，通过 Tailscale 等工具实现远程访问。

​
安全提示

  • API 密钥安全：不要把配置文件分享给他人
  • 权限控制：OpenClaw 可以执行终端命令，注意不要让它执行危险操作
  • 网络安全：默认只监听本地地址，如需远程访问请配置好安全措施

​
完整配置示例

{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/gpt-4.1" }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-你的API易密钥",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4.1", "name": "GPT-4.1" },
          { "id": "claude-sonnet-4-20250514", "name": "Claude Sonnet 4" },
          { "id": "deepseek-chat", "name": "DeepSeek V3" }
        ]
      }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "accounts": {
        "default": {
          "token": "你的Telegram Bot Token"
        }
      }
    }
  }
}

​
相关资源

API易控制台

管理 API 密钥和查看使用量

模型推荐

查看场景化模型推荐