OpenClaw

# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex

# 或 npm
npm install -g openclaw@latest

openclaw onboard --install-daemon

openclaw status           # 查看状态
openclaw gateway status   # 确认 Gateway 在运行
openclaw dashboard        # 浏览器打开 http://127.0.0.1:18789/

openclaw gateway stop     # 关闭 Gateway
openclaw gateway start    # 启动
openclaw gateway restart  # 重启

openclaw doctor           # 故障诊断
openclaw doctor --fix     # 自动修复，支持修复配置错误、误删文件等
openclaw update           # 更新
openclaw uninstall        # 卸载，危险！！！

openclaw dashboard --no-open
openclaw devices list
openclaw devices approve <request_id>

openclaw channels list     # 查看渠道
openclaw channels add      # 添加渠道-向导模式
openclaw channels remove   # 移除渠道

openclaw plugins enable whatsapp             # 开启插件
openclaw channels login --channel whatsapp   # 扫码授权

openclaw plugins enable telegram                           # 开启插件
openclaw channels add --channel telegram --token "<token>" # telegram不支持login，需要token

openclaw plugins enable feishu  # 开启插件
openclaw channels add           # 飞书不支持login，需要app id、app secret

# 生成缺失的模板文件（不覆盖已有文件）
# 除非误删，通常不会缺失
openclaw setup                  

# Identity & Purpose
你是一个专注于后端开发的编程助手，熟悉 Go 和分布式系统。

# Security Boundaries
- 你绝对不能记录或输出任何 API Key、密码、私钥等凭证信息
- 未经明确授权，不得执行破坏性命令（rm -rf、DROP TABLE 等）

# Financial Boundaries
- 单次 API 调用预估费用超过 $1 时，必须先征得用户确认

# Operational Boundaries
- 不得修改 SOUL.md 本身，除非用户明确要求

# Escalation
遇到涉及生产数据库或外部支付接口的操作时，暂停并请求确认。

## Session Start（必须，优先于回复）
1. 读取 SOUL.md（我是谁）
2. 读取 USER.md（我在帮谁）
3. 读取 memory/YYYY-MM-DD.md（今天和昨天）
4. 读取 MEMORY.md（长期记忆）
5. 完成后直接开始，不要询问是否已完成

## Memory Rules
- 每次对话结束前，将重要决策、偏好、未完成的事项写入当天的 memory/ 文件
- 周期性将重要条目迁移到 MEMORY.md，删除过期的日志文件

## 安全规则
- 不要将私信内容转发到群组
- 群聊中只在真正有价值时发言

cd ~/.openclaw/workspace
git init
git add AGENTS.md SOUL.md USER.md TOOLS.md IDENTITY.md HEARTBEAT.md memory/
git commit -m "init workspace"
# 推送到私有仓库做备份

openclaw agents list              # 列出所有 Agent
openclaw agents list --bindings   # 同时显示路由绑定

openclaw agents add coder
openclaw agents delete work  # 危险操作

openclaw agents set-identity --agent main --name "Claw" --emoji "🦞" --avatar avatars/openclaw.png

# 为 Agent 绑定 Whatsapp 的 group-a 群组 和 Telegram 的 ops 账号
openclaw agents bind --agent work --bind --bind whatsapp:group-a telegram:ops

# 查看当前所有绑定
openclaw agents bindings
openclaw agents bindings --agent work
openclaw agents bindings --json    # 输出 JSON，便于脚本处理

# 解绑
openclaw agents unbind --agent work --bind telegram:ops
openclaw agents unbind --agent work --all   # 解除该 Agent 的全部绑定

# 通过 config set 修改单个字段（不推荐改复杂嵌套结构，建议直接编辑 JSON）
openclaw config set agents.defaults.workspace "~/.openclaw/workspace"
openclaw config get agents.list    # 查看当前 agents 列表

# 创建两个 Agent
openclaw agents add home --workspace ~/.openclaw/workspace-home
openclaw agents add work --workspace ~/.openclaw/workspace-work

# 绑定渠道
openclaw agents bind --agent home --bind whatsapp:personal
openclaw agents bind --agent work --bind whatsapp:biz --bind telegram:ops

openclaw agents bind --agent chat --bind whatsapp
openclaw agents bind --agent deep --bind telegram

openclaw sessions                    # 默认 Agent 的会话
openclaw sessions --agent work       # 指定 Agent
openclaw sessions --all-agents       # 所有 Agent
openclaw sessions --active 120       # 最近 120 分钟内活跃的会话

