OpenClaw 接入教程

OpenClaw 是一个开源的 AI 编程助手框架，支持接入多种大模型后端。 本教程教你如何快速将 OpenClaw 与国内各平台对接使用。

---

OpenClaw 简介

OpenClaw 是一款开源、免费的 AI 编程助手，具有以下优势：

• 开源免费 — 完全开源，无需额外费用
• 多模型支持 — 可接入几乎所有兼容 OpenAI API 格式的模型
• 高度可定制 — 插件系统丰富，可扩展性强
• 跨平台运行 — 支持 macOS、Linux、Windows

安装步骤

前提条件

• Node.js 18+
• Git

安装

# 通过 npm 全局安装
npm install -g openclaw

# 或者从源码安装
git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install && npm link

接入国内平台

OpenClaw 使用标准 OpenAI 兼容 API 格式，大部分国内平台都提供此类接口。

通用配置方式

编辑 OpenClaw 配置文件（通常位于 ~/.config/openclaw/config.json）：

{
  "provider": {
    "name": "custom",
    "baseURL": "https://api.your-platform.com/v1",
    "apiKey": "your-api-key",
    "model": "default-model-name"
  }
}

各平台具体配置

火山方舟

{
  "provider": {
    "name": "volcengine",
    "baseURL": "https://ark.cn-beijing.volces.com/api/v3",
    "apiKey": "你的火山引擎 API Key",
    "model": "Doubao-Seed-2.0-pro"
  }
}

获取 API Key：

1. 登录 火山引擎控制台
2. 进入「火山方舟」→「API 密钥管理」
3. 创建新的 API Key

MiniMax

{
  "provider": {
    "name": "minimax",
    "baseURL": "https://api.minimax.chat/v1",
    "apiKey": "你的 MiniMax API Key",
    "model": "MiniMax-M2.5"
  }
}

智谱 GLM

{
  "provider": {
    "name": "glm",
    "baseURL": "https://open.bigmodel.cn/api/paas/v4",
    "apiKey": "你的智谱 API Key",
    "model": "glm-4-plus"
  }
}

腾讯云

{
  "provider": {
    "name": "tencent",
    "baseURL": "https://api.hunyuan.cloud.tencent.com/v1",
    "apiKey": "你的腾讯云 API Key",
    "model": "hunyuan-pro"
  }
}

使用指南

启动 OpenClaw

openclaw

首次启动会引导你进行基本配置。

常用命令

# 开始交互模式
openclaw chat

# 直接提问（非交互模式）
openclaw ask "帮我写一个 Python 的快速排序"

# 在项目中使用
openclaw project "帮我分析这个项目的依赖关系"

# 更新到最新版本
openclaw update

高级用法

多文件编辑

用户: 帮我把 src/components/Header.tsx 和 Footer.tsx 都改成暗色主题
OpenClaw: [自动读取两个文件，同时修改两处代码]

执行命令

用户: 运行测试看看覆盖率
OpenClaw: [自动执行 npm run test -- --coverage 并展示结果]

Git 集成

用户: 帮我看一下最近的 commit 做了什么改动
OpenClaw: [读取 git log 和 git diff，总结变更内容]

最佳实践

1. 合理选择模型

• 简单任务（格式化、注释）：使用 budget/mainstream 级别模型，省量省钱
• 复杂任务（架构设计、算法实现）：使用 flagship 级别模型，质量更高

2. 管理上下文窗口

• 项目过大时，使用 .openclawignore 排除不需要的文件（类似 .gitignore）
• 定期使用 /compact 压缩对话历史

3. 安全注意事项

• 不要在对话中粘贴 API Key、密码等敏感信息
• 使用 Git 版本控制，方便回滚 AI 生成的修改
• 定期审查 AI 生成的代码，确保安全性

---

最后更新：2026-04-13