项目介绍
OpenClaw 通过网关、模型和工具组成代理运行环境。NAS 部署需要同时考虑工作目录、网关鉴权与网页来源限制,消息平台接入应在基本会话可用后配置。
模型负责理解任务,工具负责执行操作,网关负责会话与控制界面的连接。网页能打开但无法对话时,往往还需要检查网关地址、令牌、访问来源或 HTTPS 配置。
同一主题资料中既有官方安装,也有社区容器封装和汉化版本。它们的目录、启动方式及附带功能可能不同,选定路线后应使用该路线成套文档,不混用其他封装的参数。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 模型接入 | 配置自己的模型服务与调用凭据。 |
| 工作目录 | 为文件操作设置独立空间。 |
| 会话网关 | 连接控制页面、会话与工具。 |
| 消息渠道 | 基础会话稳定后再接入聊天平台。 |
| 权限规划 | 只开放当前任务需要的文件与工具。 |
界面展示

图 1:官方公开页面截图,用于说明项目入口与功能;不是本机部署画面。
项目信息
| 项目 | 说明 |
|---|---|
| 类型 | 配置指南 |
| 分类 | AI 与开发 |
| 官方入口或文档 | 直接访问 |
| 整理日期 | 2026-11-14 |
安装与运行
在官方支持的 Linux、macOS 或 Windows WSL2 环境准备运行;群晖可使用符合要求的 Linux 虚拟机。不要把 Linux 安装脚本当作 DSM 套件安装器。
1. 安装和初始化
curl -fsSL https://openclaw.ai/install.sh -o openclaw-install.sh
less openclaw-install.sh
bash openclaw-install.sh
openclaw --help
2. 第一次使用
安装器完成后按向导选择模型服务和自己的密钥,完成网关与控制页初始化。先执行一个只读本地任务,再接入单个消息渠道。控制页的网关令牌保存在自己的配置中,外网访问使用 HTTPS 和鉴权,不沿用他人的面板地址。
上面的 less 用于先查看安装脚本,按 q 退出后再决定执行。升级和卸载使用当前 openclaw --help 提供的子命令;先备份自己的配置和工作区,不在示例中公开模型 Key。
常见问题
- 命令不存在:确认依赖已安装,关闭并重新打开终端,再检查实际使用的环境。Python 虚拟环境与系统 Python、Windows 与 WSL 的工具路径各自独立。
- 下载依赖失败:先查看具体失败的仓库和包名,检查该终端的网络;浏览器能访问不代表命令行已使用同一代理。
- 配置后仍报错:从当前项目目录启动,检查配置文件名、变量名和日志。真实账号与 API Key 放在本机私有配置中,不复制到公开教程或截图。
更新与备份
更新前保存项目配置、输入资料和输出结果。源码项目记录当前提交与依赖锁文件,比较新版本说明后再更新;安装包项目保留可回退的版本号。服务账号的授权与模型账单在对应平台管理,删除本地目录不会自动撤销授权。