高性能代理子系统,专为复杂多代理编排(OASIS)、自动化计算机使用任务和实时视觉监控而设计,...
Teamclaw is a multifunctional AI Agent service providing:
All scripts are located in selfskill/scripts/ and are called uniformly through the run.sh entry point. All are non-interactive.
text
selfskill/scripts/
├── run.sh # Main entry (start/stop/status/setup/add-user/configure)
├── adduser.py # Non-interactive user creation
└── configure.py # Non-interactive .env configuration management
All commands are executed from the project root directory.
bash
# Install dependencies
bash selfskill/scripts/run.sh setup
# Initialize configuration file
bash selfskill/scripts/run.sh configure --init
# Configure LLM (required)
bash selfskill/scripts/run.sh configure --batch \
LLM_API_KEY=sk-your-key \
LLM_BASE_URL=https://api.deepseek.com \
LLM_MODEL=deepseek-chat
# Create user
bash selfskill/scripts/run.sh add-user system MySecurePass123
bash
bash selfskill/scripts/run.sh start # Start background service
bash selfskill/scripts/run.sh status # Check status
bash selfskill/scripts/run.sh stop # Stop service
bash
# View current configuration (sensitive values masked)
bash selfskill/scripts/run.sh configure --show
# Set single item
bash selfskill/scripts/run.sh configure PORT_AGENT 51200
# Batch set
bash selfskill/scripts/run.sh configure --batch TTS_MODEL=gemini-2.5-flash-preview-tts TTS_VOICE=charon
Configuration ItemDescriptionDefault ValueLLM_API_KEYLLM API key ( required)—LLM_BASE_URLLLM API addresshttps://api.deepseek.com``LLM_MODELModel namedeepseek-chat``LLM_PROVIDERProvider (google/anthropic/deepseek/openai, auto-inferred)AutoLLM_VISION_SUPPORTImage support (auto-inferred)AutoPORT_AGENTMain Agent service port51200``PORT_SCHEDULERScheduling port51201``PORT_OASISOASIS forum port51202``PORT_FRONTENDWeb UI port51209``PORT_BARKBark push port58010``TTS_MODELTTS model (optional)—TTS_VOICETTS voice (optional)—INTERNAL_TOKENInternal communication key (auto-generated)Auto
PortService51200AI Agent main service51201Scheduled tasks51202OASIS forum51209Web UI
text
Authorization: Bearer <user_id>:<password>
text
Authorization: Bearer <INTERNAL_TOKEN>:<user_id>
INTERNAL_TOKEN is auto-generated on the first startup and can be viewed via configure --show-raw.
Base URL: http://127.0.0.1:51200
text
POST /v1/chat/completions
Authorization: Bearer <token>
{"model":"mini-timebot","messages":[{"role":"user","content":"Hello"}],"stream":true,"session_id":"my-session"}
text
POST /system_trigger
X-Internal-Token: <INTERNAL_TOKEN>
{"user_id":"system","text":"Execute task","session_id":"task-001"}
text
POST /cancel
{"user_id":"<user_id>","session_id":"<session_id>"}
text
POST http://127.0.0.1:51202/topics
{"question":"Discussion topic","user_id":"system","max_rounds":3,"discussion":true,"schedule_yaml":"...","callback_url":"http://127.0.0.1:51200/system_trigger","callback_session_id":"my-session"}
Below is a sample configuration from an actual running instance (sensitive information masked):
bash
bash selfskill/scripts/run.sh configure --init
bash selfskill/scripts/run.sh configure --batch \
LLM_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx4c74 \
LLM_BASE_URL=https://deepseek.com \
LLM_MODEL=deepseek-chat \
LLM_VISION_SUPPORT=true \
TTS_MODEL=gemini-2.5-flash-preview-tts \
TTS_VOICE=charon \
PORT_AGENT=51200 \
PORT_SCHEDULER=51201 \
PORT_OASIS=51202 \
PORT_FRONTEND=51209 \
PORT_BARK=58010 \
OPENAI_STANDARD_MODE=false
bash selfskill/scripts/run.sh add-user system <your-password>
Output of configure --show after configuration:
text
PORT_SCHEDULER=51201
PORT_AGENT=51200
PORT_FRONTEND=51209
PORT_OASIS=51202
OASIS_BASE_URL=http://127.0.0.1:51202
PORT_BARK=58010
INTERNAL_TOKEN=f1aa****57e7 # Auto-generated, do not leak
LLM_API_KEY=sk-7****4c74
LLM_BASE_URL=https://deepseek.com
LLM_MODEL=deepseek-chat
LLM_VISION_SUPPORT=true
TTS_MODEL=gemini-2.5-flash-preview-tts
TTS_VOICE=charon
OPENAI_STANDARD_MODE=false
Note:
INTERNAL_TOKENis auto-generated on first startup,PUBLIC_DOMAIN/BARK_PUBLIC_URLare auto-written by tunnel, no manual configuration needed.
bash
cd /home/avalon/Teamclaw
# Initial configuration
bash selfskill/scripts/run.sh setup
bash selfskill/scripts/run.sh configure --init
bash selfskill/scripts/run.sh configure --batch LLM_API_KEY=sk-xxx LLM_BASE_URL=https://api.deepseek.com LLM_MODEL=deepseek-chat
bash selfskill/scripts/run.sh add-user system MyPass123
# Start service
bash selfskill/scripts/run.sh start
# Access Web UI
# Open browser and navigate to: http://127.0.0.1:51209
# Log in with username: system and password: MyPass123
# Call API
curl -X POST http://127.0.0.1:51200/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer system:MyPass123" \
-d '{"model":"mini-timebot","messages":[{"role":"user","content":"Hello"}],"stream":false,"session_id":"default"}'
# Stop service
bash selfskill/scripts/run.sh stop
All skill scripts are located in selfskill/scripts/ and do not affect the original project functionality
Process management via PID files; start supports idempotent calls
Do not leak INTERNAL_TOKEN
Log path: logs/launcher.log
How to Enable Visualization & Login:
http://127.0.0.1:51209add-user command (default: username system, password MySecurePass123)Teamclaw 是一个多功能 AI Agent 服务,提供:
所有脚本位于 selfskill/scripts/,统一通过 run.sh 入口调用, 全部非交互式。
text
selfskill/scripts/
├── run.sh # 主入口(start/stop/status/setup/add-user/configure)
├── adduser.py # 非交互式用户创建
└── configure.py # 非交互式 .env 配置管理
所有命令在项目根目录下执行。
bash
# 安装依赖
bash selfskill/scripts/run.sh setup
# 初始化配置文件
bash selfskill/scripts/run.sh configure --init
# 配置 LLM(必填)
bash selfskill/scripts/run.sh configure --batch \
LLM_API_KEY=sk-your-key \
LLM_BASE_URL=https://api.deepseek.com \
LLM_MODEL=deepseek-chat
# 创建用户
bash selfskill/scripts/run.sh add-user system MySecurePass123
bash
bash selfskill/scripts/run.sh start # 后台启动
bash selfskill/scripts/run.sh status # 检查状态
bash selfskill/scripts/run.sh stop # 停止服务
bash
# 查看当前配置(敏感值脱敏)
bash selfskill/scripts/run.sh configure --show
# 设置单项
bash selfskill/scripts/run.sh configure PORT_AGENT 51200
# 批量设置
bash selfskill/scripts/run.sh configure --batch TTS_MODEL=gemini-2.5-flash-preview-tts TTS_VOICE=charon
配置项说明默认值LLM_API_KEYLLM API 密钥( 必填)—LLM_BASE_URLLLM API 地址https://api.deepseek.com``LLM_MODEL模型名称deepseek-chat``LLM_PROVIDER厂商(google/anthropic/deepseek/openai,可自动推断)自动LLM_VISION_SUPPORT是否支持图片(可自动推断)自动PORT_AGENTAgent 主服务端口51200``PORT_SCHEDULER定时调度端口51201``PORT_OASISOASIS 论坛端口51202``PORT_FRONTENDWeb UI 端口51209``PORT_BARKBark 推送端口58010``TTS_MODELTTS 模型(可选)—TTS_VOICETTS 声音(可选)—INTERNAL_TOKEN内部通信密钥(自动生成)自动
端口服务51200AI Agent 主服务51201定时调度51202OASIS 论坛51209Web UI
text
Authorization: Bearer <user_id>:<password>
text
Authorization: Bearer <INTERNAL_TOKEN>:<user_id>
INTERNAL_TOKEN 首次启动自动生成,可通过 configure --show-raw 查看。
Base URL: http://127.0.0.1:51200
text
POST /v1/chat/completions
Authorization: Bearer <token>
{"model":"mini-timebot","messages":[{"role":"user","content":"你好"}],"stream":true,"session_id":"my-session"}
text
POST /system_trigger
X-Internal-Token: <INTERNAL_TOKEN>
{"user_id":"system","text":"请执行某任务","session_id":"task-001"}
text
POST /cancel
{"user_id":"<user_id>","session_id":"<session_id>"}
text
POST http://127.0.0.1:51202/topics
{"question":"讨论主题","user_id":"system","max_rounds":3,"discussion":true,"schedule_yaml":"...","callback_url":"http://127.0.0.1:51200/system_trigger","callback_session_id":"my-session"}
以下是一份实际运行的配置示例(敏感信息已脱敏):
bash
bash selfskill/scripts/run.sh configure --init
bash selfskill/scripts/run.sh configure --batch \
LLM_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx4c74 \
LLM_BASE_URL=https://deepseek.com \
LLM_MODEL=deepseek-chat \
LLM_VISION_SUPPORT=true \
TTS_MODEL=gemini-2.5-flash-preview-tts \
TTS_VOICE=charon \
PORT_AGENT=51200 \
PORT_SCHEDULER=51201 \
PORT_OASIS=51202 \
PORT_FRONTEND=51209 \
PORT_BARK=58010 \
OPENAI_STANDARD_MODE=false
bash selfskill/scripts/run.sh add-user system <your-password>
配置完成后 configure --show 输出:
text
PORT_SCHEDULER=51201
PORT_AGENT=51200
PORT_FRONTEND=51209
PORT_OASIS=51202
OASIS_BASE_URL=http://127.0.0.1:51202
PORT_BARK=58010
INTERNAL_TOKEN=f1aa****57e7 # 自动生成,勿泄露
LLM_API_KEY=sk-7****4c74
LLM_BASE_URL=https://deepseek.com
LLM_MODEL=deepseek-chat
LLM_VISION_SUPPORT=true
TTS_MODEL=gemini-2.5-flash-preview-tts
TTS_VOICE=charon
OPENAI_STANDARD_MODE=false
说明:
INTERNAL_TOKEN首次启动自动生成,PUBLIC_DOMAIN/BARK_PUBLIC_URL由 tunnel 自动写入,无需手动配置。
bash
cd /home/avalon/Teamclaw
# 首次配置
bash selfskill/scripts/run.sh setup
bash selfskill/scripts/run.sh configure --init
bash selfskill/scripts/run.sh configure --batch LLM_API_KEY=sk-xxx LLM_BASE_URL=https://api.deepseek.com LLM_MODEL=deepseek-chat
bash selfskill/scripts/run.sh add-user system MyPass123
# 启动
bash selfskill/scripts/run.sh start
# 访问 Web UI
# 打开浏览器导航到:http://127.0.0.1:51209
# 使用用户名:system,密码:MyPass123 登录
# 调用 API
curl -X POST http://127.0.0.1:51200/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer system:MyPass123" \
-d '{"model":"mini-timebot","messages":[{"role":"user","content":"你好"}],"stream":false,"session_id":"default"}'
# 停止
bash selfskill/scripts/run.sh stop
所有 skill 脚本位于 selfskill/scripts/,不影响项目原有功能
通过 PID 文件管理进程, start 支持幂等调用
INTERNAL_TOKEN 勿泄露
日志路径: logs/launcher.log
如何开启可视化界面和登录:
http://127.0.0.1:51209add-user 命令创建的凭证(默认:用户名 system,密码 MySecurePass123)