资产织造

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

nohup zeroclaw daemon > ~/.zeroclaw/daemon.log 2>&1 &