# 警告：此操作不可逆，会删除该 Agent 的所有聊天记录！
rm -rf ~/.openclaw/agents/main/sessions/*
# 如果是其他 Agent，替换路径即可

openclaw sessions cleanup --dry-run                # 预览待清理内容
openclaw sessions cleanup --all-agents --enforce   # 实际执行清理

/cancel                      # 取消当前这次执行（本轮回复 + 由其派生的子任务），会话本身继续
/stop                        # 终止当前会话，并级联终止所有子 Agent（已有）
/amend <新内容>               # 覆盖上一条用户消息的内容，并基于修改后上下文重新生成
/append <补充内容>             # 在上一条用户消息基础上追加补充说明，再整体重新生成

# 1. 创建目录
mkdir -p ~/.openclaw/workspace/skills/my-skill

# 2. 编写说明文件
cat > ~/.openclaw/workspace/skills/my-skill/SKILL.md << 'EOF'
---
name: my-skill
description: 调用内部 API 查询数据
metadata: {"openclaw": {"requires": {"bins": ["curl"], "env": ["MY_API_KEY"]}}}
---

当用户查询订单时，使用 exec 工具运行：
curl -H "Authorization: $MY_API_KEY" https://api.example.com/orders
EOF

# 3. 重启使其生效
openclaw gateway restart

clawhub install <skill-name>   # 安装到 workspace/skills/
clawhub update --all           # 更新所有已安装的 Skills

openclaw mcp install github
openclaw mcp install notion
openclaw mcp install postgres

# ClawHub 上的 MCP Skill
clawhub install <mcp-skill-name>

# 官方 MCP Server 仓库
# github.com/modelcontextprotocol/servers

openclaw mcp list              # 查看已配置的 MCP Server
openclaw logs                  # 查看 MCP 调用日志
openclaw doctor                # 检查 MCP 配置是否正确

#!/usr/bin/env node
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

const server = new Server(
  { name: 'my-server', version: '1.0.0' },
  { capabilities: { tools: {} } }
);

// 声明工具
server.setRequestHandler('tools/list', async () => ({
  tools: [{
    name: 'query_orders',
    description: '查询订单信息',
    inputSchema: {
      type: 'object',
      properties: {
        userId: { type: 'string', description: '用户 ID' }
      },
      required: ['userId']
    }
  }]
}));

// 处理工具调用
server.setRequestHandler('tools/call', async ({ params }) => {
  const { name, arguments: args } = params;
  if (name === 'query_orders') {
    const data = await fetchOrders(args.userId);  // 你的业务逻辑
    return { content: [{ type: 'text', text: JSON.stringify(data) }] };
  }
  throw new Error(`Unknown tool: ${name}`);
});

const transport = new StdioServerTransport();
await server.connect(transport);

go get github.com/mark3labs/mcp-go

package main

import (
    "context"
    "fmt"

    "github.com/mark3labs/mcp-go/mcp"
    "github.com/mark3labs/mcp-go/server"
)

func main() {
    s := server.NewMCPServer("订单查询服务", "1.0.0",
        server.WithToolCapabilities(false),
    )

    // 定义工具及参数 Schema
    queryTool := mcp.NewTool("query_order",
        mcp.WithDescription("根据订单 ID 查询订单详情"),
        mcp.WithString("order_id",
            mcp.Required(),
            mcp.Description("订单 ID"),
        ),
    )
    s.AddTool(queryTool, queryOrderHandler)

    // 以 stdio 方式启动（供本地 MCP Client 调用）
    if err := server.ServeStdio(s); err != nil {
        fmt.Printf("server error: %v\n", err)
    }
}

func queryOrderHandler(ctx context.Context, req mcp.CallToolRequest) (*mcp.CallToolResult, error) {
    orderID, err := req.RequireString("order_id")
    if err != nil {
        return mcp.NewToolResultError(err.Error()), nil
    }
    // 替换为实际业务逻辑
    result := fmt.Sprintf(`{"order_id":"%s","status":"shipped","amount":299.0}`, orderID)
    return mcp.NewToolResultText(result), nil
}

type QueryOrderArgs struct {
    OrderID string `json:"order_id" jsonschema_description:"订单 ID" jsonschema:"required"`
    UserID  string `json:"user_id,omitempty" jsonschema_description:"用户 ID（可选过滤）"`
}

type OrderResult struct {
    OrderID string  `json:"order_id"`
    Status  string  `json:"status"`
    Amount  float64 `json:"amount"`
}

queryTool := mcp.NewTool("query_order",
    mcp.WithDescription("查询订单详情"),
    mcp.WithInputSchema[QueryOrderArgs](),
    mcp.WithOutputSchema[OrderResult](),
)

// SSE 传输
if err := server.ServeSSE(s, ":8080"); err != nil {
    log.Fatal(err)
}

// Streamable HTTP 传输（新规范推荐）
httpServer := server.NewStreamableHTTPServer(s)
if err := httpServer.Start(":8080"); err != nil {
    log.Fatal(err)
}

go get github.com/zeromicro/go-zero@latest

Name: order-mcp-server
Host: localhost
Port: 8080
Mcp:
  Name: order-service
  MessageTimeout: 30s
  Cors:
    - http://localhost:18789   # OpenClaw Dashboard 地址

package main

import (
    "context"
    "encoding/json"
    "fmt"

    "github.com/zeromicro/go-zero/core/conf"
    "github.com/zeromicro/go-zero/core/logx"
    "github.com/zeromicro/go-zero/mcp"
)

func main() {
    var c mcp.McpConf
    conf.MustLoad("config.yaml", &c)
    logx.DisableStat()

    s := mcp.NewMcpServer(c)
    defer s.Stop()

    registerTools(s)

    s.Start()
}

func registerTools(s *mcp.McpServer) {
    // 工具 1：查询订单
    s.AddTool(mcp.Tool{
        Name:        "query_order",
        Description: "根据订单 ID 查询订单详情",
        InputSchema: mcp.ToolInputSchema{
            Type: "object",
            Properties: map[string]mcp.Property{
                "order_id": {Type: "string", Description: "订单 ID"},
            },
            Required: []string{"order_id"},
        },
    }, func(ctx context.Context, req mcp.ToolRequest) (mcp.ToolResponse, error) {
        orderID := req.Params["order_id"].(string)
        data := map[string]any{
            "order_id": orderID,
            "status":   "shipped",
            "amount":   299.0,
        }
        b, _ := json.Marshal(data)
        return mcp.NewTextToolResponse(string(b)), nil
    })

    // 工具 2：列出用户订单
    s.AddTool(mcp.Tool{
        Name:        "list_orders",
        Description: "列出指定用户的订单列表",
        InputSchema: mcp.ToolInputSchema{
            Type: "object",
            Properties: map[string]mcp.Property{
                "user_id": {Type: "string", Description: "用户 ID"},
                "limit":   {Type: "integer", Description: "返回数量上限，默认 10"},
            },
            Required: []string{"user_id"},
        },
    }, func(ctx context.Context, req mcp.ToolRequest) (mcp.ToolResponse, error) {
        userID := req.Params["user_id"].(string)
        text := fmt.Sprintf("用户 %s 共有 3 条订单：#1001, #1002, #1003", userID)
        return mcp.NewTextToolResponse(text), nil
    })
}

openclaw doctor           # 自动诊断，输出具体错误字段
openclaw doctor --fix     # 尝试自动修复
openclaw health           # 健康检查
openclaw logs             # 完整日志
openclaw channels status --probe   # 检查渠道连接

# Gateway
openclaw gateway status / restart
openclaw gateway --port 18789    # 前台调试模式
openclaw doctor [--fix]          # 诊断并修复配置问题
openclaw logs                    # 查看日志

# 渠道
openclaw channels login [--channel whatsapp] [--account biz]
openclaw channels status [--probe]

# Agent
openclaw agents list [--bindings]
openclaw agents add <id> [--workspace <path>]
openclaw agents delete <id>
openclaw agents bind --agent <id> --bind <channel>[:<accountId>]
openclaw agents unbind --agent <id> --bind <channel>[:<accountId>] [--all]
openclaw agents bindings [--agent <id>] [--json]
openclaw agents set-identity --agent <id> [--name X] [--emoji X] [--avatar X]
openclaw agents set-identity --workspace <path> --from-identity
openclaw setup [--workspace <path>]  # 生成缺失的模板文件（不覆盖已有）

# 会话
openclaw sessions [--agent <id>] [--all-agents] [--active 120]
openclaw sessions cleanup [--dry-run] [--enforce]

# 配置
openclaw onboard / configure
openclaw config get <key>
openclaw config set <key> <value>

# 模型
openclaw models list

# 发消息
openclaw message send --target +8613800138000 --message "Hello"