产品简介

OpenClaw 是一个自托管的任务型 AI 框架，它不仅能理解你的意图，还能通过工具调用 (Tool Use) 像真人一样在你的服务器或电脑上执行任务。配合 Codex API 的高性能模型，它可以成为你最得力的数字助理。

核心价值： 私有化部署保障数据安全，多平台接入让你随时随地通过聊天控制 AI 代理。

快速安装

在你的 Linux/macOS 或 Windows 环境中运行以下命令。建议在具有 Node.js 环境的机器上运行。

一键脚本

# Linux/macOS curl -fsSL https://openclaw.ai/install.sh | bash # Windows (PowerShell) iwr -useb https://openclaw.ai/install.ps1 | iex
安装完成后，请运行 openclaw onboard 进行首次初始化设置。

配置详解 (JSON5)

默认配置文件路径：~/.openclaw/openclaw.json

字段 类型 说明
models Array API 提供商列表，可配置多个端点切换
channels Object 配置机器人接入的平台，如 Telegram/Discord
tools.mode String 权限等级："full" (可执行代码) / "messaging" (仅聊天)

模型对接示例 (Codex API)

将 Codex API 的地址和令牌填入 models 部分：

{ "models": [ { "provider": "openai", "name": "claude-3-5-sonnet", "apiKey": "你的_CODEX_令牌", "baseURL": "https://ai.zkmjnic.tech/v1", "isDefault": true } ] }

多系统 API 对接教程

除了直接修改配置文件，你还可以通过操作系统的环境变量来快速对接 Codex API，这在测试或 Docker 部署时非常有用。

1. Windows 环境 (原生 PowerShell)

仅对当前终端会话生效。若要永久生效，请在“系统环境变量”设置中添加。

# 设置 API Key $env:OPENAI_API_KEY="你的_CODEX_令牌" # 设置 Codex 专用地址 (关键) $env:OPENAI_API_BASE="https://ai.zkmjnic.tech/v1"

2. Linux / macOS / WSL2 (Bash/Zsh)

建议写入配置文件以实现持久化（如 ~/.zshrc 或 ~/.bashrc）。

# 追加配置到环境变量文件 echo 'export OPENAI_API_KEY="你的_CODEX_令牌"' >> ~/.zshrc echo 'export OPENAI_API_BASE="https://ai.zkmjnic.tech/v1"' >> ~/.zshrc # 使配置立即生效 source ~/.zshrc
WSL2 推荐方案： 对于 Windows 用户，建议通过 WSL2 (Windows Subsystem for Linux) 运行 OpenClaw，因为其环境兼容性更接近生产服务器，且对各种 Skill 的支持更完善。

插件市场 (ClawHub)

OpenClaw 的强大源于其丰富的技能（Skills）。你可以从 ClawHub 下载并安装各种插件。

1. 安装管理工具

npm i -g clawhub

2. 常用技能安装流程

以联网搜索和网页分析为例：

# 搜索并安装联网搜索插件 clawhub install tavily-search # 安装网页浏览器自动化插件 clawhub install agent-browser

安装完成后，AI 在处理“查一下最近的新闻”或“总结这个网页”时会自动调用这些工具。

Telegram 机器人集成

让 OpenClaw 成为你的私人 Telegram 助理，请按以下步骤操作：

第一步：申请 Token

在 Telegram 搜索并关注 @BotFather，发送 /newbot，按照提示获取 HTTP API Token。

第二步：配置白名单 (安全关键)

为了防止别人盗用你的机器人，你必须锁定 User ID：

  1. 在 OpenClaw 配置中找到 channels.telegram。
  2. 在 allowFrom 数组中填入你的 Telegram 用户 ID。
"channels": { "telegram": { "enabled": true, "token": "你的_BOT_TOKEN", "allowFrom": [12345678] // 只有你的 ID 才能控制它 } }

人格定义 (Soul)

在 ~/.openclaw/workspace/ 文件夹下，有三个 Markdown 文件决定了 AI 的表现：

1. SOUL.md - 设定回复风格

# AI 设定 你是一个极其高效且幽默的私人数字助理。 - 回复时尽量简明扼要。 - 如果任务涉及代码，请优先考虑安全性。 - 偶尔可以使用一些幽默的修辞。

2. USER.md - 你的个人偏好

# 关于用户 - 我叫：张三 - 职业：Web 开发者 - 时区：GMT+8 - 偏好：我喜欢 Python，不喜欢 Java。

3. AGENTS.md - 工作规范

定义 AI 在处理复杂任务（如文件管理）时必须遵守的红线。

命令行参考

命令 用途
openclaw onboard 交互式引导（最推荐的初始配置方式）
openclaw doctor 环境自检，解决连接不上、缺少依赖等问题
openclaw restart 修改配置文件后，必须运行此命令刷新
openclaw logs 查看运行日志，排查报错原因

故障排查 FAQ

Q: 修改了 SOUL.md 但 AI 没变化？

A: 确保文件保存在正确的 workspace 目录下，并运行 openclaw restart 强制重采样配置。

Q: 机器人无法联网？

A: 查检查 claude-3-5-sonnet 是否在 Codex 站有余额，并确认是否正确安装并配置了 tavily-search 等搜索技能所需的环境变量。

注意： 赋予 full 模式权限时，AI 具备运行 rm -rf 等危险指令的能力。请务必在沙盒环境或可信机器上运行，并严格限定 allowFrom 白名单。