title: ZeroClaw description: ZeroClaw + Deepseek + Telegrame date: "2026-03-11" tags: [ZeroClaw,Deepseek,Telegrame] cover: /images/rwa-cover.jpg
1.安装
git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./install.sh
Next steps:
zeroclaw status
zeroclaw agent -m "Hello, ZeroClaw!"
zeroclaw gateway
source $HOME/.cargo/env
echo $PATH
which zeroclaw
永久生效
echo 'source $HOME/.cargo/env' >> ~/.bashrc
source ~/.bashrc
🦀 ZeroClaw Status
Version: 0.1.7
Workspace: /root/.zeroclaw/workspace
Config: /root/.zeroclaw/config.toml
🤖 Provider: openrouter
Model: anthropic/claude-sonnet-4.6
📊 Observability: none
🧾 Trace storage: none (state/runtime-trace.jsonl)
🛡️ Autonomy: Supervised
⚙️ Runtime: native
💓 Heartbeat: disabled
🧠 Memory: sqlite (auto-save: on)
Security:
Workspace only: true
Allowed roots: (none)
Allowed commands: git, npm, cargo, ls, cat, grep, find, echo, pwd, wc, head, tail, date
Max actions/hour: 20
Max cost/day: $5.00
OTP enabled: false
E-stop enabled: false
Channels:
CLI: ✅ always
Telegram ❌ not configured
Discord ❌ not configured
Slack ❌ not configured
Mattermost ❌ not configured
iMessage ❌ not configured
Matrix ❌ not configured
Signal ❌ not configured
WhatsApp ❌ not configured
Linq ❌ not configured
WATI ❌ not configured
NextCloud Talk ❌ not configured
Email ❌ not configured
IRC ❌ not configured
Lark ❌ not configured
Feishu ❌ not configured
DingTalk ❌ not configured
QQ Official ❌ not configured
Nostr ❌ not configured
ClawdTalk ❌ not configured
Webhook ❌ not configured
Peripherals:
Enabled: no
Boards: 0
2. 配置ai
zeroclaw onboard
它会问你选择哪个提供商,选择 DeepSeek。
输入你的 DeepSeek API Key。
配置会保存到:
/root/.zeroclaw/config.toml
或者手动设置环境变量
export DEEPSEEK_API_KEY="你的_api_key"
Workspace layout:
/root/.zeroclaw/workspace/
├── sessions/
├── memory/
├── state/
├── cron/
├── skills/
├── IDENTITY.md
├── AGENTS.md
├── HEARTBEAT.md
├── SOUL.md
├── USER.md
├── TOOLS.md
├── BOOTSTRAP.md
└── MEMORY.md
✓ Workspace: /root/.zeroclaw/workspace
✓ Provider: openrouter
✓ Model: anthropic/claude-sonnet-4.6
✓ API Key: not set (use --api-key or edit config.toml)
✓ Security: Supervised (workspace-scoped)
✓ Memory: sqlite (auto-save: on)
✓ Secrets: encrypted
✓ Gateway: pairing required (127.0.0.1:8080)
✓ Tunnel: none (local only)
✓ Composio: disabled (sovereign mode)
Config saved: /root/.zeroclaw/config.toml
Next steps:
1. Set your API key: export OPENROUTER_API_KEY="sk-..."
2. Or edit: ~/.zeroclaw/config.toml
3. Chat: zeroclaw agent -m "Hello!"
4. Gateway: zeroclaw gateway
2.链接deepseek api key
# Interactive onboarding wizard
zeroclaw onboard --interactive
# Or quick setup (no prompts, optional model specification)
zeroclaw onboard --api-key sk-... --provider openrouter --model "openrouter/auto"
# If config.toml already exists and you want to overwrite it
zeroclaw onboard --force
# Quickly repair channels/allowlists only
zeroclaw onboard --channels-only
# Chat with the agent
zeroclaw agent -m "Hello, ZeroClaw!"
# Interactive mode
zeroclaw agent
# Start the gateway (webhook server)
zeroclaw gateway # default: 127.0.0.1:42617
zeroclaw gateway --port 0 # random port (security hardened)
# Start full autonomous runtime
zeroclaw daemon
# Check status
zeroclaw status
zeroclaw auth status
zeroclaw doctor
zeroclaw channel doctor
# Generate shell completions
source <(zeroclaw completions bash)
zeroclaw completions zsh > ~/.zfunc/_zeroclaw
# Bind Telegram identity into allowlist
zeroclaw channel bind-telegram 123456789
zeroclaw channel bind-telegram 7181701725
# Integration diagnostics
zeroclaw integrations info Telegram
# Service + migration helpers
zeroclaw service install
zeroclaw service status
zeroclaw service restart
zeroclaw config schema
zeroclaw migrate openclaw --dry-run
zeroclaw migrate openclaw
3.配置通信渠道
zeroclaw onboard --channels-only
选择:
Telegram
然后输入:
Bot Token
ZeroClaw 会保存到:
~/.zeroclaw/config.toml
类似:
[channel.telegram]
bot_token = "123456:AAHxxxxxxxxxxxx"
获取你的 Telegram ID
/start
它会返回:
Id: 123456789
zeroclaw channel bind-telegram 123456789
4.最重要的5个命令
zeroclaw onboard
zeroclaw agent
zeroclaw gateway
zeroclaw daemon
zeroclaw doctor
5.状态提示
🤖 Provider: deepseek
Model: deepseek-chat
说明你已经正确接入:
DeepSeek API
模型:
deepseek-chat
如果你做:
代码生成
Agent自动化
其实可以考虑:
deepseek-coder
deepseek-coder
🦀 ZeroClaw Status
Version: 0.1.7
Workspace: /root/.zeroclaw/workspace
Config: /root/.zeroclaw/config.toml
🤖 Provider: deepseek
Model: deepseek-chat
📊 Observability: none
🧾 Trace storage: none (state/runtime-trace.jsonl)
🛡️ Autonomy: Supervised
⚙️ Runtime: native
💓 Heartbeat: disabled
🧠 Memory: sqlite (auto-save: on)
Security:
Workspace only: true
Allowed roots: (none)
Allowed commands: git, npm, cargo, ls, cat, grep, find, echo, pwd, wc, head, tail, date
Max actions/hour: 20
Max cost/day: $5.00
OTP enabled: false
E-stop enabled: false
Channels:
CLI: ✅ always
Telegram ✅ configured
Discord ❌ not configured
Slack ❌ not configured
Mattermost ❌ not configured
iMessage ❌ not configured
Matrix ❌ not configured
Signal ❌ not configured
WhatsApp ❌ not configured
Linq ❌ not configured
WATI ❌ not configured
NextCloud Talk ❌ not configured
Email ❌ not configured
IRC ❌ not configured
Lark ❌ not configured
Feishu ❌ not configured
DingTalk ❌ not configured
QQ Official ❌ not configured
Nostr ❌ not configured
ClawdTalk ❌ not configured
Webhook ❌ not configured
Peripherals:
Enabled: no
Boards: 0
6.如何在退出zeroclaw daemon,telegram还能继续聊天
linux使用后来运行命令
zeroclaw daemon &
查看运行进程 ps aux | grep zeroclaw
kill -9 72324
使用 tmux(服务器强烈推荐)
创建会话:
tmux new -s zeroclaw
启动服务:
zeroclaw daemon
然后按:
Ctrl + B
D
会 退出 tmux,但服务继续运行。
重新进入:
tmux attach -t zeroclaw
退出shell还是会自动杀死zerodaemon,
最基本的方法 亲测有效
nohup zeroclaw daemon > ~/.zeroclaw/daemon.log 2>&1 &
7.什么是ZeroClaw 的 skill / marketplace(AI能力市场)
ZeroClaw 的 Skill / Marketplace 可以理解为:
给 AI Agent 增加能力模块的地方(类似插件市场 / 工具市场)。
Agent 本身只是一个 LLM(你现在用的是 DeepSeek), 但通过 Skill,它可以:
调 API
访问数据库
操作文件
发邮件
调用 CRM
搜索网页
控制系统
所以:
LLM + Skills = 真正可工作的 AI Agent
ZeroClaw Skill 是什么
Skill 本质是一个 工具接口(Tool)。
结构通常是:
User ↓ Agent ↓ Skill ↓ External system
例如:
Telegram ↓ ZeroClaw Agent ↓ Email Skill ↓ SMTP / Gmail
Agent 就能 帮你发邮件。
Skill Marketplace 是什么
Marketplace 就是:
AI能力插件库
类似:
ChatGPT Plugins
LangChain Tools
Zapier Apps
在 Marketplace 里可以找到:
Email Database Calendar Search CRM Webhook File storage
安装后 Agent 就能调用。
ZeroClaw Skill 类型
1 API Skill
调用外部 API。
name: get_customer
method: GET
endpoint: https://api.crm.com/customer
2 Webhook Skill
触发外部系统。
例如
Telegram
↓
ZeroClaw
↓
Webhook
↓
CRM
name: create_lead
method: POST
endpoint: https://crm/api/lead
3 Local Tool Skill 本地脚本。
python send_mail.py
4 Shell Skill 执行系统命令:
git
npm
cargo
ls
cat
grep
find
8. Skill 的核心作用
没有 Skill:
AI = 只能聊天
有 Skill:
AI = 能工作
ZeroClaw 是一个 AI Agent 运行框架,核心目标是让大模型(例如你用的 DeepSeek)不只是聊天,而是 可以执行任务、调用工具、自动化工作。
简单理解
LLM(DeepSeek)
+ Tools / Skills
+ Runtime(Agent执行系统)
= AI自动化助手
ZeroClaw 的核心能力完整拆解
一、AI Agent运行系统(核心能力)
ZeroClaw 本质是一个 Agent Runtime。
它可以:
接收用户请求
让 AI 思考
决定是否调用工具
执行任务
返回结果
流程
User
↓
Agent
↓
Reasoning
↓
Tool calls
↓
Result
二、多渠道交互(Channels)
ZeroClaw 最大特点之一是 多渠道 AI 控制中心。
| 渠道 | 说明 |
| -------- | ----- |
| CLI | 命令行 |
| Telegram | 聊天机器人 |
| Discord | 社群机器人 |
| Slack | 企业聊天 |
| Email | 邮件 |
| Webhook | API触发 |
| WhatsApp | 需接第三方 |
三、工具调用(Skills / Tools)
这是 ZeroClaw 最重要能力。
| 类型 | 功能 |
| -------- | ----- |
| Shell | 执行命令 |
| File | 读写文件 |
| Git | 代码管理 |
| API | 调接口 |
| Webhook | 触发系统 |
| Database | 查询数据库 |
四、自动化任务
ZeroClaw 可以做 工作自动化。
分析日志
生成报告
监控服务器
整理数据
自动写代码
自动部署
自动发邮件
五、工作空间系统(Workspace)
ZeroClaw 有自己的 AI工作目录:
~/.zeroclaw/workspace
这里存放:
SOUL.md
AGENTS.md
files
scripts
data
AI可以:
创建文件
修改文件
读取文件
分析文件
六、Agent人格系统
ZeroClaw 用两个文件定义 AI 行为:
SOUL.md 定义:
AI人格
AI目标
AI行为
AGENTS.md 定义:
能力
工作流程
工具规则
七、AI记忆系统
你的配置里已经看到: 你的配置里已经看到:
Memory: sqlite
ZeroClaw 可以:
保存历史
记录任务
存储数据
例如:
客户信息
工作日志
AI任务
八、安全控制
ZeroClaw 的安全机制非常严格。
你看到的:
Allowed commands
Workspace only
Max actions/hour
Max cost/day
| 限制 | 作用 |
| ---------------- | --------- |
| Allowed commands | 防止AI乱执行命令 |
| Workspace only | 防止访问系统文件 |
| Max actions | 防止无限循环 |
| Cost limit | 控制API费用 |
九、Agent自治模式
ZeroClaw 有不同自治级别:
| 模式 | 说明 |
| ---------- | ---- |
| Manual | 只聊天 |
| Supervised | 需要确认 |
| Autonomous | 自动执行 |
你现在是:
Autonomy: Supervised
十、任务调度系统
ZeroClaw 内部有:
scheduler
heartbeat
runtime
作用:
任务调度
Agent运行
状态监控
你 doctor 输出看到:
scheduler healthy
heartbeat fresh
十一、可扩展 API
ZeroClaw 可以调用任何 API。 例如:
CRM
ERP
邮箱
Supabase
Notion
通过 Skill。
十二、开发自动化
很多人用 ZeroClaw 做:
AI编程助手
AI DevOps
AI数据分析
例如:
写代码
debug
自动部署
十三、设备控制(Peripherals)
ZeroClaw 还能控制:
IoT设备
机器人
传感器
例如:
Arduino
Raspberry Pi
不过你现在没启用:
Peripherals: disabled
十四、可构建的AI系统
ZeroClaw 可以做很多系统:
1 AI工作助手
写报告
管理任务
自动办公
2 AI客服
Telegram
WhatsApp
网站客服
3 AI运维
服务器监控
日志分析
自动修复
4 AI外贸助手
特别适合你:
邮件询盘分析
客户分配
自动回复
CRM记录
十五、总结:ZeroClaw能力
核心能力可以概括为 8个字:
思考 + 调用工具 + 自动执行
完整能力
AI推理
工具调用
多渠道聊天
自动化任务
文件操作
系统控制
API集成
记忆系统
十六,配置telegram
关联Openrouter
zeroclaw onboard --api-key sk-... --provider openrouter --model "openrouter/auto"
zeroclaw onboard --channels-only
zeroclaw channel bind-telegram 123456789
nohup zeroclaw daemon > ~/.zeroclaw/daemon.log 2>&1 &
ps aux | grep zeroclaw
kill -9 72324
集成检查
zeroclaw integrations info Telegram
