92 lines
1.8 KiB
Markdown
92 lines
1.8 KiB
Markdown
|
# openclaw-extra
|
|||
|
|
|
|||
|
|
OpenClaw extra utilities - manage agents, sessions, models, and workspaces.
|
|||
|
|
|
|||
|
|
## 功能
|
|||
|
|
|
|||
|
|
- 📋 **智能体列表**: 列出所有 OpenClaw 智能体及其状态
|
|||
|
|
- 💬 **对话内容**: 查看各智能体的对话历史（包含使用的模型信息）
|
|||
|
|
- 🤖 **模型列表**: 查看 OpenClaw 可用的大模型列表
|
|||
|
|
- 📁 **工作区文件**: 浏览各智能体的工作区文件
|
|||
|
|
- 🌐 **Web 面板**: 网页端管理界面，直观易用
|
|||
|
|
|
|||
|
|
## 安装
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
pip install openclaw-extra
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 使用
|
|||
|
|
|
|||
|
|
### Web 管理面板（推荐）
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 启动 Web 服务
|
|||
|
|
openclaw-extra web
|
|||
|
|
|
|||
|
|
# 自定义端口和地址
|
|||
|
|
openclaw-extra web --port 9000 --host 127.0.0.1
|
|||
|
|
|
|||
|
|
默认端口 16026，访问 http://localhost:16026
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
访问 `http://localhost:8080` 即可看到网页管理界面。
|
|||
|
|
|
|||
|
|
### 基本命令
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 显示帮助
|
|||
|
|
openclaw-extra --help
|
|||
|
|
|
|||
|
|
# 列出所有智能体
|
|||
|
|
openclaw-extra agents
|
|||
|
|
|
|||
|
|
# 列出可用模型
|
|||
|
|
openclaw-extra models
|
|||
|
|
|
|||
|
|
# 查看智能体详情
|
|||
|
|
openclaw-extra agent <agent-id>
|
|||
|
|
|
|||
|
|
# 查看会话列表
|
|||
|
|
openclaw-extra sessions --agent <agent-id>
|
|||
|
|
|
|||
|
|
# 查看工作区文件
|
|||
|
|
openclaw-extra workspace <agent-id>
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 环境配置
|
|||
|
|
|
|||
|
|
可以通过环境变量或配置文件设置 Gateway 连接：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 设置 Gateway URL (默认: http://127.0.0.1:18789)
|
|||
|
|
export OPENCLAW_GATEWAY_URL="http://127.0.0.1:18789"
|
|||
|
|
|
|||
|
|
# 设置 Gateway Token (如果需要认证)
|
|||
|
|
export OPENCLAW_GATEWAY_TOKEN="your-token"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## API 使用
|
|||
|
|
|
|||
|
|
```python
|
|||
|
|
from openclaw_extra import OpenClawClient
|
|||
|
|
|
|||
|
|
# 创建客户端
|
|||
|
|
client = OpenClawClient()
|
|||
|
|
|
|||
|
|
# 获取智能体列表
|
|||
|
|
agents = client.get_agents()
|
|||
|
|
|
|||
|
|
# 获取模型列表
|
|||
|
|
models = client.get_models()
|
|||
|
|
|
|||
|
|
# 获取会话列表
|
|||
|
|
sessions = client.get_sessions(agent_id="hz4th_coder")
|
|||
|
|
|
|||
|
|
# 获取工作区信息
|
|||
|
|
workspace = client.get_workspace(agent_id="hz4th_coder")
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## License
|
|||
|
|
|
|||
|
|
MIT
|